Template:To USD round/doc
 | This is a documentation subpage for Template:To USD round. It may contain usage information, categories and other content that is not part of the original template page. |
This template converts a value given in the national currency of a given country to a round US dollar figure. The intended use is for large round figures, when you don't want €3.2 million turning into US$3,784,640, you just want a round figure like US$3,600,000. It tries to mimic the same number of significant figures as are present in the original amount. The template uses values published by the IMF.[1]
Usage
{{To USD round|AMOUNT|COUNTRY|YEAR|sf=SIGFIG}}
Parameters
There are three unnamed parameters, and one named parameter:
|1=is the amount in local currency to be converted to US dollars. Required.|2=is the name or 3-letter ISO code of the country whose currency is being converted. Required.|3=is the year to use for the US dollar exchange rate against the currency of the other country. Possible values: see § Data subtemplates below. Optional; default =2019.|sf=is number of significant figures. The converted value is displayed to that precision. Optional; the default is the number of significant figures in the amount given in param 1.
Examples
{{To USD round|5200|Mexico}}displays 270. That is, 5200 Mexican pesos would exchange to roughly 270 US dollars (to two significant digits) at the 2019 exchange rate.{{To USD round|5200|MEX}}→ 270{{To USD round|1250|FRA}}→ 1,400{{To USD round|5200|MEX}}→ 270{{Formatnum:{{To USD round|185000|RUS}}}}⟶ 28,600.{{To USD round|5200|MEX|year=1998}}displays Undefined year "1998" since data for 1998 has not been defined. It will add the page to Category:Pages using an undefined year in Template:To USD round/doc{{To USD round|5200|MEX|year=2009}}displays 380 since data for 2009 has not been entered for Mexico. It will add the page to Category:Pages using an undefined country code in Template:To USD round/doc
{{To USD round|586000|BRA|year=2011}}→ 350,000{{To USD round|586000|BRA|year=2019}}→ 149,000{{To USD round|586000|BRA|year=}}→ 149,000{{To USD round|586000|BRA}}→ 149,000{{To USD round|620000000|BRA|year=2015}}→ 190,000,000{{To USD round|620000000|BRA|year=2015|sf=4}}→ 186,400,000{{To USD round|640|MEX|sf=5}}→ 33.220 # Some combos make no sense; USD doesn't have tenths of a cent.
See also
- Template:US$
- 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
- Template:Round
- Template:significant figures
- Template:International dollars: Converts a value in a given country in a given year to international dollars.
- Template:Per capita
{{formatnum:}}
Data subtemplates
References
- ^ "Official exchange rate (LCU per US$, period average)". Retrieved 14 April 2013.
TemplateData
TemplateData for To USD round
<templatedata> { "params": { "1": { "label": "amount", "description": "value in foreign currency to convert to USD", "example": "175000", "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. Values: 1960–2022.", "example": "2002", "type": "number", "default": "2019", "required": false }, "sf": { "label": "significant figures", "description": "If numeric, rounds to that many significant figures. If omitted, rounds to number of significant figures in 'amount'.", "example": "3", "type": "number" } }, "description": "Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund, and with selected number of significant figures" } </templatedata>