तपाईं "ढाँचा:To USD/कागजात"को स्रोत हेर्दै हुनुहुन्छ

{{documentation subpage}}
This template converts a value given in the national currency of a given country to [[United States dollar|US dollars]].  The template uses values published by the [[International Monetary Fund|IMF]].<ref>{{cite web|url=http://data.worldbank.org/indicator/PA.NUS.FCRF|title=Official exchange rate (LCU per US$, period average)|accessdate = 14 April 2013}}</ref>

===Syntax===
<nowiki>{{To USD | {{{1}}} | {{{2}}} | year = {{{year}}} | round = {{{round}}} }}</nowiki><br/>
*<nowiki>{{{1}}}</nowiki> is the value in the local currency to be converted.
*<nowiki>{{{2}}}</nowiki> is the country name or [[ISO 3166-1 alpha-3 | 3-letter ISO code]] for the country whose currency is being converted.
*<nowiki>{{{year}}}</nowiki> is the year to use for the US dollar value, e.g. US dollars current in 2009.  The default is currently 2018.
*<nowiki>{{{round}}}</nowiki> 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.

===Examples===
*<code><nowiki>{{To USD|100|Mexico}}</nowiki></code> displays {{To USD|100|Mexico}}.  That is, 100 [[Mexican peso]]s would exchange to {{To USD|100|MEX}} [[United States dollar | US dollars]].
*<code><nowiki>{{To USD|100|MEX}}</nowiki></code> also displays {{To USD|100|MEX}}.
*<code><nowiki>{{To USD|100|FRA}}</nowiki></code> displays {{To USD|100|FRA}}.
*<code><nowiki>{{To USD|100|MEX|round=yes}}</nowiki></code> displays {{To USD|100|MEX|round=yes}}.
*<code><nowiki>{{Formatnum:{{To USD|100000|RUS}}}}</nowiki></code> displays {{Formatnum:{{To USD|100000|RUS}}}}.
*<code><nowiki>{{To USD|100|MEX|year=2009}}</nowiki></code> displays {{To USD|100|MEX|year=2009}} since data for 2009 has not yet been defined. It will add the page to [[:Category:Pages using an undefined year in Template:To USD]]

===See also===
*[[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:International dollars]]:  Converts a value in a given country in a given year to [[Geary–Khamis dollar | international dollars]].
*{{tlc|[[Help:Parser functions|formatnum:]]}}

===Data subtemplates===
{{hlist| [[Template:To USD/data/2002|2002]] | [[Template:To USD/data/2011|2011]] | [[Template:To USD/data/2012|2012]] | [[Template:To USD/data/2013|2013]] | [[Template:To USD/data/2014|2014]] | [[Template:To USD/data/2015|2015]] | [[Template:To USD/data/2016|2016]] | [[Template:To USD/data/2017|2017]] | [[Template:To USD/data/2018|2018]] }}

===References===
{{reflist}}

<!-- ADD CATEGORIES BELOW THIS LINE -->
<includeonly>
{{DEFAULTSORT:{{BASEPAGENAME}}}}
[[Category:Currency conversion templates]]
</includeonly>
==TemplateData==
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"1": {
			"label": "amount",
			"description": "value in foreign currency to convert to USD",
			"example": "22816",
			"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",
			"example": "2002",
			"type": "number",
			"required": true
		},
		"round": {
			"label": "round to nearest dollar?",
			"description": "If 'yes', rounds to nearest whole dollar amount. If omitted, rounds to nearest US cent.",
			"example": "yes",
			"type": "string"
		}
	},
	"description": "Template to convert other currencies into United States dollars, by year, based on information from the International Monetary Fund"
}
</templatedata>