ᱪᱷᱟᱸᱪ:To USD/doc

This template converts a value given in the national currency of a given country to US dollars. The template uses values published by the IMF.

Syntax

{{To USD | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} }}

• {{{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 US dollar value, e.g. US dollars current in 2009. The default is currently 2018.
• {{{round}}} is an optional parameter. If it is equal to "yes", then the converted value is displayed to the nearest US dollar. The default is rounding to the nearest penny.

Examples

• {{To USD|100|Mexico}} displays 5.28. That is, 100 Mexican pesos would exchange to 5.28 US dollars.
• {{To USD|100|MEX}} also displays 5.28.
• {{To USD|100|FRA}} displays 115.82.
• {{To USD|100|MEX|round=yes}} displays 5.
• {{Formatnum:{{To USD|100000|RUS}}}} displays ᱑,᱗᱑᱔.᱐᱙.
• {{To USD|100|MEX|year=2009}} displays Undefined year "2009" since data for 2009 has not yet been defined. It will add the page to Category:Pages using an undefined year in Template:To USD

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:International dollars: Converts a value in a given country in a given year to international dollars.
• {{formatnum:}}

Data subtemplates

• 2002
• 2011
• 2012
• 2013
• 2014
• 2015
• 2016
• 2017
• 2018

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; Italic textsee the monthly error report for this template.

TemplateData for To USD

Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund

Template parameters

Parameter		Description	Type	Status
amount	1	value in foreign currency to convert to USD 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 US cent. Example yes	String	optional