Intl.NumberFormat

Intl.NumberFormatは、言語にともなう数値のフォーマットが整えられるオブジェクトです。

構文

new Intl.NumberFormat([locales[, options]])
Intl.NumberFormat.call(this[, locales[, options]])

引数

locales

省略可能。BCP47言語タグをもつ文字列、またはそのような文字列の配列。locales引数の一般的な形式と解釈については、Intl pageをご参照ください。つぎのUnicode拡張キーが受け入れられます。

nu
用いられる番号方式。使える値はつぎのとおりです。"arab", "arabext", "bali", "beng", "deva", "fullwide", "gujr", "guru", "hanidec", "khmr", "knda", "laoo", "latn", "limb", "mlym", "mong", "mymr", "orya", "tamldec", "telu", "thai", "tibt".
options

省略可能。つぎのプロパティの一部またはすべてを備えるオブジェクト。

localeMatcher
使用するローケルマッチングアルゴリズム。使える値は"lookup"か"best fit"で、デフォルトが"best fit"です。このオプションについて詳しくは、Intl pageをご参照ください。
style
使用するフォーマットスタイル。使える値は基本の数値フォーマットが"decimal"、通貨フォーマットは"currency"、パーセントのフォーマットには"percent"が選べます。デフォルトは"decimal"です。
currency
使用する通貨のフォーマット。使える値はISO 4217通貨コードで、たとえば"USD"は米国ドル、"EUR"が欧州ユーロ、"CNY"なら中国人民元を示します(「Current currency & funds code list」参照)。デフォルト値はありません。したがって、styleが"currency"の場合、currencyプロパティは必須です。
currencyDisplay
通貨フォーマットにおける通貨の表示。使える値は3つで、"symbol"が€などの各地域の通貨記号、"code"はISO通貨コード、"name"は"dollar"のような通貨名を表示します。デフォルトは"symbol"です。
useGrouping
桁区切りを使うかどうか。3桁ごと、あるいはthousands/lakh/croreで区切り文字を加えます。値はtrueかfalseで、デフォルトはtrueです。

つぎのプロパティはふたつのグループに分かれます。第1に、minimumIntegerDigitsとminimumFractionDigitsおよびmaximumFractionDigitsです。第2は、残りのminimumSignificantDigitsとmaximumSignificantDigitsになります。第2のグループからプロパティをひとつでも定めると、第1グループは無視されます。

minimumIntegerDigits
整数に使用する最小桁数。使える値は1から21までです。デフォルトは1です。
minimumFractionDigits
小数に使用する最小桁数。使える値は0から20までです。デフォルトは、基本数値とパーセントのフォーマットが1で、通貨フォーマットはISO 4217 currency code listが提供する「minor unit」の桁数(情報のない場合は2)です。
maximumFractionDigits
小数に使用する最大桁数。使える値は0から20までです。デフォルトは、基本数値フォーマットがminimumFractionDigitsか3のうち大きい値で、通貨フォーマットはminimumFractionDigitsとISO 4217 currency code listが提供する「minor unit」の桁数(情報のない場合は2)のうち大きい値、パーセントフォーマットではminimumFractionDigitsか0のうち大きい値です。
minimumSignificantDigits
使用する有効数字の最小桁数。使える値は1から21までです。デフォルトは1です。
maximumSignificantDigits
使用する有効数字の最大桁数。使える値は1から21までです。デフォルトはminimumSignificantDigitsの値です。

説明

プロパティ

Intl.NumberFormat.prototype
プロパティをすべてのオブジェクトに加えられます。

メソッド

Intl.NumberFormat.supportedLocalesOf()
提供されたロケールのうち、実行時のデフォルトロケールにフォールバックせずにサポートされるものを配列に納めて返します。

NumberFormatインスタンス

プロパティ

NumberFormatインスタンスは、つぎのプロパティをプロトタイプから継承します。

Intl.NumberFormat.prototype.constructor
Intl.NumberFormatへの参照
Intl.NumberFormat.prototype.format
ゲッター。ローケルに応じて、このNumberFormatオブジェクトのオプションを持つ数値をフォーマットする関数を返します。

メソッド

NumberFormatインスタンスは、つぎのメソッドをプロトタイプから継承します。

Intl.NumberFormat.prototype.resolvedOptions()
ローケルを反映しているプロパティとオブジェクトの初期化中に計算された照合オプションをもった新しいオブジェクトを返します。

例

基本的な使い方

ローケルを指定しない基本的な使い方では、デフォルトのローケルとオプションでフォーマットされた文字列が返されます。

var number = 3500;

console.log(new Intl.NumberFormat().format(number));
// → '3,500' 英語(U.S.)ロケールの場合

localesを使う

この例では、地域による数値フォーマットの違いをいくつか紹介します。アプリケーションのユーザーインタフェースで使われた言語フォーマットを得るには、言語(およびフォールバック言語)をlocales引数により指定してください。

var number = 123456.789;

// ドイツではカンマを小数、ピリオドを千単位の区切りに用います
console.log(new Intl.NumberFormat('de-DE').format(number));
// → 123.456,789

// ほとんどのアラビア語圏ではアラビア数字を用います
console.log(new Intl.NumberFormat('ar-EG').format(number));
// → ١٢٣٤٥٦٫٧٨٩

// インドではthousands/lakh/crore区切りが用いられます
console.log(new Intl.NumberFormat('en-IN').format(number));
// → 1,23,456.789

// nu拡張キーにより漢数字などの番号方式が使えます
console.log(new Intl.NumberFormat('zh-Hans-CN-u-nu-hanidec').format(number));
// → 一二三,四五六.七八九

// バリ語のようにサポートされないかもしれない言語を用いる場合は
// フォールバック言語を含めます(つぎの例ではインドネシア語)
console.log(new Intl.NumberFormat(['ban', 'id']).format(number));
// → 123.456,789

optionsを使う

options引数を使うと結果がカスタマイズできます。

var number = 123456.789;

// 通貨フォーマットを用います
console.log(new Intl.NumberFormat('de-DE', { style: 'currency', currency: 'EUR' }).format(number));
// → 123.456,79 €

// 日本円にはminor unitがありません
console.log(new Intl.NumberFormat('ja-JP', { style: 'currency', currency: 'JPY' }).format(number));
// → ￥123,457

// 有効数字を3桁に狭めます
console.log(new Intl.NumberFormat('en-IN', { maximumSignificantDigits: 3 }).format(number));
// → 1,23,000

仕様

仕様 状況 コメント
ECMAScript Internationalization API 1.0 (ECMA-402)
Intl.NumberFormat の定義		 標準 初期定義
ECMAScript Internationalization API 2.0 (ECMA-402)
Intl.NumberFormat の定義		 標準  
ECMAScript Internationalization API (ECMA-402)
Intl.NumberFormat の定義		 現行の標準  

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
NumberFormatChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?
NumberFormat() constructorChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?
formatChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?
formatToParts
実験的
Chrome 完全対応 64Edge 完全対応 12Firefox 完全対応 58IE 未対応 なしOpera 完全対応 51Safari 完全対応 13WebView Android 完全対応 64Chrome Android 完全対応 64Firefox Android 完全対応 58Opera Android 完全対応 47Safari iOS 完全対応 13Samsung Internet Android 完全対応 9.0nodejs ?
resolvedOptionsChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?
supportedLocalesOfChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。

関連情報

関連トピック
  1. Standard built-in objects
  2. NumberFormat
  3. メソッド
    1. Intl.NumberFormat.prototype.format()
    2. Intl.NumberFormat.prototype.formatToParts()
    3. Intl.NumberFormat.prototype.resolvedOptions()
    4. Intl.NumberFormat.supportedLocalesOf()
  4. 関連するページ
  5. Intl
  6. Collator
  7. DateTimeFormat
  8. ListFormat
  9. PluralRules
  10. RelativeTimeFormat
  11. 継承
  12. Function
  13. プロパティ
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
  14. メソッド
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  15. Object
  16. プロパティ
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  17. メソッド
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()