This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

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 сентябрь 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® 2026 Internationalization API Specification
# sec-intl.numberformat.prototype.format

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

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