Метод JavaScript Number toLocaleString()

Определение и использование

toLocaleString() Возврат числа как строки с использованием локального языкового формата.

Формат языка зависит от региональных настроек вашего компьютера.

Пример

Пример 1

Использование регионального настроения для форматирования числа как строки:

let num = 1000000;
let text = num.toLocaleString();

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

Пример 2

Использование специфического языкового окружения Финляндии для форматирования числа как строки:

let num = 1000000;
let text = num.toLocaleString("fi-FI");

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

Пример 3

Использование специфического языкового окружения США для форматирования числа как строку в виде денег:

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

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

Пример 4

Использование options Форматирование货币 с помощью параметра (объект):

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

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

Пример 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

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

Пример 6

Использование специфического языка окружения JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

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

грамматика

number.toLocaleString(locales, options)

Параметр

Параметр 描述
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 Испанский (Кolumbia)
  • es-ES Кастilianский испанский (в Испании и севере)
  • 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 Thai（泰国）
  • tr-TR 土耳其语（土耳其）
  • zh-CN 中国大陆，简体字
  • zh-HK 香港，繁体字
  • zh-TW 台湾，繁体字

options 参数接受的选项：

选项 值
currency 合法值：任何货币代码（如 "EUR", "USD", "INR" 等）
currencyDisplay

合法值：

  • "symbol"（默认）
  • "code"
  • "name"
localeMatcher

合法值：

  • "best-fit"（默认）
  • "lookup"
maximumFractionDigits 从 0 到 20 的数字（默认为 3）
maximumSignificantDigits 从 1 到 21 的数字（默认为 21）
minimumFractionDigits 从 0 到 20 的数字（默认为 3）
minimumIntegerDigits 从 1 到 21 的数字（默认为 1）
minimumSignificantDigits 从 1 到 21 的数字（默认为 21）
style

合法值：

  • "currency"
  • "decimal"（默认）
  • "percent"
useGrouping

合法值：

  • "true"（默认）
  • "false"

返回值

类型 描述
字符串 表示本地格式数字的字符串。

技术细节

返回值

数字的字符串表示，由实现决定，根据本地规范进行格式化，可能影响到小数点或千分位分隔符采用的标点符号。

抛出

异常 描述
TypeError 调用该方法的对象不是 Number 时抛出的异常。

浏览器支持

toLocaleString() 是 ECMAScript3 (ES3) 特性。

Все браузеры полностью поддерживают ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Поддержка Поддержка Поддержка Поддержка Поддержка Поддержка