Each currency code such as USD or EUR can be represented in several ways, as given in the table below. Be sure to look at the international symbol to see which currency is being translated. For example, the English examples below are for USD. The Symbol and International code will be used in number patterns, as shown in the Examples of Usage. For more information, see Number Patterns.
||Examples of Usage
|This is to be most commonly understood currency designator next to an
amount for this currency in your locale. For example, the localized
value of Canadian dollars in US English would likely be "CA$". Showing
Swedish krona in Sweden would be "kr", but showing Danish krona in
Sweden would be "Dkr", to distinguish it from the Swedish counterpart.
The reversed may be used in Danish. Meanwhile showing Bermudan dollar in
Sweden, using ISO code "BMD" might be better than "$BM" since it's not a
commonly referenced currency. This is an area where you need to think
localization, more than translation.
Note: It does not need to be consistently ISO codes. (A developer who
wants a list of ISO codes can get those elsewhere in CLDR, no need to
"translate" those.) This is meant for showing an amount with a commonly
recognizable and understandable currency designation.
- Never use the same symbol for two different currencies. If "$" is used for USD, it cannot also be used for AUD.
- This is one of the areas where the country matters. USD is $ in the default English (which is US), and other dollar symbols are qualified (AU$, C$, ...). However, in en-AU (Australian English), the choices are switched: $ is AUD, and USD is US$.
|Symbol-narrow||DKK||kr || 12,345.68 kr ||This is an opportunity to provide an even shorter symbol for a currency. When using narrow currency symbols, it it assumed that the context is well known, so it is not necessary for the narrow currency symbol to be unique.
In the example of where Swedish used "Dkr" for Danish krona above, you
may use this field for just "kr", and assume that context in its usage
will make up for the lack of distinction.|
Note: It can be the same as currency-symbol. Many languages use € for
Euro in both fields. That's OK if that best represents common usage.
|International symbol used in formatting currency amounts. Normally, this is not under translator control, so you won't even see these presented for translation, but they can be specified by the programmer.
||Dollar des États-Unis
||Descriptive name of the currency. This form is targeted for use in menus, and thus should be titlecase (first-letter capitalized). It should be the most neutral grammatical form for your language, appropriate for menus. Typically this is nominative singular, but the conventions may be different for your language.
1 US dollar
2 US dollars
|1 US dollar
2 US dollars
|Different forms based on plurals used in your language. In this latter case, the items will not appear in menus, and don't need to be capitalized (except for words that require that in your language). See Plurals.
Note: in some cases, the English currency symbol may appear as box, typically because you don't have fonts for all of the characters. This is especially the case for the just-added Indian Rupee symbol (₹), which looks like the following:
Currency names must be unique; the same name can't be used for two different currency codes. When a country replaces a currency, it will get a new code. It will either reuse the name (and the old name needs to be modified), or use a new name. To find out details, go to Detailed Territory-Currency Information to see what currencies are, and which countries they are used in. You can search for the code in square brackets, such as for [MZN] (for Mozambian Metical). A currency is current if it has "∞" in the To column for some country.
- For a current currency, use the most common name, such as Mozambian Metical.
- For an obsolete currencies:
- It may be known by a different name, like Mozambican Escudo. Then there is no problem.
- If it has the same name as some current currency, include a date range, like Mozambian Metical (1980-2006)
SymbolsThe following general guidelines are used for currency symbols. These guidelines are also subject to the CLDR Currency Process.
These are only general guidelines, and may need to be overridden in particular cases. Certain symbols like the dollar sign are particularly tricky, because they are used by a great many countries.
- If a symbol is not widely recognized around the world (eg shekel ₪)
- Where the currency is official in a country, use that symbol in locales with that country (eg IL)
- Where the currency would be widely recognized by users of a language, use it in the base language locale (eg he/iw).
- Otherwise, use the international currency symbol (eg ILS). This can be done just by omitting the translation.
- Otherwise the symbol is widely recognized. If the symbol is used for only one currency (eg €) or widely recognized as being a given currency (eg £):
- Use that symbol in root.
- If it wouldn't be recognized in particular countries or among particular language users, in those locales/countries use the international currency code (eg EUR) or another replacement (see below). These other symbols have to be listed explicitly, so that they override root.
- Otherwise the symbol is used for multiple currencies, so
- Use the symbol in the countries that have it as an official currency symbol
- Use the symbol in languages where it there is a well-established general understanding that it would mean a particular currency.
- Otherwise, typically use international currency code or ("region-code" + symbol) or (symbol + "region-code") (the region is usually a country, but sometimes not) so that it is not ambiguous.