Template:International dollars
This template converts a value given in the national currency of a given country to international dollars.
Usage
[edit]{{International dollars|1=|2=|year=year|round=round|r=r}}
Parameters
[edit]|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 2025.)|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 to2.
Examples
[edit]{{International dollars|100|Mexico}}→ 8.84. That is, 100 Mexican pesos had the same purchasing power as 8.84 US dollars in 2025.{{International dollars|100|MEX}}→ 8.84{{International dollars|100|MEX|round=yes}}→ 9{{International dollars|100|MEX|year=2009}}→ 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}}→ Undefined year "1901". Since data from 1901 has not yet been defined.{{International dollars|1|USA}}→ 1{{International dollars|0.01|IND|year=2009}}→ 0{{International dollars|0.01|IND|year=2009|r=4}}→ 0.0006{{International dollars|0.01|IND|year=2009|r=5}}→ 0.00059{{International dollars|1|GBR|year=2009}}→ 1.54{{International dollars|1|GBR|year=2011}}→ 1.39{{International dollars|1|GBR|year=2012}}→ 1.3{{International dollars|1|GBR|year=2014}}→ 1.26{{International dollars|1|GBR|year=2015}}→ 1.25{{International dollars|1|GBR|year=2016}}→ 1.25{{International dollars|1|GBR|year=}}→ 1.43 (last year available){{International dollars|1|GBR}}→ 1.43 (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 |
