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

format と map の使用

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 (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 ?

凡例

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

関連情報

関連トピック
  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()