Intl.NumberFormat.prototype.format

概要

ローケルに応じて、このNumberFormatオブジェクトのオプションをもった数値をフォーマットするゲッター関数を返します。

構文

numberFormat.format(number)

引数

number

フォーマットする数値

説明

formatによって返される関数はローケルに応じて、このNumberFormatオブジェクトのオプションをもった文字列に数値をフォーマットします。

例

例: formatを使う

単一通貨値をフォーマットするためにformatによって返される関数を使って下さい。以下では ロシア:

var options = { style: 'currency', currency: 'RUB' };
var numberFormat = new Intl.NumberFormat('ru-RU', options);
console.log(numberFormat.format(654321.987));
// → "654 321,99 руб."

例: mapとともにformatを使う

配列内のすべての数値をフォーマットするためにformatによって返される関数を使って下さい。関数はNumberFormatにバインドされることに注意して下さい。というのも、直接Array.prototype.mapに渡されるからです。

var a = [123456.789, 987654.321, 456789.123];
var numberFormat = new Intl.NumberFormat('es-ES');
var formatted = a.map(numberFormat.format);
console.log(formatted.join('; '));
// → "123.456,789; 987.654,321; 456.789,123"

仕様

ブラウザ実装状況

関連情報

• Intl.NumberFormat
• Number.prototype.toLocaleString()