JavaScript Number toLocaleString() 方法

阅读（0）
赞（0）
踩（0）
纠错

JavaScript Number 参考手册

定义和用法

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 哥伦比亚西班牙语
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 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
支持	支持	支持	支持	支持	支持

JavaScript Number 参考手册