Jump to content

Template:Exchange rates/doc

From Wikivoyage

This template displays currency exchange rates for one or more currencies as shown in the example below. It should only be used on country articles, and should be placed in the "Buy" section of those articles.

Template parameters

[edit]

To use this template, invoke it with the following arguments:

currency (Required)
The name of the currency being converted. Example: "Belizean dollars".
currencyCode
or
currencyCodeAfter (Required)
The currency symbol for the currency being converted. Example: "BZ$".
date (Required)
The month on which the currency conversion values were obtained. Example: "January 2017".
source (Required)
The source where the currency conversion information was obtained from. Example: "[http://www.xe.com/currency/bzd-belizean-dollar XE.com]".
USD (Optional)
The conversion rate for one US dollar into the currency being converted. Example: "2".
EUR (Optional)
The conversion rate for one Euro into the currency being converted. Example: "2.5".
GBP (Optional)
The conversion rate for one British pound into the currency being converted. Example: "2.1".
AUD (Optional)
The conversion rate for one Australian dollar into the currency being converted. Example: "1.6".
CAD (Optional)
The conversion rate for one Canadian dollar into the currency being converted. Example: "1.5".
NZD (Optional)
The conversion rate for one New Zealand dollar into the currency being converted. Example: "1.5".
JPY (Optional)
The conversion rate for 100 Japanese yen into the currency being converted. Example: "1.7".
CHF (Optional)
The conversion rate for one Swiss franc into the currency being converted. Example: "1.7".
CNY (Optional)
The conversion rate for one Chinese yuan (reminbi) into the currency being converted. Example: "0.15".
INR (Optional)
The conversion rate for 100 Indian rupees into the currency being converted. Example: "0.15".
HKD (Optional)
The conversion rate for one Hong Kong dollar into the currency being converted. Example: "0.15".
SGD (Optional)
The conversion rate for one Singapore dollar into the currency being converted. Example: "0.15".
MYR (Optional)
The conversion rate for one Malaysian ringgit into the currency being converted. Example: "0.15".
THB (Optional)
The conversion rate for 10 Thai baht into the currency being converted. Example: "1.50".
ZAR (Optional)
The conversion rate for one South African rand into the currency being converted. Example: "0.15".
IDR (Optional)
The conversion rate for 10,000 Indonesian rupiah into the currency being converted. Example: "0.15".
PHP (Optional)
The conversion rate for 100 Philippine pesos into the currency being converted. Example: "0.15".
DKK (Optional)
The conversion rate for one Danish krone into the currency being converted. Example: "10".
SEK (Optional)
The conversion rate for one Swedish krone into the currency being converted. Example: "30".
NOK (Optional)
The conversion rate for one Norwegian krone into the currency being converted. Example: "0.65".
SAR (Optional)
The conversion rate for one Saudi riyal into the currency being converted. Example: "3.65".
VND (Optional)
The conversion rate for 10,000 Vietnamese dong into the currency being converted. Example: "0.40".
KRW (Optional)
The conversion rate for 10,000 South Korean won into the currency being converted. Example: "1.50".
TWD (Optional)
The conversion rate for 10 New Taiwan dollars into the currency being converted. Example: "2.00".

Examples

[edit]
{{exchange rates
| currency=Belizean dollars
| currencyCode=BZ$
| date=January 2017
| USD=2 (fixed rate)
| EUR=2.5
| GBP=2.1
| AUD=1.6
| CAD=1.5
| JPY=1.74
| ZAR=0.15
| source=[http://www.xe.com/currency/bzd-belizean-dollar XE.com]
}}
{{exchange rates/sandbox
| currency=Croatian kuna
| currencyCode=
| currencyCodeAfter= kn
| date=January 2018
| USD=6.2
| EUR=7.5
| GBP=8.4
| TRY=0.75
| source=[http://www.xe.com/currency/hrk-croatian-kuna XE.com]
}}

...which produces:

Exchange rates for Belizean dollars

As of January 2017:

  • US$1 ≈ BZ$2 (fixed rate)
  • €1 ≈ BZ$2.5
  • UK£1 ≈ BZ$2.1
  • AU$1 ≈ BZ$1.6
  • CA$1 ≈ BZ$1.5
  • Japanese ¥100 ≈ BZ$1.74
  • South African R1 ≈ BZ$0.15

Exchange rates fluctuate. Current rates for these and other currencies are available from XE.com

Exchange rates for Croatian kuna ( kn)

As of January 2018:

  • US$1 ≈ 6.2 kn
  • €1 ≈ 7.5 kn
  • UK£1 ≈ 8.4 kn


Notes for template use

[edit]
  • It is easy to update this template: click on the XE.Com link in the template to go to a web page with current rates for the currency.
    • Wikivoyage does not endorse XE.com—you can use another source for rates if you prefer, just be sure to identify your source in the template.
  • When updating the rates shown in the template, be sure to change the "as of" date too.
  • To avoid clutter, only major currencies should normally be used: US dollars, euros and British pounds.
  • In some cases, it may be appropriate to add other currencies where a country may receive a lot of visitors from nearby countries, e.g.,
    • Canadian tourists in Mexico and the Caribbean,
    • Chinese and Japanese in East Asia,
    • Australians in Southeast Asia and the Pacific,
    • Indians in South Asia,
    • South Africans in southern Africa, and
    • Turkish in Europe and Middle East

See also

[edit]
  • {{exchange rate euros}} – Shared template for Eurozone currency conversions.
  • {{Exchange rate AUD}} – Shared template for Australian dollar currency conversions (for external territories and various Pacific islands).
  • {{exchange rate CFA}} – Shared template for West and Central African CFA franc currency conversions.
  • {{exchange rate EC}} – Shared template for East Caribbean dollar currency conversions.
  • {{exchange rate US}} – Shared template for US dollar currency conversions.
  • {{Exchange rate GBP}} – Shared template for British pound currency conversions (for overseas territories).
  • {{Exchange rate NZD}} – Shared template for New Zealand dollar currency conversions (for various Pacific islands).