Intl.NumberFormat.prototype.format

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Сводка

Свойство Intl.NumberFormat.prototype.format возвращает функцию-геттер, форматирующую число согласно локали и параметрам форматирования соответствующего объекта NumberFormat.

Синтаксис

numberFormat.format(number)

Параметры

number

Число для форматирования.

Описание

Функция, возвращённая геттером format, форматирует число согласно локали и параметрам форматирования соответствующего объекта NumberFormat.

Примеры

Пример: использование функции format

Использование функции, возвращённой геттером format, для форматирования одного значения валюты, здесь пример для русского языка:

js
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 напрямую.

js
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"

Спецификации

Specification
ECMAScript Internationalization API Specification
# sec-intl.numberformat.prototype.format

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также