Template:To USD
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 2017.
- {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 5.28. That is, 100 Mexican pesos would exchange to 5.28 US dollars in 2017.
- {To USD|100|MEX} also displays 5.28.
- {To USD|100|FRA} displays 112.74.
- {To USD|100|MEX|round=yes} displays 5.
- {To USD|100|MEX|year=2009} displays Undefined year "2009" 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
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:International dollars: Converts a value in a given country in a given year to international dollars.
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 in articles based on its TemplateData.
TemplateData for To USD
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 |
| currency code | 2 code curr currency | ISO 3166-1 alpha-3 currency 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 |