Tɛmplet:To USD/doc
 | This is a documentation subpage for Tɛmplet:To USD. It contains usage information, categories and other content that is not part of the original tɛmplet page. |
 | 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
mali niŋ{{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 2021.
- {{{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
mali niŋ{{To USD|100|Mexico}}displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "[".. That is, 100 Mexican pesos would exchange to Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "[". US dollars.{{To USD|100|MEX}}also displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "["..{{To USD|100|MEX|round=yes}}displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "["..{{To USD|100|FRA}}displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "[".. That is, 100 Euros (the currency used in France) is currently Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "[". US dollars.{{Formatnum:{{To USD|100000|RUS}}}}displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "["..{{To USD|100|MEX|year=1959}}displays Expression error: Ti bi baŋ a yɛltɔɣa bahibu bia maa "[". 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
mali niŋ- {{To USD round}}
- {{Inflation}}
- {{International dollars}}
{{formatnum:}}- {{From USD}}
- {{To EUR}}
- {{From EUR}}
- {{FXConvert}}
- {{INRConvert}}
- {{Per capita}}
Data subtemplates
mali niŋReferences
mali niŋ- ↑ Official exchange rate (LCU per US$, period average). Retrieved 14 April 2013.
- ↑ The World Bank exchange rate, DEC alternative conversion factor (LCU per US$). Retrieved 31 December 2019.
- ↑ Reference rates - Exchange rates - ECB Statistical Data Warehouse.
- ↑ Eurostat Database.
Tracking categories
mali niŋ- 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 (0)
TemplateData
mali niŋ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 |
| 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 |
| Resolution | r | The number of digits of precision in the result value.
| Number | optional |
| 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.
| Line | optional |