Template:International dollars

Template documentation[view] [edit] [history] [purge]

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

Template to convert other currencies into international dollars, by year.

Template parameters[Edit template data]

Parameter		Description	Type	Status
amount	1	value in foreign currency to convert to international dollars Example 22816	Number	required
country code	2 country	ISO 3166-1 alpha-3 country code Example MEX	Line	required
year	year	Year to convert currency Example 2002	Number	required
round to nearest dollar?	round	If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest international dollars cent. Example yes	String	optional
resolution	r	The number of digits of precision in the result value. Example 3	Number	optional

The above documentation is transcluded from Template:International dollars/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.