Template:FXConvert/doc

Template page


Purpose

The purpose of this template is to automatically convert and format currency applying adjustment for inflation where appropriate. Rates of exchange and inflation must be manually copied by editors in the supporting templates therefore this template's output does not necessarily reflect the present exchange rates or price indices but, rather, reflects the rates and indices at the time of the last update.

The default target currency (USD at present) may change in the future. Currently, only the Euro is also supported.

Usage

{{FXConvert|country_code|value|currency_units|cur=|cursign=|infsign=|year=|index=|to=|r=|force=|lk=|exact=|showdate=|ref=|mode=|convert=}}

Parameters

A description of the template's parameters are listed below.

Field name Usage Example Description
country_code mandatory GBR The country code of the currency to be converted, e.g. DEU (Germany, Euro since the year 2000).
value mandatory 10000.01 The value, in the country_code currency, that needs to be converted. The template will not accept pre-formatted values (i.e. 1,234).
currency_units optional m Used to represent smaller or larger numbers. Available options are as follows.
  • ct – to represent cent(s)
  • p – to represent penny (pence)
  • pa – to represent paisa (paise) (generalized to mean cents)
  • po – to represent poysha (generalized to mean cents)
  • ba – to represent baisa(s) (generalized to mean 1/1000)
  • k – to represent thousand(s)
  • m – to represent million(s)
  • b – to represent short scale billion(s)
  • t – to represent short scale trillion(s)
  • l – to represent lakh(s)
  • c – to represent crore(s)
  • lc – to represent lakh crore(s)
  • Brackets in the sense may be singular (or) plural.

The Indian units can be applied to any currency.

cur optional cur=FRF This is an optional parameter. 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.
cursign optional cursign=[[£]] This provides a currency sign for the original and inflated (without conversion) values. If the argument is not present they will be shown without one.
infsign optional infsign=£ This provides a currency sign for the inflated (without conversion) value. If the argument is not present, cursign will be looked for.
lk optional lk=on This parameter gives you the option of internally linking currency names (paise, which is generalized here to mean cents in the source currency) and/or number names (billion, trillion, lakh, crore). By default, the parameter is set to "off" (i.e. it is set not to link). Available options are as follows.
  • on – to link all units
  • source – to link the source value
  • original – to link the values in the original currency
  • inflated – to link the inflated value in the original currency
  • result – to link the inflated and converted vales
  • converted – to link the converted value
  • source-converted – to link the source and converted values
year optional year=2002 This parameter allows entering values from previous years. The year will be displayed and historic values will be inflated to the latest year available in {{Inflation{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}}} if index is also provided then converted. If no index name is present, the conversion will be attempted for the year indicated (but see force). If year is not provided, just a conversion will be performed at the most current rate available.
index optional index=UK-GDP This parameter allows for inflation. Historic values will be inflated to the latest year available in {{Inflation{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}}} then converted.
to optional to=EUR This parameter allows for conversion to various different currencies. Currently, the USD (default) and the euro are supported.
r optional r=3 Sets the digits to which the results must be rounded. A negative value indicates rounding to an upper significant digit, and a positive value indicates a fractional digit including trailing zeros. Defaults to 2.
force optional force=yes This parameter allows to force a conversion at the most current rate available when data is lacking for the provided year when its value is yes.
exact optional exact=source This provides some control over formatting. source requests to display the input value normally (in American fashion) after applying the units. on does this for both the input and result values. Otherwise all values will be displayed as per {{Format price{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}{{---}}}}.
showdate optional showdate=no This allows to disable displaying the original year.
ref optional ref=<ref>some wikitext ref</ref> This allows displaying one or more references next to the original value. Each one must consist of a ref wikitext element.
mode optional mode=historical This parameter controls the output mode. Setting it to blank or omitting it results in the default mode. Setting it to historical allows conversion using historical exchange rates.
convert optional convert=no This parameter controls the currency conversion. Setting it to blank or omitting it results in the default mode. Setting it to no disables it.

Examples

FXConvert syntax Results
{{FXConvert|DNK|1|cursign=[[Danish krone|DKK]] |infsign=DKK |mode=historical|convert=no}} DKK 1
{{FXConvert|USA|1|lk=on}} 1
{{FXConvert|USA|1|ct}} 0.01
{{FXConvert|USA|1|ct|exact=source}} 0.01
{{FXConvert|USA|1|ct|exact=on}} 0.01
{{FXConvert|USA|1|ct|year=2002}} 0.01 (2002)
{{FXConvert|USA|1|ct|year=2002|lk=on}} 0.01 (2002)
{{FXConvert|USA|1.01|m|year=2002|index=US}} 1.01 million (2002) (equivalent to 1.64 million in 2022)[1]
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP}} 1.01 million (2002) (equivalent to 1.48 million in 2021)[2]
{{FXConvert|USA|1.01|m|year=2002|index=US|exact=on}} 1,010,000 (2002) (equivalent to 1,643,282.15 in 2022)[1]
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP|exact=on}} 1,010,000 (2002) (equivalent to 1,475,425.15 in 2021)[2]
{{FXConvert|USA|1.01|m|year=2002|index=US|exact=source}} 1,010,000 (2002) (equivalent to 1.64 million in 2022)[1]
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP|exact=source}} 1,010,000 (2002) (equivalent to 1.48 million in 2021)[2]
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP|exact=source|mode=historical}} 1,010,000 (2002)
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP|to=EUR}} 1.01 million (2002) (equivalent to 1.48 million in 2021)[2]
{{FXConvert|USA|1.01|m|year=2002|index=US-GDP|to=EUR|showdate=no|ref=<ref name="s3">something3</ref>}} 1.01 million[3] (equivalent to 1.48 million in 2021)[2]
{{FXConvert|KOR|1|ct|lk=on}} 0.01 (US$0)
{{FXConvert|KOR|10|ct}} 0.1 (US$0)
{{FXConvert|KOR|1|ct|exact=source}} 0.01 (US$0)
{{FXConvert|KOR|10|ct|exact=source}} 0.1 (US$0)
{{FXConvert|KOR|1|ct|exact=on}} 0.01 (US$0)
{{FXConvert|KOR|10|ct|exact=on}} 0.1 (US$0)
{{FXConvert|KOR|1|ct|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|KOR|10|ct|year=2002}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|KOR|1|ct|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|KOR|10|ct|year=2002|lk=on}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|KOR|1|ct|year=2002|index=KRW}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=KRW (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2017" in 2017)[4]
{{FXConvert|KOR|10|ct|year=2002|index=KRW}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=KRW (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2017" in 2017)[4]
{{FXConvert|KOR|1|ct|year=2002|index=KRW|exact=on}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=KRW (parameter 1) not a recognized index. or US$Template:To USD/data/2,017 in 2017)[4]
{{FXConvert|KOR|10|ct|year=2002|index=KRW|exact=on}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=KRW (parameter 1) not a recognized index. or US$Template:To USD/data/2,017 in 2017)[4]
{{FXConvert|CAN|1|ct|lk=on}} 0.01 (US$0.01)
{{FXConvert|CAN|10|ct}} 0.1 (US$0.08)
{{FXConvert|CAN|1|ct|exact=source}} 0.01 (US$0.01)
{{FXConvert|CAN|10|ct|exact=source}} 0.1 (US$0.08)
{{FXConvert|CAN|1|ct|exact=on}} 0.01 (US$0.01)
{{FXConvert|CAN|10|ct|exact=on}} 0.1 (US$0.08)
{{FXConvert|CAN|1|ct|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|10|ct|year=2002}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|ct|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|10|ct|year=2002|lk=on}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|ct|year=2002|index=CA}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|10|ct|year=2002|index=CA}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|1|ct|year=2002|index=CA|exact=on}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. or US$Expression error: Unexpected < operator. in 2021)[5]
{{FXConvert|CAN|10|ct|year=2002|index=CA|exact=on}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. or US$Expression error: Unexpected < operator. in 2021)[5]
{{FXConvert|CAN|1|year=2002|index=CA|exact=on}} 1 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. or US$Expression error: Unexpected < operator. in 2021)[5]
{{FXConvert|CAN|1|year=2002|index=CA|exact=on|mode=historical}} 1 (2002) (US$Template:To USD/data/2,002)
{{FXConvert|CAN|1|ct|lk=on|convert=no}} 0.01
{{FXConvert|CAN|10|ct|convert=no}} 0.1
{{FXConvert|CAN|1|ct|exact=source|convert=no}} 0.01
{{FXConvert|CAN|10|ct|exact=source|convert=no}} 0.1
{{FXConvert|CAN|1|ct|exact=on|convert=no}} 0.01
{{FXConvert|CAN|10|ct|exact=on|convert=no}} 0.1
{{FXConvert|CAN|1|ct|year=2002|convert=no}} 0.01 (2002)
{{FXConvert|CAN|10|ct|year=2002|convert=no}} 0.1 (2002)
{{FXConvert|CAN|1|ct|year=2002|lk=on|convert=no}} 0.01 (2002)
{{FXConvert|CAN|10|ct|year=2002|lk=on|convert=no}} 0.1 (2002)
{{FXConvert|CAN|1|ct|year=2002|index=CA|convert=no}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " in 2021)[5]
{{FXConvert|CAN|10|ct|year=2002|index=CA|convert=no}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " in 2021)[5]
{{FXConvert|CAN|1|ct|year=2002|index=CA|exact=on|convert=no}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. in 2021)[5]
{{FXConvert|CAN|10|ct|year=2002|index=CA|exact=on|convert=no}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. in 2021)[5]
{{FXConvert|CAN|1|year=2002|index=CA|exact=on|convert=no}} 1 (2002) (equivalent to Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. in 2021)[5]
{{FXConvert|CAN|1|year=2002|index=CA|exact=on|mode=historical|convert=no}} 1 (2002)
{{FXConvert|GBR|1|p|lk=on}} 0.01 (US$0.01)
{{FXConvert|GBR|10|p}} 0.1 (US$0.14)
{{FXConvert|GBR|1|p|exact=source}} 0.01 (US$0.01)
{{FXConvert|GBR|10|p|exact=source}} 0.1 (US$0.14)
{{FXConvert|GBR|1|p|exact=on}} 0.01 (US$0.01)
{{FXConvert|GBR|10|p|exact=on}} 0.1 (US$0.14)
{{FXConvert|GBR|1|p|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|GBR|10|p|year=2002}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|GBR|1|p|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|GBR|10|p|year=2002|lk=on}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|GBR|1|p|year=2002|index=UK}} 0.01 (2002) (equivalent to 0.02 or US$0.03 in 2021)[6]
{{FXConvert|GBR|10|p|year=2002|index=UK}} 0.1 (2002) (equivalent to 0.17 or US$0.23 in 2021)[6]
{{FXConvert|GBR|1|p|year=2002|index=UK-GDP}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
{{FXConvert|GBR|10|p|year=2002|index=UK-GDP}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
{{FXConvert|GBR|1|p|year=2002|index=UK|exact=on}} 0.01 (2002) (equivalent to 0.02 or US$0.03 in 2021)[6]
{{FXConvert|GBR|10|p|year=2002|index=UK|exact=on}} 0.1 (2002) (equivalent to 0.17 or US$0.23 in 2021)[6]
{{FXConvert|GBR|1|p|year=2002|index=UK-GDP|exact=on}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index. or US$Template:To USD/data/2,019 in 2019)[7]
{{FXConvert|GBR|10|p|year=2002|index=UK-GDP|exact=on}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index. or US$Template:To USD/data/2,019 in 2019)[7]
{{FXConvert|IND|1|pa|lk=on}} 0.01 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|pa|lk=on|r=5}} 0.01 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|10|pa}} 0.1 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|pa|exact=source}} 0.01 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|10|pa|exact=source}} 0.1 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|pa|exact=on}} 0.01 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|1|pa|exact=on|r=5}} 0.01 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|10|pa|exact=on}} 0.1 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|1|pa|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|10|pa|year=2002}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|pa|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|10|pa|year=2002|lk=on}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|pa|year=2002|index=IN}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Undefined year "2023"" in 2023)[8]
{{FXConvert|IND|1|pa|year=2002|index=IN|r=5}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Undefined year "2023"" in 2023)[8]
{{FXConvert|IND|10|pa|year=2002|index=IN}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Undefined year "2023"" in 2023)[8]
{{FXConvert|IND|1|pa|year=2002|index=IN|exact=on}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index. or US$Undefined year "2,023" in 2023)[8]
{{FXConvert|IND|1|pa|year=2002|index=IN|exact=on|r=5}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index. or US$Undefined year "2,023" in 2023)[8]
{{FXConvert|IND|10|pa|year=2002|index=IN|exact=on}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=IN (parameter 1) not a recognized index. or US$Undefined year "2,023" in 2023)[8]
{{FXConvert|BGD|1|po|lk=on}} 0.01 (US$0)
{{FXConvert|BGD|1|po|lk=on|r=5}} 0.01 (US$0.00012)
{{FXConvert|BGD|10|po}} 0.1 (US$0)
{{FXConvert|BGD|1|po|exact=source}} 0.01 (US$0)
{{FXConvert|BGD|10|po|exact=source}} 0.1 (US$0)
{{FXConvert|BGD|1|po|exact=on}} 0.01 (US$0)
{{FXConvert|BGD|1|po|exact=on|r=5}} 0.01 (US$0.00012)
{{FXConvert|BGD|10|po|exact=on}} 0.1 (US$0)
{{FXConvert|BGD|1|po|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|BGD|10|po|year=2002}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|BGD|1|po|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|BGD|10|po|year=2002|lk=on}} 0.1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|BGD|1|po|year=2002|index=BD}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2022" in 2022)[9]
{{FXConvert|BGD|1|po|year=2002|index=BD|r=5}} 0.01 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2022" in 2022)[9]
{{FXConvert|BGD|10|po|year=2002|index=BD}} 0.1 (2002) (equivalent to FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2022" in 2022)[9]
{{FXConvert|BGD|1|po|year=2002|index=BD|exact=on}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index. or US$Template:To USD/data/2,022 in 2022)[9]
{{FXConvert|BGD|1|po|year=2002|index=BD|exact=on|r=5}} 0.01 (2002) (equivalent to Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index. or US$Template:To USD/data/2,022 in 2022)[9]
{{FXConvert|BGD|10|po|year=2002|index=BD|exact=on}} 0.1 (2002) (equivalent to Error when using {{Inflation}}: |index=BD (parameter 1) not a recognized index. or US$Template:To USD/data/2,022 in 2022)[9]
{{FXConvert|OMN|1|ba|lk=on}} 0 (US$0)
{{FXConvert|OMN|1|ba|lk=on|r=5}} 0.001 (US$0.00263)
{{FXConvert|OMN|10|ba}} 0.01 (US$0.03)
{{FXConvert|OMN|1|ba|exact=source}} 0.001 (US$0)
{{FXConvert|OMN|10|ba|exact=source}} 0.01 (US$0.03)
{{FXConvert|OMN|1|ba|exact=on}} 0.001 (US$0)
{{FXConvert|OMN|1|ba|exact=on|r=5}} 0.001 (US$0.00263)
{{FXConvert|OMN|10|ba|exact=on}} 0.01 (US$0.03)
{{FXConvert|OMN|1|ba|year=2002}} 0 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|OMN|10|ba|year=2002}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|OMN|1|ba|year=2002|lk=on}} 0 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|OMN|10|ba|year=2002|lk=on}} 0.01 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1}} 1 (US$0.8)
{{FXConvert|CAN|1|k}} 1,000 (US$800)
{{FXConvert|CAN|1|m}} 1 million (US$800,000)
{{FXConvert|CAN|1|b|lk=on}} 1 billion (US$800 million)
{{FXConvert|CAN|1|t|lk=on}} 1 trillion (US$800 billion)
{{FXConvert|CAN|1|exact=source}} 1 (US$0.8)
{{FXConvert|CAN|1|k|exact=source}} 1,000 (US$800)
{{FXConvert|CAN|1|m|exact=source}} 1,000,000 (US$800,000)
{{FXConvert|CAN|1|b|exact=source}} 1,000,000,000 (US$800 million)
{{FXConvert|CAN|1|t|exact=source}} 1,000,000,000,000 (US$800 billion)
{{FXConvert|CAN|1|exact=on}} 1 (US$0.8)
{{FXConvert|CAN|1|k|exact=on}} 1,000 (US$800)
{{FXConvert|CAN|1|m|exact=on}} 1,000,000 (US$800,000)
{{FXConvert|CAN|1|b|exact=on}} 1,000,000,000 (US$800,000,000)
{{FXConvert|CAN|1|t|exact=on}} 1,000,000,000,000 (US$800,000,000,000)
{{FXConvert|CAN|1|year=2002}} 1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|k|year=2002}} 1,000 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|m|year=2002}} 1 million (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|b|year=2002}} 1 billion (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|t|year=2002}} 1 trillion (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|year=2002|lk=on}} 1 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|k|year=2002|lk=on}} 1,000 (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|m|year=2002|lk=on}} 1 million (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|b|year=2002|lk=on}} 1 billion (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|1|t|year=2002|lk=on}} 1 trillion (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|IND|1|l|lk=on}} 1 lakh (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|c|lk=on}} 1 crore (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|lc|lk=on}} 1 lakh crore (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|l|exact=source}} 100,000 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|c|exact=source}} 10,000,000 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|lc|exact=source}} 1,000,000,000,000 (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|l|exact=on}} 100,000 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|1|c|exact=on}} 10,000,000 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|10|c|exact=on}} 100,000,000 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|1|lc|exact=on}} 1,000,000,000,000 (US$Expression error: Unrecognized punctuation character "[".)
{{FXConvert|IND|1|l|year=2002}} 1 lakh (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|c|year=2002}} 1 crore (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|lc|year=2002}} 1 lakh crore (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|l|year=2002|lk=on}} 1 lakh (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|c|year=2002|lk=on}} 1 crore (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|IND|1|lc|year=2002|lk=on}} 1 lakh crore (2002) (US$FXConvert/Wordify error: cannot parse value "Expression error: Unrecognized punctuation character "[".")
{{FXConvert|CAN|3.60}} 3.6 (US$2.88)
{{FXConvert|CAN|360}} 360 (US$288)
{{FXConvert|CAN|3600}} 3,600 (US$2,880)
{{FXConvert|CAN|360000}} 360,000 (US$288,000)
{{FXConvert|CAN|3600000}} 3.6 million (US$2.88 million)
{{FXConvert|CAN|3600000|index=CA}} 3.6 million (US$2.88 million)
{{FXConvert|CAN|3.6|m|index=CA}} 3.6 million (US$2.88 million)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}}} Template:CAD3.65 million (US$2.92 million)
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}}} Template:CAD3.65 million (US$2.92 million)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|index=CA}} Template:CAD3.65 million (US$2.92 million)
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|index=CA}} Template:CAD3.65 million (US$2.92 million)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=1900}} Template:CAD3.65 million (1900) (US$FXConvert/Wordify error: cannot parse value "Undefined year "1900"")
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=1900}} Template:CAD3.65 million (1900) (US$FXConvert/Wordify error: cannot parse value "Undefined year "1900"")
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=1900|exact=source}} Template:CAD3,650,000 (1900) (US$FXConvert/Wordify error: cannot parse value "Undefined year "1900"")
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=1900|exact=source}} Template:CAD3,650,000 (1900) (US$FXConvert/Wordify error: cannot parse value "Undefined year "1900"")
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=1900|force=yes}} Template:CAD3.65 million (1900) (US$2.92 million)
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=1900|force=yes}} Template:CAD3.65 million (1900) (US$2.92 million)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=1900|force=yes|exact=on}} Template:CAD3,650,000 (1900) (US$2,920,000)
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=1900|force=yes|exact=on}} Template:CAD3,650,000 (1900) (US$2,920,000)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=2002}} Template:CAD3.65 million (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=2002}} Template:CAD3.65 million (2002) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2002")
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=2002|exact=on}} Template:CAD3,650,000 (2002) (US$Template:To USD/data/2,002)
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=2002|exact=on}} Template:CAD3,650,000 (2002) (US$Template:To USD/data/2,002)
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=2002|index=CA}} Template:CAD3.65 million (2002) (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|infsign={{CAD}}|year=2002|index=CA}} Template:CAD3.65 million (2002) (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|infsign={{CAD}}|year=2002|index=CA|exact=source}} Template:CAD3,650,000 (2002) (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|year=2002|index=CA|exact=source}} Template:CAD3,650,000 (2002) (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|3650000|cursign={{CAD|link=yes}}|year=2002|index=CA|exact=on}} Template:CAD3,650,000 (2002) (equivalent to Template:CADError when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. or US$Expression error: Unexpected < operator. in 2021)[5]
{{FXConvert|CAN|3.65|m|cursign={{CAD|link=yes}}|infsign={{CAD}}|year=2002|index=CA|exact=on}} Template:CAD3,650,000 (2002) (equivalent to Template:CADError when using {{Inflation}}: |index=CA (parameter 1) not a recognized index. or US$Expression error: Unexpected < operator. in 2021)[5]
{{FXConvert|CAN|3600000|cursign={{CAD|link=yes}}|year=1962|index=CA|ref=<ref name="qv">http://www.westcoastferries.ca/ferries/bcferries/queenofvancouver.html</ref>}} Template:CAD3.6 million (1962)[10] (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|CAN|3600000|cursign={{CAD|link=yes}}|infsign={{CAD}}|year=1962|index=CA|ref=<ref name="qv">http://www.westcoastferries.ca/ferries/bcferries/queenofvancouver.html</ref><ref>something</ref>}} Template:CAD3.6 million (1962)[10][11] (equivalent to Template:CADFXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=CA (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Expression error: Unexpected < operator." in 2021)[5]
{{FXConvert|GBR|100000000|cursign=[[£]]|infsign=£|year=1962|index=UK|lk=original}} £100 million (1962) (equivalent to £2.27 billion or US$3.11 billion in 2021)[6]
{{FXConvert|GBR|100000000|cursign=[[£]]|infsign=£|year=1962|index=UK-GDP|lk=inflated}} £100 million (1962) (equivalent to £FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
{{FXConvert|GBR|100000000|cursign=[[£]]|infsign=£|year={{Inflation-year|UK}}|index=UK|lk=original}} £100 million (2021) (US$136.99 million)
{{FXConvert|GBR|100000000|cursign=[[£]]|year={{Inflation-year|UK-GDP}}|index=UK-GDP|lk=original}} £100 million (2019) (US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019")
{{FXConvert|GBR|1|lc|cursign=[[£]]|year=2002|index=UK-GDP|lk=source-converted}} £1 lakh crore (2002) (equivalent to £FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
{{FXConvert|GBR|1|lc|cursign=[[£]]|year=2002|index=UK-GDP|lk=source}} £1 lakh crore (2002) (equivalent to £FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
{{FXConvert|GBR|1|lc|cursign=[[£]]|year=2002|index=UK-GDP|lk=result}} £1 lakh crore (2002) (equivalent to £FXConvert/Wordify error: cannot parse value "Error when using {{Inflation}}: |index=UK-GDP (parameter 1) not a recognized index.
                                                                                                              " or US$FXConvert/Wordify error: cannot parse value "Template:To USD/data/2019" in 2019)[7]
  1. 1.0 1.1 1.2 1634–1699: McCusker, J. J. (1997). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States: Addenda et Corrigenda (PDF). American Antiquarian Society. 1700–1799: McCusker, J. J. (1992). How Much Is That in Real Money? A Historical Price Index for Use as a Deflator of Money Values in the Economy of the United States (PDF). American Antiquarian Society. 1800–present: Federal Reserve Bank of Minneapolis. "Consumer Price Index (estimate) 1800–". Retrieved May 28, 2023.
  2. 2.0 2.1 2.2 2.3 2.4 Johnston, Louis; Williamson, Samuel H. (2023). "What Was the U.S. GDP Then?". MeasuringWorth. Retrieved January 1, 2023. United States Gross Domestic Product deflator figures follow the Measuring Worth series.
  3. something3
  4. 4.0 4.1 4.2 4.3 1906 to 1911: Williamson J. (1999), Nominal Wage, Cost of Living, Real Wage and Land Rent Data for Korea 1906-1939 1912 to 1939: Mizoguchi, T. (1972). Consumer Prices and Real Wages in Taiwan and Korea Under Japanese Rule. Hitotsubashi Journal of Economics, 13(1), 40-56. Retrieved May 21, 2021. Afterwards, consumer price index from Statistics Korea. Consumer Price Index by year. Retrieved 3 April 2018
  5. 5.00 5.01 5.02 5.03 5.04 5.05 5.06 5.07 5.08 5.09 5.10 5.11 5.12 5.13 5.14 5.15 5.16 5.17 1688 to 1923: Geloso, Vincent, A Price Index for Canada, 1688 to 1850 (December 6, 2016). Afterwards, Canadian inflation numbers based on Statistics Canada tables 18-10-0005-01 (formerly CANSIM 326-0021) "Consumer Price Index, annual average, not seasonally adjusted". Statistics Canada. Retrieved April 17, 2021. and table 18-10-0004-13 "Consumer Price Index by product group, monthly, percentage change, not seasonally adjusted, Canada, provinces, Whitehorse, Yellowknife and Iqaluit". Statistics Canada. Retrieved April 17, 2021.
  6. 6.0 6.1 6.2 6.3 6.4 UK Retail Price Index inflation figures are based on data from Clark, Gregory (2017). "The Annual RPI and Average Earnings for Britain, 1209 to Present (New Series)". MeasuringWorth. Retrieved June 11, 2022.
  7. 7.0 7.1 7.2 7.3 7.4 7.5 7.6 7.7 United Kingdom Gross Domestic Product deflator figures follow the Measuring Worth "consistent series" supplied in Thomas, Ryland; Williamson, Samuel H. (2018). "What Was the U.K. GDP Then?". MeasuringWorth. Retrieved February 2, 2020.
  8. 8.0 8.1 8.2 8.3 8.4 8.5 1595 to 1872: Bob Allen, Prices and Wages in India, 1595-1930 1873 to 1919: Williamson J., Real Wages and Relative Factor Prices in the Third World 1820-1940: Asia. 2000, Appendix 2 Nominal Wage, Cost of Living and Real Wage Data for India 1873-1939 and Land Prices for the Punjab 1871-1939, 1920 to 1953: Coos Santing, 2007, Inflation 1800-2000, data from OECD, Organisation for Economic Co-operation and Development, Economic Outlook. Historical Statistics and Mitchell, B. R. International Historical Statistics, Africa, Asia and Oceania 1750-1993 London : Macmillan ; New York : Stockton, 1998, International Historical Statistics, Europe 1750-1993 London : Macmillan ; New York : Stockton, 1998, and International Historical Statistics, The Americas 1750-1993 London : Macmillan ; New York : Stockton, 1998, 1954 to 2023: Historic inflation India – CPI inflation, Inflation.eu, retrieved 8 July 2023
  9. 9.0 9.1 9.2 9.3 9.4 9.5 Bangladesh – Consumer price index, International Monetary Fund, International Financial Statistics and data files.[dubious ]
  10. 10.0 10.1 http://www.westcoastferries.ca/ferries/bcferries/queenofvancouver.html
  11. something

See also

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 in articles based on this TemplateData.

TemplateData for FXConvert

Template calculates a value of a currency, which you can enter, to another currency and then presents the results.

Template parameters

ParameterDescriptionTypeStatus
country code1 country

ISO 3166-1 alpha-3 country code of the currency to be converted, e.g. DEU (Germany, Euro since the year 2000).

Example
GBR
Linerequired
Value2

The value, in the source, that needs to be converted. The template will not accept pre-formatted values (i.e. 1,234).

Example
500000000
Numberrequired
Currency units3

Use this to represent larger numbers such as crores, billions et al.

Example
c, lc, b, m, k, cr, p, pa, po, ba
Linesuggested
Currency codecur

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.

Example
FRF, EUR
Lineoptional
Currency signcursign

This provides a currency sign for the original and inflated (without conversion) values. If the argument is not present they will be shown without one.

Example
[[£]]
Contentsuggested
Inflated signinfsign

This provides a currency sign for the inflated (without conversion) value. If the argument is not present, cursign will be looked for.

Example
£
Contentoptional
Linkinglk

Gives option to whether link currency names (paise, etc.) or number names (crores, lakhs, billions, trillions)

Example
on, off, source, original, inflated, result, converted, source-converted
Linesuggested
Yearyear

This parameter allows for inflation. Historic values will be inflated to the most current values available then converted.

Example
2015
Numbersuggested
Indexindex

This parameter allows for inflation. Historic values will be inflated to the latest year available in Inflation then converted.

Example
UK-GDP
Lineoptional
Toto

This parameter allows for conversion to various different currencies. The USD (default) and the euro are currently supported.

Default
USD
Example
EUR
Unknownoptional
Rounding digitsr

Used to round significant digits. A value of "0" will drop paise or cent values from the converted number. By default the conversion will be rounded to two significant figures.

Example
0
Numberoptional
Forceforce

This parameter allows to force a conversion at the most current rate available when data is lacking for the provided year when its value is "yes".

Example
yes
Lineoptional
Exactexact

This provides some control over formatting. "source" requests to display the input value normally (in American fashion) after applying the units. "on" does this for both the input and result values. Otherwise all values will be displayed as per Format price.

Example
source, on
Lineoptional
Show dateshowdate

This allows to disable displaying the original year.

Example
no
Lineoptional
Referencesref

This allows displaying one or more references next to the original value. Each one must consist of a ref wikitext element.

Example
<ref>some wikitext ref</ref>
Contentsuggested
Modemode

This parameter allows for the control of the output mode. Currently, blank (default) and historical are supported. In historical mode, conversions are performed using a historical exchange rate, for the year supplied.

Default
(blank)
Example
historical
Lineoptional
Convertconvert

This parameter controls the currency conversion. Setting it to blank or omitting it results in the default mode. Setting it to <code>no</code> disables it.

Default
(blank)
Example
no
Lineoptional