JavaScript Number.toLocaleString()Метод
Пример
Форматирование строки с использованием локальных настроек:
let num1 = 1000000;
let text1 = num1.toLocaleString();
//Форматировать число как строку с использованием указанной локали
let num2 = 1000000;
let text2 = num2.toLocaleString("fi-FI");
//Форматировать число как строку в формате валюты с использованием указанной локали
//Юань
let num3 = 1000000;
let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"});
//Доллар США
let num4 = 1000000;
let text4 = num4.toLocaleString("en-US", {style:"currency", currency:"USD"});
Попробуйте сами »
Определение и использование
Метод toLocaleString() возвращает строковое представление числа в определённой локали.
Новые параметры locales и options позволяют приложению указать язык для форматирования и настроить поведение функции. В старых реализациях параметры locales и options игнорируются, а используемая локаль и форма возвращаемой строки полностью зависят от реализации.
Поддержка браузеров
Number.toLocaleString() — это возможность ECMAScript3 (ES3).
Все браузеры поддерживают ES3 (JavaScript 1999).
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Да | Да | Да | Да | Да | Да |
Поддерживается во всех последних версиях браузеров(locales, options)Параметры:
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Да | 11 | Да | Да | Да | Да |
Синтаксис
number.toLocaleString(locales, options)
Значения параметров
| Параметр | Описание |
|---|---|
| locales | Необязательно. Объект форматирования, может быть:ar-SA Арабский (Саудовская Аравия)bn-BD Бенгальский (Бангладеш)bn-IN Бенгальский (Индия)cs-CZ Чешский (Чешская Республика)da-DK Датский (Дания)de-AT Австрийский немецкийde-CH "Швейцарский" немецкийde-DE Стандартный немецкийel-GR Современный греческийen-AU Австралийский английскийen-CA Канадский английскийen-GB Британский английскийen-IE Ирландский английскийen-IN Индийский английскийen-NZ Новозеландский английскийen-US Американский английскийen-ZA Английский (Южная Африка)es-AR Аргентинский испанскийes-CL Чилийский испанскийes-CO Колумбийский испанскийes-ES Кастильский испанский (используется в северо-центральной Испании)es-MX Мексиканский испанскийes-US Латиноамериканский испанскийfi-FI Финский (Финляндия)fr-BE Бельгийский французскийfr-CA Канадский французскийfr-CH "Швейцарский" французскийfr-FR Стандартный французский (во Франции)he-IL Иврит (Израиль)hi-IN Хинди (Индия)hu-HU Венгерский (Венгрия)id-ID Индонезийский (Индонезия)it-CH "Швейцарский" итальянскийit-IT Стандартный итальянский (используется в Италии)ja-JP Японский (Япония)ko-KR Корейский (Южная Корея)nl-BE Бельгийский нидерландскийnl-NL Стандартный нидерландскийno-NO Норвежский (Норвегия)pl-PL Польский (Польша)pt-BR Бразильский португальскийpt-PT Европейский португальскийro-RO Румынский (Румыния)ru-RU Русский (Российская Федерация)sk-SK Словацкий (Словакия)sv-SE шведский (Швеция)ta-IN тамильский (Индия)ta-LK тамильский (Шри-Ланка)th-TH тайский (Таиланд)tr-TR турецкий (Турция)zh-CN Материковый Китай, упрощенный китайскийzh-HK Гонконг, традиционный китайскийzh-TW Тайвань, традиционный китайский |
| options | Необязательно. Может быть:
|
Возвращаемое значение
| Type | Описание |
|---|---|
| String | Возвращает строковое представление в локали. |
Технические детали
| Версия JavaScript: | ECMAScript 6 |
|---|
Другие примеры
Пример
Используйте необязательные параметры для форматирования строки валюты:
let num1 = new Number(1000000);
const myObj = {
style: "currency",
currency: "EUR"
}
let text1 = num1.toLocaleString("en-GB", myObj);
let num2 = new Number(1000000);
let text2 = num2.toLocaleString("en-GB", {style:"currency", currency:"EUR"});
//RMB
let num3 = 1000000;
let text3 = num3.toLocaleString("zh-CN", {style:"currency", currency:"CNY"});
//японская иена
let num4 = 1000000;
let text4 = num4.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});
Попробуйте сами »
Объект JavaScript Number