Intl.NumberFormat.prototype.format()

Intl.NumberFormat.prototype.format() メソッドは、この NumberFormat オブジェクトのロケールと整形オプションに従って数値を整形します。

構文

numberFormat.format(number)

引数

number
整形する Number または BigInt です。

解説

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 руб."

formatmap の使用

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"

仕様書

仕様書
ECMAScript Internationalization API 4.0 (ECMA-402)
Intl.NumberFormat.prototype.format の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
formatChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 ≤37Chrome Android 完全対応 26Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明

関連情報