Wikipedia>Palosirkka: add fragment

2022-04-06T09:36:17Z

add fragment

New page

{{documentation subpage}}
This template converts a value given in the national currency of a given country to [[international dollar]]s.

===Syntax===
<nowiki>{{International dollars | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} | r = {{{r}}} }}</nowiki><br/>
*<nowiki>{{{1}}}</nowiki> is the value in the local currency to be converted.
*<nowiki>{{{2}}}</nowiki> is the country name or [[ISO_3166-1_alpha-3#Officially_assigned_code_elements|3-letter ISO code]] for the country whose currency is being converted.
*<nowiki>{{{year}}}</nowiki> is the year to use for the international dollar value, e.g. international dollars current in 2009. (The default is 2016.)
*<nowiki>{{{round}}}</nowiki> is an optional parameter. If it is equal to "yes", then the converted value is displayed to the nearest international dollar.
*<nowiki>{{{r}}}</nowiki> 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 <code>2</code>.

===Examples===
*<code><nowiki>{{International dollars|100|Mexico}}</nowiki></code> displays {{International dollars|100|Mexico}}. That is, 100 [[Mexican peso]]s had the same [[purchasing power]] as {{International dollars|100|MEX}} [[United States dollar | US dollars]] in 2016.
*<code><nowiki>{{International dollars|100|MEX}}</nowiki></code> also displays {{International dollars|100|MEX}}.
*<code><nowiki>{{International dollars|100|MEX|round=yes}}</nowiki></code> displays {{International dollars|100|MEX|round=yes}}.
*<code><nowiki>{{International dollars|100|MEX|year=2009}}</nowiki></code> displays {{International dollars|100|MEX|year=2009}}. That is, 100 [[Mexican peso]]s had the same [[purchasing power]] as {{International dollars|100|MEX|year=2009}} [[United States dollar | US dollars]] in 2009.
*<code><nowiki>{{International dollars|100|MEX|year=1901}}</nowiki></code> displays {{International dollars|100|MEX|year=1901}} since data from 1901 has not yet been defined.
*<code><nowiki>{{International dollars|1|USA}}</nowiki></code> displays {{International dollars|1|USA}}.
*<code><nowiki>{{International dollars|0.01|IND|year=2009}}</nowiki></code> displays {{International dollars|0.01|IND|year=2009}}.
*<code><nowiki>{{International dollars|0.01|IND|year=2009|r=4}}</nowiki></code> displays {{International dollars|0.01|IND|year=2009|r=4}}.
*<code><nowiki>{{International dollars|0.01|IND|year=2009|r=5}}</nowiki></code> displays {{International dollars|0.01|IND|year=2009|r=5}}.
*<code><nowiki>{{International dollars|1|GBR|year=2009}}</nowiki></code> displays {{International dollars|1|GBR|year=2009}}.
*<code><nowiki>{{International dollars|1|GBR|year=2011}}</nowiki></code> displays {{International dollars|1|GBR|year=2011}}.
*<code><nowiki>{{International dollars|1|GBR|year=2012}}</nowiki></code> displays {{International dollars|1|GBR|year=2012}}.
*<code><nowiki>{{International dollars|1|GBR|year=2014}}</nowiki></code> displays {{International dollars|1|GBR|year=2014}}.
*<code><nowiki>{{International dollars|1|GBR|year=2015}}</nowiki></code> displays {{International dollars|1|GBR|year=2015}}.
*<code><nowiki>{{International dollars|1|GBR|year=2016}}</nowiki></code> displays {{International dollars|1|GBR|year=2016}}.
*<code><nowiki>{{International dollars|1|GBR|year=}}</nowiki></code> displays {{International dollars|1|GBR|year=}} (last year available).
*<code><nowiki>{{International dollars|1|GBR}}</nowiki></code> displays {{International dollars|1|GBR}} (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.

===Data subtemplates===
{{hlist| [[Template:International dollars/data/2009|2009]] |[[Template:International dollars/data/2011|2011]] | [[Template:International dollars/data/2012|2012]] | [[Template:International dollars/data/2014|2014]] | [[Template:International dollars/data/2015|2015]] | [[Template:International dollars/data/2016|2016]] }}

==TemplateData==
{{TemplateDataHeader}}
<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>


<includeonly>{{Sandbox other||
{{DEFAULTSORT:{{BASEPAGENAME}}}}
[[Category:Currency conversion templates]]
}}</includeonly>

Template:International dollars/doc - Revision history

Wikipedia>Palosirkka: add fragment