Template:To USD

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, as well as by the World Bank, the European Central Bank, Eurostat, and the Reserve Bank of India.

Syntax

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

• {{{1}}} and {{{2}}} are the template positional parameters (this is, the first and the second parameters in the template).
  • {{{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 2019.
• {{{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.
• {{{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.
• {{{cur}}} is an optional parameter. It allows to select the currency for the country. Currently only supported for the Euro and the currencies that have been immediately replaced by the Euro.

Examples

• {{To USD|100|Mexico}} displays Template:To USD/data/2019. That is, 100 Mexican pesos would exchange to Template:To USD/data/2019 US dollars.
• {{To USD|100|MEX}} also displays Template:To USD/data/2019.
• {{To USD|100|MEX|round=yes}} displays Template:To USD/data/2019.
• {{To USD|100|FRA}} displays . That is, 100 Euros (the currency used in France) is currently US dollars.
• {{Formatnum:{{To USD|100000|RUS}}}} displays Template:To USD/data/2 019.
• {{To USD|100|MEX|year=1959}} displays Template:Red since data for 1959 has not yet been defined. It will add the page to Category:Pages using an undefined year in Template:To USD

See also

• {{To USD round}}: Allows selection of number of significant figures; optimal for figures with lots of zeroes.
• {{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.
• {{International dollars}}: Converts a value in a given country in a given year to international dollars.
• {{formatnum:}}
• {{From USD}}
• {{To EUR}}
• {{From EUR}}
• {{FXConvert}}
• {{INRConvert}}

Data subtemplates

• 1960
• 1961
• 1962
• 1963
• 1964
• 1965
• 1966
• 1967
• 1968
• 1969
• 1970
• 1971
• 1972
• 1973
• 1974
• 1975
• 1976
• 1977
• 1978
• 1979
• 1980
• 1981
• 1982
• 1983
• 1984
• 1985
• 1986
• 1987
• 1988
• 1989
• 1990
• 1991
• 1992
• 1993
• 1994
• 1995
• 1996
• 1997
• 1998
• 1999
• 2000
• 2001
• 2002
• 2003
• 2004
• 2005
• 2006
• 2007
• 2008
• 2009
• 2010
• 2011
• 2012
• 2013
• 2014
• 2015
• 2016
• 2017
• 2018
• 2019
• 2020
• 2021

References

Tracking categories

• Category:Pages using a wrong currency in Template:To USD (0)
• Category:Pages using an unknown country code in Template:To USD (0)
• Category:Pages using an undefined year in Template:To USD (2)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. click here to see a monthly parameter usage report for this template based on this TemplateData.

TemplateData for To USD

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

Parametri template[Modifica dati del modello]

Parametro		Descrizione	Tipo	Stato
Amount	1	value in foreign currency to convert to USD Esempio 22816	Numero	obbligatorio
Country code	2 country	ISO 3166-1 alpha-3 country code Esempio MEX	Linea	obbligatorio
year	year	Year to convert currency Esempio 2002	Numero	obbligatorio
Round to nearest dollar?	round	If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest US cent. Esempio yes	Stringa	facoltativo
Resolution	r	The number of digits of precision in the result value. Esempio 3	Numero	facoltativo
Currency code	cur	It allows to select the currency for the country. Currently only supported for the Euro and the currencies that have been immediately replaced by the Euro. Esempio FRF, EUR	Linea	facoltativo

The above documentation is transcluded from Template:To USD/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.