Template:To USD
This template uses Lua: |
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], as well as by the World Bank[2], the European Central Bank[3], Eurostat[4], and the Reserve Bank of India.
Syntax
[muda l codesc]{{To USD | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} | r = {{{r}}} | cur = {{{cur}}} }}
- {{{1}}} and {{{2}}} are the template positional parameters (this is, the first and the second parameters in the template).
- {{{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 2019.
- {{{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.
- {{{r}}} is an optional parameter. It sets the digits to which the result must be rounded. A positive value indicates a fractional digit including trailing zeros. Defaults to
2
. - {{{cur}}} is an optional parameter. It allows to select the currency for the country. Currently only supported for the Euro and the currencies that have been immediately replaced by the Euro.
Examples
[muda l codesc]{{To USD|100|Mexico}}
displays Template:To USD/data/2019. That is, 100 Mexican pesos would exchange to Template:To USD/data/2019 US dollars.{{To USD|100|MEX}}
also displays Template:To USD/data/2019.{{To USD|100|MEX|round=yes}}
displays Template:To USD/data/2019.{{To USD|100|FRA}}
displays Fal de esprescion: L carater de nterpunzion [ ne ie nia stat recunesciù.. That is, 100 Euros (the currency used in France) is currently Fal de esprescion: L carater de nterpunzion [ ne ie nia stat recunesciù. US dollars.{{Formatnum:{{To USD|100000|RUS}}}}
displays Template:To USD/data/2 019.{{To USD|100|MEX|year=1959}}
displays Template:Red since data for 1959 has not yet been defined. It will add the page to Category:Pages using an undefined year in Template:To USD
See also
[muda l codesc]- {{To USD round}}: Allows selection of number of significant figures; optimal for figures with lots of zeroes.
- {{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.
- {{International dollars}}: Converts a value in a given country in a given year to international dollars.
{{formatnum:}}
- {{From USD}}
- {{To EUR}}
- {{From EUR}}
- {{FXConvert}}
- {{INRConvert}}
Data subtemplates
[muda l codesc]References
[muda l codesc]- ↑ "Official exchange rate (LCU per US$, period average)". Trat ite ai 14 April 2013.
- ↑ "The World Bank exchange rate, DEC alternative conversion factor (LCU per US$)". Trat ite ai 31 December 2019.
- ↑ "Reference rates - Exchange rates - ECB Statistical Data Warehouse".
- ↑ "Eurostat Database".
Tracking categories
[muda l codesc]- Category:Pages using a wrong currency in Template:To USD (0)
- Category:Pages using an unknown country code in Template:To USD (0)
- Category:Pages using an undefined year in Template:To USD (2)
TemplateData
[muda l codesc]TemplateData for To USD
Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund
Parametro | Descrizione | Tipo | Stato | |
---|---|---|---|---|
Amount | 1 | value in foreign currency to convert to USD
| Numero | obbligatorio |
Country code | 2 country | ISO 3166-1 alpha-3 country code
| Linea | obbligatorio |
year | year | Year to convert currency
| Numero | obbligatorio |
Round to nearest dollar? | round | If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest US cent.
| Stringa | facoltativo |
Resolution | r | The number of digits of precision in the result value.
| Numero | facoltativo |
Currency code | cur | It allows to select the currency for the country. Currently only supported for the Euro and the currencies that have been immediately replaced by the Euro.
| Linea | facoltativo |