 | This is a documentation subpage for Template:From USD. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template uses Lua: |
This template converts a value given in US dollars to the national currency of a given country.
Syntax
edit{{From USD | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} | r = {{{r}}} | cur = {{{cur}}} | series = {{{series}}} }}
- {{{1}}} and {{{2}}} are the template positional parameters (this is, the first and the second parameters in the template).
- {{{1}}} is the value in US dollars to be converted.
- {{{2}}} is the country name or 3-letter ISO code for the country whose currency is being converted to.
- {{{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 integer. The default is rounding to the nearest cent.
- {{{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 target country. Currently only supported for the Euro and the currencies that have been immediately replaced by the Euro.
Examples
edit{{From USD|100|USA}}displays 100. Trivial US dollar conversions work.{{From USD|100|FRA}}displays 84.55. Defaults to Euro{{From USD|100|FRA|cur=}}displays 84.55. Still defaults to Euro{{From USD|100|FRA|cur=EUR}}displays 84.55. Redundant.{{From USD|100|FRA|cur=FRF}}displays 554.63. That is, 100 US dollars is worth 554.63 French Francs.{{From USD|100|FRA|cur=FRF|year=}}also displays 554.63. They would exchange to 554.63 French Francs according to the latest year for which some country has data, but for a Eurozone country the rate is fixed anyway.{{From USD|100|FRA|cur=FRF|r=1}}displays 554.6. Decrease the precision.{{From USD|100|FRA|cur=FRF|r=0}}displays 555. Do not show any decimals.{{From USD|100|FRA|cur=FRF|round=yes}}also displays 555.{{From USD|0.01|FRA|cur=FRF}}displays 0.06. By default, the converted value has up to 2 decimals.{{From USD|0.01|FRA|cur=FRF|r=5}}displays 0.05546. Increase the precision to 5 decimals.{{Formatnum:{{From USD|100000|USA}}}}displays 100,000.{{From USD|100|TWN|year=1960}}displays Unknown country code for year 1960: TWN since Taiwanese data for 1960 has not yet been entered.{{From USD|100|MEX|year=1959}}displays Undefined year "1959" since data for 1959 has not been defined.{{From USD|100|MEX|year=2021}}displays 2027 since the data for 2021 has not been entered yet.
{{From USD|1|FRA|year=1971|r=15}}displays 5.5088280206065{{From USD|1|FRA|cur=FRF|year=1971|r=15}}displays 5.5088280206065{{From USD|1|FRA|cur=FRF|year=1999|r=15}}displays 6.154597485443
{{From USD|{{From EUR|1|USA|year=1971|r=15}}|EUR|year=1971|r=15}}displays 1.0000000000001{{From USD|{{From EUR|1|USA|year=1972|r=15}}|EUR|year=1972|r=15}}displays 1.0000000000002{{From USD|{{From EUR|1|USA|year=1973|r=15}}|EUR|year=1973|r=15}}displays 1{{From USD|{{From EUR|1|USA|year=1974|r=15}}|EUR|year=1974|r=15}}displays 1.0000000000001{{From USD|{{From EUR|1|USA|year=1975|r=15}}|EUR|year=1975|r=15}}displays 1.0000000000006{{From USD|{{From EUR|1|USA|year=1976|r=15}}|EUR|year=1976|r=15}}displays 1.0000000000005{{From USD|{{From EUR|1|USA|year=1977|r=15}}|EUR|year=1977|r=15}}displays 1.0000000000001{{From USD|{{From EUR|1|USA|year=1978|r=15}}|EUR|year=1978|r=15}}displays 1.0000000000002{{From USD|{{From EUR|1|USA|year=1979|r=15}}|EUR|year=1979|r=15}}displays 0.99999999999985{{From USD|{{From EUR|1|USA|year=1980|r=15}}|EUR|year=1980|r=15}}displays 0.9999999999995{{From USD|{{From EUR|1|USA|year=1981|r=15}}|EUR|year=1981|r=15}}displays 0.99999999999964{{From USD|{{From EUR|1|USA|year=1982|r=15}}|EUR|year=1982|r=15}}displays 0.99999999999991{{From USD|{{From EUR|1|USA|year=1983|r=15}}|EUR|year=1983|r=15}}displays 1.0000000000002{{From USD|{{From EUR|1|USA|year=1984|r=15}}|EUR|year=1984|r=15}}displays 1.0000000000003{{From USD|{{From EUR|1|USA|year=1985|r=15}}|EUR|year=1985|r=15}}displays 0.99999999999966{{From USD|{{From EUR|1|USA|year=1986|r=15}}|EUR|year=1986|r=15}}displays 0.9999999999996{{From USD|{{From EUR|1|USA|year=1987|r=15}}|EUR|year=1987|r=15}}displays 0.99999999999983{{From USD|{{From EUR|1|USA|year=1988|r=15}}|EUR|year=1988|r=15}}displays 1{{From USD|{{From EUR|1|USA|year=1989|r=15}}|EUR|year=1989|r=15}}displays 0.99999999999945{{From USD|{{From EUR|1|USA|year=1990|r=15}}|EUR|year=1990|r=15}}displays 0.99999999999976{{From USD|{{From EUR|1|USA|year=1991|r=15}}|EUR|year=1991|r=15}}displays 0.99999999999992{{From USD|{{From EUR|1|USA|year=1992|r=15}}|EUR|year=1992|r=15}}displays 0.99999999999946{{From USD|{{From EUR|1|USA|year=1993|r=15}}|EUR|year=1993|r=15}}displays 1.0000000000003{{From USD|{{From EUR|1|USA|year=1994|r=15}}|EUR|year=1994|r=15}}displays 0.99999999999941{{From USD|{{From EUR|1|USA|year=1995|r=15}}|EUR|year=1995|r=15}}displays 0.99999999999969{{From USD|{{From EUR|1|USA|year=1996|r=15}}|EUR|year=1996|r=15}}displays 0.99999999999953{{From USD|{{From EUR|1|USA|year=1997|r=15}}|EUR|year=1997|r=15}}displays 0.99999999999947{{From USD|{{From EUR|1|USA|year=1998|r=15}}|EUR|year=1998|r=15}}displays 0.99999999999991{{From USD|{{From EUR|1|USA|year=1999|r=15}}|EUR|year=1999|r=15}}displays 0.99999999999972{{From USD|{{From EUR|1|USA|year=2000|r=15}}|EUR|year=2000|r=15}}displays 0.99999999999982{{From USD|{{From EUR|1|USA|year=2001|r=15}}|EUR|year=2001|r=15}}displays 0.99999999999962{{From USD|{{From EUR|1|USA|year=2002|r=15}}|EUR|year=2002|r=15}}displays 1.0000000000001{{From USD|{{From EUR|1|USA|year=2003|r=15}}|EUR|year=2003|r=15}}displays 0.99999999999991{{From USD|{{From EUR|1|USA|year=2004|r=15}}|EUR|year=2004|r=15}}displays 1.0000000000004{{From USD|{{From EUR|1|USA|year=2005|r=15}}|EUR|year=2005|r=15}}displays 1.0000000000002{{From USD|{{From EUR|1|USA|year=2006|r=15}}|EUR|year=2006|r=15}}displays 0.99999999999936{{From USD|{{From EUR|1|USA|year=2007|r=15}}|EUR|year=2007|r=15}}displays 0.99999999999985{{From USD|{{From EUR|1|USA|year=2008|r=15}}|EUR|year=2008|r=15}}displays 1.0000000000007{{From USD|{{From EUR|1|USA|year=2009|r=15}}|EUR|year=2009|r=15}}displays 1.0000000000006{{From USD|{{From EUR|1|USA|year=2010|r=15}}|EUR|year=2010|r=15}}displays 1.0000000000005{{From USD|{{From EUR|1|USA|year=2011|r=15}}|EUR|year=2011|r=15}}displays 0.99999999999957{{From USD|{{From EUR|1|USA|year=2012|r=15}}|EUR|year=2012|r=15}}displays 1.0000000000004{{From USD|{{From EUR|1|USA|year=2013|r=15}}|EUR|year=2013|r=15}}displays 0.9999999999997{{From USD|{{From EUR|1|USA|year=2014|r=15}}|EUR|year=2014|r=15}}displays 0.99999999999977{{From USD|{{From EUR|1|USA|year=2015|r=15}}|EUR|year=2015|r=15}}displays 0.99999999999973{{From USD|{{From EUR|1|USA|year=2016|r=15}}|EUR|year=2016|r=15}}displays 1.0000000000004{{From USD|{{From EUR|1|USA|year=2017|r=15}}|EUR|year=2017|r=15}}displays 1.0000000000005{{From USD|{{From EUR|1|USA|year=2018|r=15}}|EUR|year=2018|r=15}}displays 1.0000000000005{{From USD|{{From EUR|1|USA|year=2019|r=15}}|EUR|year=2019|r=15}}displays 1.0000000000005{{From USD|{{From EUR|1|USA|year=2020|r=15}}|EUR|year=2020|r=15}}displays 1.0000000000003
{{To USD|{{To EUR|{{From USD|1|IND|year=1999|r=4}}|IND|year=1999|r=4}}|EUR|year=1999|r=4}}displays 0.9975{{To USD|{{To EUR|{{From USD|1|IND|year=2000|r=4}}|IND|year=2000|r=4}}|EUR|year=2000|r=4}}displays 1.0004{{To USD|{{To EUR|{{From USD|1|IND|year=2001|r=4}}|IND|year=2001|r=4}}|EUR|year=2001|r=4}}displays 0.9993{{To USD|{{To EUR|{{From USD|1|IND|year=2002|r=4}}|IND|year=2002|r=4}}|EUR|year=2002|r=4}}displays 1.0015{{To USD|{{To EUR|{{From USD|1|IND|year=2003|r=4}}|IND|year=2003|r=4}}|EUR|year=2003|r=4}}displays 1.0007{{To USD|{{To EUR|{{From USD|1|IND|year=2004|r=4}}|IND|year=2004|r=4}}|EUR|year=2004|r=4}}displays 1.0007{{To USD|{{To EUR|{{From USD|1|IND|year=2005|r=4}}|IND|year=2005|r=4}}|EUR|year=2005|r=4}}displays 0.9994{{To USD|{{To EUR|{{From USD|1|IND|year=2006|r=4}}|IND|year=2006|r=4}}|EUR|year=2006|r=4}}displays 0.9993{{To USD|{{To EUR|{{From USD|1|IND|year=2007|r=4}}|IND|year=2007|r=4}}|EUR|year=2007|r=4}}displays 1.0012{{To USD|{{To EUR|{{From USD|1|IND|year=2008|r=4}}|IND|year=2008|r=4}}|EUR|year=2008|r=4}}displays 1.0038{{To USD|{{To EUR|{{From USD|1|IND|year=2009|r=4}}|IND|year=2009|r=4}}|EUR|year=2009|r=4}}displays 1.0019{{To USD|{{To EUR|{{From USD|1|IND|year=2010|r=4}}|IND|year=2010|r=4}}|EUR|year=2010|r=4}}displays 0.9992{{To USD|{{To EUR|{{From USD|1|IND|year=2011|r=4}}|IND|year=2011|r=4}}|EUR|year=2011|r=4}}displays 1.0014{{To USD|{{To EUR|{{From USD|1|IND|year=2012|r=4}}|IND|year=2012|r=4}}|EUR|year=2012|r=4}}displays 0.9997{{To USD|{{To EUR|{{From USD|1|IND|year=2013|r=4}}|IND|year=2013|r=4}}|EUR|year=2013|r=4}}displays 0.999{{To USD|{{To EUR|{{From USD|1|IND|year=2014|r=4}}|IND|year=2014|r=4}}|EUR|year=2014|r=4}}displays 0.9996{{To USD|{{To EUR|{{From USD|1|IND|year=2015|r=4}}|IND|year=2015|r=4}}|EUR|year=2015|r=4}}displays 0.9991{{To USD|{{To EUR|{{From USD|1|IND|year=2016|r=4}}|IND|year=2016|r=4}}|EUR|year=2016|r=4}}displays 1.0001{{To USD|{{To EUR|{{From USD|1|IND|year=2017|r=4}}|IND|year=2017|r=4}}|EUR|year=2017|r=4}}displays 1.0008{{To USD|{{To EUR|{{From USD|1|IND|year=2018|r=4}}|IND|year=2018|r=4}}|EUR|year=2018|r=4}}displays 1.0007{{To USD|{{To EUR|{{From USD|1|IND|year=2019|r=4}}|IND|year=2019|r=4}}|EUR|year=2019|r=4}}displays 0.9998
{{To USD|{{To EUR|{{From USD|1|CHN|year=2001|r=4}}|CHN|year=2001|r=4}}|EUR|year=2001|r=4}}displays 1{{To USD|{{To EUR|{{From USD|1|CHN|year=2002|r=4}}|CHN|year=2002|r=4}}|EUR|year=2002|r=4}}displays 1.0001{{To USD|{{To EUR|{{From USD|1|CHN|year=2003|r=4}}|CHN|year=2003|r=4}}|EUR|year=2003|r=4}}displays 1{{To USD|{{To EUR|{{From USD|1|CHN|year=2004|r=4}}|CHN|year=2004|r=4}}|EUR|year=2004|r=4}}displays 0.9998{{To USD|{{To EUR|{{From USD|1|CHN|year=2005|r=4}}|CHN|year=2005|r=4}}|EUR|year=2005|r=4}}displays 0.9999{{To USD|{{To EUR|{{From USD|1|CHN|year=2006|r=4}}|CHN|year=2006|r=4}}|EUR|year=2006|r=4}}displays 1.0002{{To USD|{{To EUR|{{From USD|1|CHN|year=2007|r=4}}|CHN|year=2007|r=4}}|EUR|year=2007|r=4}}displays 1.0007{{To USD|{{To EUR|{{From USD|1|CHN|year=2008|r=4}}|CHN|year=2008|r=4}}|EUR|year=2008|r=4}}displays 0.9997{{To USD|{{To EUR|{{From USD|1|CHN|year=2009|r=4}}|CHN|year=2009|r=4}}|EUR|year=2009|r=4}}displays 1.0001{{To USD|{{To EUR|{{From USD|1|CHN|year=2010|r=4}}|CHN|year=2010|r=4}}|EUR|year=2010|r=4}}displays 1.0005{{To USD|{{To EUR|{{From USD|1|CHN|year=2011|r=4}}|CHN|year=2011|r=4}}|EUR|year=2011|r=4}}displays 0.9999{{To USD|{{To EUR|{{From USD|1|CHN|year=2012|r=4}}|CHN|year=2012|r=4}}|EUR|year=2012|r=4}}displays 1.0006{{To USD|{{To EUR|{{From USD|1|CHN|year=2013|r=4}}|CHN|year=2013|r=4}}|EUR|year=2013|r=4}}displays 1.0079{{To USD|{{To EUR|{{From USD|1|CHN|year=2014|r=4}}|CHN|year=2014|r=4}}|EUR|year=2014|r=4}}displays 0.997{{To USD|{{To EUR|{{From USD|1|CHN|year=2015|r=4}}|CHN|year=2015|r=4}}|EUR|year=2015|r=4}}displays 0.9908{{To USD|{{To EUR|{{From USD|1|CHN|year=2016|r=4}}|CHN|year=2016|r=4}}|EUR|year=2016|r=4}}displays 1.0003{{To USD|{{To EUR|{{From USD|1|CHN|year=2017|r=4}}|CHN|year=2017|r=4}}|EUR|year=2017|r=4}}displays 1.0008{{To USD|{{To EUR|{{From USD|1|CHN|year=2018|r=4}}|CHN|year=2018|r=4}}|EUR|year=2018|r=4}}displays 1.0007{{To USD|{{To EUR|{{From USD|1|CHN|year=2019|r=4}}|CHN|year=2019|r=4}}|EUR|year=2019|r=4}}displays 0.9998
See also
edit- {{To USD}} is leveraged by {{From USD}}
{{formatnum:}}- {{To USD round}}
- {{Inflation}}
- {{International dollars}}
- {{From USD}}
- {{To EUR}}
- {{From EUR}}
- {{FXConvert}}
- {{INRConvert}}
- {{Per capita}}
References
edit
TemplateData
editThis is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:From USD in articles based on its TemplateData.
TemplateData for From USD
Template to convert US dollars into other currencies, by year
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Amount | 1 | value in US dollars to convert to other currency
| Number | required |
| Country code | 2 country | ISO 3166-1 alpha-3 country code
| Line | required |
| year | year | Year to convert currency
| Number | required |
| Round to nearest integer? | round | If 'yes', rounds to nearest whole amount. If omitted, rounds to nearest cent.
| String | optional |
| Resolution | r | The number of digits of precision in the result value.
| Number | optional |
| 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.
| Line | optional |