Template:To USD/sandbox

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

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 2017.
• {{{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 in 2017.
• {{To USD|100|MEX}} also displays 5.28.
• {{To USD|100|FRA}} displays 112.74.
• {{To USD|100|MEX|round=yes}} displays 5.
• {{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.

Data subtemplates

• 2015
• 2016
• 2017
• 2018
• 2019
• 2020
• 2021
• 2022

References

TemplateData

This is the TemplateData documentation for the template used by the new VisualEditor.

To USD

<templatedata> { "params": { "1": { "label": "amount", "description": "value in foreign currency to convert to USD", "example": "22,816", "type": "number", "required": true }, "2": { "aliases": [ "code", "curr", "currency" ], "label": "currency code", "description": "ISO 3166-1 alpha-3 currency code", "example": "EUR", "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 US cent.", "example": "yes", "type": "string" } }, "description": "Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund" } </templatedata>