Справочник JavaScript

Number.prototype.toLocaleString

Форматирует число по правилам языка: разделители разрядов, валюта, проценты.

Доступно с: ES3

Синтаксис

number.toLocaleString(locales, options)

Параметры

Параметр	Тип	Описание
locales	string	Необязательный. Язык и регион, например en-US или de-DE.
options	object	Необязательный. Настройки: style, currency, minimumFractionDigits и другие.

Возвращаемое значение

stringЧисло, отформатированное по правилам языка.

Примеры

Разделители разрядов в разных языках:

const n = 1234567.891;
 
console.log(n.toLocaleString('en-US'));
console.log(n.toLocaleString('de-DE'));

Результат:

1,234,567.891
1.234.567,891

Валюта и проценты:

console.log((1999.5).toLocaleString('en-US', { style: 'currency', currency: 'USD' }));
console.log((0.256).toLocaleString('en-US', { style: 'percent' }));

Результат:

$1,999.50
26%

Примечания

Без аргумента locales используется язык браузера пользователя, поэтому результат на разных компьютерах может отличаться. Для многократного форматирования быстрее создать один Intl.NumberFormat.

См. также

Intl.NumberFormat — Форматирует числа, валюты, проценты и единицы измерения по правилам языка.
Number.prototype.toFixed — Форматирует число с заданным количеством знаков после запятой.
Date.prototype.toLocaleString — Форматирует дату вместе со временем по правилам языка.

Вопросы и ответы по теме

В учебнике

Форматирование: Intl — Форматирование чисел, денег, дат и окончаний слов в JavaScript с учётом языка: toLocaleString, Intl.NumberFormat, Intl.DateTimeFormat и Intl.PluralRules.

Спасибо, что читаете!