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.

* Some parts of this feature may have varying levels of support.

Сводка

Свойство 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® 2025 Internationalization API Specification
# sec-intl.numberformat.prototype.format

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
format
number param string value is decimal (not Number)

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

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