JavaScript Number.toLocaleString()Метод

Number 对象参考手册Объект JavaScript Number

Пример

Форматирование строки с использованием локальных настроек:

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 Необязательно. Может быть:
  • "decimal"Используется для форматирования обычных чисел;
  • "currency"Используется для форматирования денежных сумм;
  • "percent"Используется для форматирования процентов;
  • "unit"Используется для форматирования единиц измерения

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

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"});

Попробуйте сами »

Number 对象参考手册Объект JavaScript Number

Другие расширения