Intl.NumberFormat.prototype.format

このロケールの翻訳が存在しないため、英語バージョンのコンテンツを表示しています。 Help us translate this article!

ローケルに応じて、この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"

仕様

仕様 状況 コメント
ECMAScript Internationalization API 1.0 (ECMA-402)
Intl.NumberFormat.prototype.format の定義
標準 Initial definition.
ECMAScript Internationalization API 2.0 (ECMA-402)
Intl.NumberFormat.prototype.format の定義
標準  
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 完全対応 ありChrome Android 完全対応 26Firefox Android 完全対応 56Opera Android ? Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs ?

凡例

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

 

関連情報