Categories

jQuery.i18n.formatNumber()

Categories: Utilities | Internationalisation

jQuery.i18n.formatNumber( value, format, [ options ] )Returns: String

Plugin: jQuery.i18n

Description: Get a formated string from a Javascript Number object.

  • jQuery.i18n.formatNumber( value, format, [ options ] )

    version added: 1.0

    value   A Javascript Number object.

    format   A token string to specify the format.

    options   A set of key/value pairs that configure the i18n call. A default are set for any option by jQuery.i18n.settings.

The jQuery.i18n.formatNumber() method returns a formated string representing a number, currency or percent value from a Javascript Number object.

Tokens with default digits and example (en):
  • n Number 1,200.00, -1,200.00
  • c Currency $1,200.00, ($1,200.00)
  • p Percent 1,200.00 %, -1,200.00 %
Tokens with specified digits and example (en):
  • n0 Number 1,200
  • n1 Number 1,200.5
  • n2 Number 1,200.55
  • c0 Currency $1,200
  • c1 Currency $1,200.5
  • c2 Currency $1,200.55
  • p0 Percent 1,200 %
  • p1 Percent 1,200.5 %
  • p2 Percent 1,200.55 %
  • Get a formated number value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "n" );
    Results:
    1,200.55
  • Get a formated currency value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "c" );
    Results:
    $1,200.55
  • Get a formated percent value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "p" );
    Results:
    1,200.55 %
  • Get a german formated number value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "n", {region:'de-DE'} );
    Results:
    1.200,55
  • Get a german formated currency value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "c", {region:'de-DE'} );
    Results:
    1.200,55 Û
  • Get a german formated currency value with an other currency than the default from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "c", {region:'de-DE', currency: 'USD'} );
    Results:
    1.200,55 $
  • Get a german formated percent value from a Javascript Number object.

    Code:
    $.i18n.formatNumber( 1200.55, "p", {region:'de-DE'} );
    Results:
    1.200,55 %
  • currency

    version added: 1.0

    An other ISO 4217 three-letter uppercase currency code than the default of the selected region.

  • region

    version added: 1.0

    A combination of an ISO 639 two-letter lowercase culture code for the language (and a two-letter uppercase code for the country or region).

    Default: 'en'