JavaScript метод Number.toLocaleString()
Определение и применение
JavaScript метод toLocaleString() преобразует числовое значение (объект Number) в строковое и возвращает это значение, используя текущий или указанный языковой стандарт.
Поддержка браузерами
Спецификации: ecma262, ecma402
Поддерживается во всех основных браузерах с 2015 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
 Chrome |  Edge |  Firefox |  Opera |  Safari | Chrome Android | Firefox for Android | Opera Android |  Safari on iOS |  Samsung Browser |  WebView Android | WebView on iOS | |
toLocaleString | 1 | 12 12 Примечание MDN (англ.) Before Edge 18, numbers are rounded to 15 decimal digits. For example, | 1 | 4 | 1 | 18 | 4 | 10.1 | 1 | 1.0 | 4.4 | 1 |
| locales parameter | 24 | 12 | 29 | 15 | 10 | 26 | 56 | 14 | 10 | 1.5 | 4.4 | 10 |
| options parameter | 24 | 12 | 29 | 15 | 10 | 26 | 56 | 14 | 10 | 1.5 | 4.4 | 10 |
поддерживается с ограничениями нет поддержки нет данных≤31 — не позднее версии 31
JavaScript синтаксис:
JavaScript
// используя текущий языковой стандарт
num.toLocaleString();
// используя указанный языковой стандарт
num.toLocaleString( locales );
// используя указанный языковой стандарт с дополнительными настройками
num.toLocaleString( locales, options );
Версия JavaScript
1.1Значения параметров
| Параметр | Описание |
|---|---|
| locales | Параметр должен быть строкой, содержащей языковой тег BCP 47, или массивом таких языковых тегов. Если параметр не указан или не определен, используется языковой стандарт среды выполнения JavaScript по умолчанию. При указании нескольких строк языкового стандарта следует перечислять их в порядке убывания приоритета, чтобы первая запись была предпочитаемым языковым стандартом. Необязательный параметр. Языковой тег BCP 47 определяет язык и минимально содержит код основного языка. В своем наиболее распространенном виде он может содержать по порядку: код языка, код скрипта и код страны или региона, разделенные дефисами. Хотя тег не чувствителен к регистру, рекомендуется использовать заглавные буквы для кода скрипта, верхний регистр для кода страны и региона, а строчный регистр для всего остального. |
| options | Необязательный параметр, который содержит объект со свойствами, определяющими параметры сравнения:
Следующие свойства можно разделить на две группы: свойства minimumIntegerDigits, minimumFractionDigits и maximumFractionDigits в одной группе, minimumSignificantDigits и maximumSignificantDigits в другой группе. Если определено хотя бы одно свойство из второй группы, то первая группа игнорируется.
|
Пример использования
JavaScript
var num = 123456; // инициализируем числовую переменную
var options1 = { style: "percent" }; // определяем объект со свойствами, определяющими параметры сравнения
var options2 = { style: "currency", // определяем объект со свойствами, определяющими параметры сравнения
currency: "EUR" };
num.toLocaleString( "de-DE" ); // Возвращаемое значение "123.456" (German)
num.toLocaleString( "en-IN" ); // Возвращаемое значение "1,23,456" (India)
num.toLocaleString( "zh-Hans-CN-u-nu-hanidec" ); // Возвращаемое значение "一二三,四五六" (Chinese)
num.toLocaleString( "en-US", options1); // "12,345,600%"
num.toLocaleString( undefined, options1); // "12 345 600 %" (текущий язык сценария)
num.toLocaleString( "en-US", options2); // "€123,456.00"
num.toLocaleString( undefined, options2); // "123 456,00 €" (текущий язык сценария)