This template converts a value given in the national currency of a given country to international dollars.
Syntax
[edit]{{International dollars | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} | r = {{{r}}} }}
- {{{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 international dollar value, e.g. international dollars current in 2009. (The default is 2016.)
- {{{round}}} is an optional parameter. If it is equal to "yes", then the converted value is displayed to the nearest international dollar.
- {{{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.
Examples
[edit]{{International dollars|100|Mexico}}displays 9.89. That is, 100 Mexican pesos had the same purchasing power as 9.89 US dollars in 2016.{{International dollars|100|MEX}}also displays 9.89.{{International dollars|100|MEX|round=yes}}displays 10.{{International dollars|100|MEX|year=2009}}displays 12.3. That is, 100 Mexican pesos had the same purchasing power as 12.3 US dollars in 2009.{{International dollars|100|MEX|year=1901}}displays Undefined year "1901" since data from 1901 has not yet been defined.{{International dollars|1|USA}}displays 1.{{International dollars|0.01|IND|year=2009}}displays 0.{{International dollars|0.01|IND|year=2009|r=4}}displays 0.0006.{{International dollars|0.01|IND|year=2009|r=5}}displays 0.00059.{{International dollars|1|GBR|year=2009}}displays 1.54.{{International dollars|1|GBR|year=2011}}displays 1.39.{{International dollars|1|GBR|year=2012}}displays 1.3.{{International dollars|1|GBR|year=2014}}displays 1.26.{{International dollars|1|GBR|year=2015}}displays 1.25.{{International dollars|1|GBR|year=2016}}displays 1.25.{{International dollars|1|GBR|year=}}displays 1.25 (last year available).{{International dollars|1|GBR}}displays 1.25 (last year available).
See also
[edit]- 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: Converts a given currency to US dollars using exchange rates last updated (as of January 2021) in 2021.
- {{To USD round}}
- {{Inflation}}
{{formatnum:}}- {{From USD}}
- {{To EUR}}
- {{From EUR}}
- {{FXConvert}}
- {{INRConvert}}
- {{Per capita}}
Data subtemplates
[edit]TemplateData
[edit]This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:International dollars in articles based on its TemplateData.
TemplateData for International dollars
Template to convert other currencies into international dollars, by year.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| amount | 1 | value in foreign currency to convert to international dollars
| 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 international dollars cent.
| String | optional |
| resolution | r | The number of digits of precision in the result value.
| Number | optional |