வார்ப்புரு:To USD round/doc
Template documentation[view] [edit] [history] [purge]
 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 euros turning into $3,655,040 dollars, you just want a round figure like $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.
 
 பொருளடக்கம்
 
 
 
 === Syntax ===
 
 &lt;code&gt;&lt;nowiki&gt;{{&lt;/nowiki&gt;To USD round|''AMOUNT''|''COUNTRY''|''YEAR''|sf=''SIGFIG''&lt;nowiki&gt;}}&lt;/nowiki&gt;&lt;/code&gt;
 
 * ''AMOUNT'' is the value in the local currency to be converted.
 * ''COUNTRY'' is the country name or [[ISO 3166-1 alpha-3 | 3-letter ISO code]] for the country whose currency is being converted.
 * ''YEAR'' (optional) is the year to use for the US dollar exchange rate value against the currency of the other country.  The default is currently 2019. Possible values: 2002, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019.
 * ''SIGFIG'' (optional) is a numerical value. If present, the converted value is displayed to the that number of [[significant figures]]. The default is the number of significant figures in ''AMOUNT''.
 
 
 
 ==Examples==
 {{To USD round|5200|Mexico}} displays 270. That is, 5200 Mexican pesos would exchange to roughly 270 US dollars (to two signficant digits) at the 2019 exchange rate.
 {{To USD round|5200|MEX}} also displays 270.
 {{To USD round|1250|FRA}} displays 1,400.
 {{To USD round|5200|MEX|sf=3}} displays 270.
 {{Formatnum:{{To USD round|18000|RUS}}}} displays 2,800.
 {{To USD round|5200|MEX|year=1998}} displays Undefined year &quot;1998&quot; 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
 {{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
 {{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 (last year available)
 {{To USD round|586000|BRA}} = 149,000 (last year available)
 {{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}} displays 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.
 {{formatnum:}}
 
 
 
 ==Data subtemplates==
 2002
 2011
 2012
 2013
 2014
 2015
 2016
 2017
 2018
 2019
 
 
 ==References==
 ^ 
 
 ==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
 Template parameters
 Parameter
 Description
 Type
 Status
 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: 2002, 2011–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
 The above documentation is transcluded from Template:To USD round/doc. (edit | history)
 Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.