Template:International dollars/doc

This template converts a value given in the national currency of a given country to international dollars.

Syntax

{{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

• {{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

• 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

• 2009
• 2011
• 2012
• 2014
• 2015
• 2016

TemplateData

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

<templatedata> { "params": { "1": { "label": "amount", "description": "value in foreign currency to convert to international dollars", "example": "22816", "type": "number", "required": true }, "2": { "aliases": [ "country" ], "label": "country code", "description": "ISO 3166-1 alpha-3 country code", "example": "MEX", "type": "line", "required": true }, "year": { "description": "Year to convert currency", "example": "2002", "type": "number", "required": true }, "round": { "label": "round to nearest dollar?", "description": "If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest international dollars cent.", "example": "yes", "type": "string" },

               "r": {

"label": "resolution", "description": "The number of digits of precision in the result value.", "example": "3", "type": "number" } }, "description": "Template to convert other currencies into international dollars, by year." } </templatedata>