Template:To USD round/doc
Appearance
This is a documentation subpage for Template:To USD round. It may contain usage information, categories and other content that is not part of the original template page. |
This template converts a value given in the national currency of a given country to US dollars. The template uses values published by the IMF.[1]
Syntax
{{To USD | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} }}
- {{{1}}} is the value in the local currency to be converted.
- {{{2}}} is the country name or 3-letter ISO code for the country whose currency is being converted.
- {{{year}}} is the year to use for the US dollar value, e.g. US dollars current in 2009. The default is currently 2018.
- {{{round}}} is an optional parameter. If it is equal to "yes", then the converted value is displayed to the nearest US dollar. The default is rounding to the nearest penny.
Examples
{{To USD|100|Mexico}}
displays 4.93. That is, 100 Mexican pesos would exchange to 4.93 US dollars.{{To USD|100|MEX}}
also displays 4.93.{{To USD|100|FRA}}
displays 118.27.{{To USD|100|MEX|round=yes}}
displays 5.{{Formatnum:{{To USD|100000|RUS}}}}
displays 1,357.77.{{To USD|100|MEX|year=2009}}
displays 7.4 since data for 2009 has not yet been defined. It will add the page to Category:Pages using an undefined year in Template:To USD round/doc
R$ 586,000 (${{sigfig|{{User:Mathglot/sandbox/Templates/To USD round|586000|BRA|round=yes|year=2015}}|{{sigfig|586,000}} }})
= R$ 586,000 ($176,000)${{sigfig|{{User:Mathglot/sandbox/Templates/To USD round|680000000|BRA|round=yes|year=2015}}|{{sigfig|680000000}} }}
= $200,000,000
See also
- Template:Inflation: Calculates a value in a given country in a given year based on an amount of currency in the same country in another year.
- Template:To USD
- Template:significant figures
- Template:International dollars: Converts a value in a given country in a given year to international dollars.
{{formatnum:}}
Data subtemplates
References
- ^ "Official exchange rate (LCU per US$, period average)". Retrieved 14 April 2013.
TemplateData
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:To USD round in articles based on its TemplateData.
TemplateData for To USD round
Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund
Parameter | Description | Type | Status | |
---|---|---|---|---|
amount | 1 | value in foreign currency to convert to USD
| Number | required |
country code | 2 country | ISO 3166-1 alpha-3 country code
| Line | required |
year | year | Year to convert currency
| Number | required |
round to nearest dollar? | round | If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest US cent.
| String | optional |