Skip to content

Latest commit

 

History

History
164 lines (117 loc) · 4.22 KB

currency-formatter.md

File metadata and controls

164 lines (117 loc) · 4.22 KB
Raw

.currencyFormatter( currency [, options] ) ➜ function( value )

Return a function that formats a currency according to the given options or locale's defaults.

The returned function is invoked with one argument: the Number value to be formatted.

Parameters

currency

3-letter currency code as defined by ISO 4217, eg. USD.

options Optional

A JSON object including none or any of the following options.

style Optional

String symbol (default), accounting, code or name.

See .numberFormatter( [options] ) for more options.

value

Number to be formatted, eg. 9.99.

Example

Prior to using any currency methods, you must load cldr/main/{locale}/currencies.json, cldr/supplemental/currencyData.json, and the CLDR content required by the number module. If using plural messages, you also must load the CLDR content required by the plural module. Read CLDR content if you need more information.

You can use the static method Globalize.currencyFormatter(), which uses the default locale.

var formatter;

Globalize.locale( "en" );
formatter = Globalize.currencyFormatter( "USD" );

formatter( 9.99 );
// > "$9.99"

You can use the instance method .currencyFormatter(), which uses the instance locale.

var deFormatter = Globalize( "de" ).currencyFormatter( "EUR" ),
  zhFormatter = Globalize( "zh" ).currencyFormatter( "EUR" );

deFormatter( 9.99 );
// > "9,99 €"

zhFormatter( 9.99 );
// > "€ 9.99"

For comparison, follow the formatting output of different symbols in different locales.

3-letter currency code en (English) de (German) zh (Chinese)
.currencyFormatter( "USD" )( 1 ) $1.00 1,00 $ US$ 1.00
.currencyFormatter( "EUR" )( 1 ) €1.00 1,00 € € 1.00
.currencyFormatter( "CNY" )( 1 ) CN¥1.00 1,00 CN¥ ￥ 1.00
.currencyFormatter( "JPY" )( 1 ) ¥1 1 ¥ JP¥ 1
.currencyFormatter( "GBP" )( 1 ) £1.00 1,00 £ £ 1.00
.currencyFormatter( "BRL" )( 1 ) R$1.00 1,00 R$ R$ 1.00

For the accounting variation of the symbol format, use style: "accounting".

var formatter = Globalize( "en" ).currencyFormatter( "USD", {
  style: "accounting"
});

formatter( -1 );
// > "($1.00)"

For plural messages, use style: "name".

var formatter = Globalize( "en" ).currencyFormatter( "USD", {
  style: "name"
});

formatter( 0 );
// > "0.00 US dollars"

formatter( 1 );
// > "1.00 US dollar"

For comparison, follow the formatting output of different symbols in different locales using the plural messages Globalize( locale ).currencyFormatter( currency, { style: "name" } )( 1 ).

3-letter currency code en (English) de (German) zh (Chinese)
USD 1.00 US dollar 1,00 US-Dollar 1.00美元
EUR 1.00 euro 1,00 Euro 1.00欧元
CNY 1.00 Chinese yuan 1,00 Chinesischer Yuan 1.00人民币
JPY 1 Japanese yen 1 Japanischer Yen 1日元
GBP 1.00 British pound sterling 1,00 Britisches Pfund Sterling 1.00英镑
BRL 1.00 Brazilian real 1,00 Brasilianischer Real 1.00巴西雷亚尔

For the international currency code, use style: "code".

var formatter = Globalize( "en" ).currencyFormatter( "USD", {
  style: "code"
});

formatter( 9.99 );
// > "9.99 USD"

Override the number of digits, grouping separators, rounding function or any other .numberFormatter() options.

var formatter;

Globalize.locale( "en" );
formatter = Globalize.currencyFormatter( "USD", {
  minimumFractionDigits: 0,
  style: "name"
});

formatter( 1 );
// > "1 US dollar"

formatter = Globalize.currencyFormatter( "USD", {
  round: "ceil"
});

formatter( 1.491 );
// > "$1.50"

For improved performance on iterations, first create the formatter. Then, reuse it on each loop.

var formatter = Globalize( "en" ).currencyFormatter( "USD" );

renderInvoice({
  prices: prices.map(function( price ) {
    return formatter( price );
  })
});