ਫਰਮਾ:To USD round/doc

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 ਫਰਮਾ:Euro turning into US$, you just want a round figure like US$36,00,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.

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 ਫਰਮਾ:To USD round/doc
• {{To USD round|5200|MEX|year=2009}} displays Bad rounding here since data for 2009 has not been entered for Mexico. It will add the page to Category:Pages using an undefined country code in ਫਰਮਾ:To USD round/doc

---

• {{To USD round|586000|BRA|year=2011}} → Bad rounding here
• {{To USD round|586000|BRA|year=2019}} → 1,49,000
• {{To USD round|586000|BRA|year=}} → 1,49,000
• {{To USD round|586000|BRA}} → 1,49,000
• {{To USD round|620000000|BRA|year=2015}} → Bad rounding here
• {{To USD round|620000000|BRA|year=2015|sf=4}} → Bad rounding here
• {{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:}}

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 round

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

ਫਰਮੇ ਦੇ ਮਾਪਦੰਡ

ਮਾਪਦੰਡ		ਵੇਰਵਾ	ਕਿਸਮ	ਦਰਜਾ
amount	1	value in foreign currency to convert to USD Example 175000	Number	required
country code	2 country	ISO 3166-1 alpha-3 country code Example MEX	Line	required
year	year	Year to convert currency. Values: 1960–2022. ਮੂਲ ਰੂਪ 2019 Example 2002	Number	optional
significant figures	sf	If numeric, rounds to that many significant figures. If omitted, rounds to number of significant figures in 'amount'. Example 3	Number	optional