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
Yes Yes Yes Yes Yes Yes

最新版本浏览器都支持 (locales, options) 参数：

Chrome IE Edge Firefox Safari Opera
Yes 11 Yes Yes Yes Yes

语法

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" 用于单位格式

返回值

类型 描述
字符串 返回一个语言环境下的表示字符串。

技术细节

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"}); // 人民币 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 对象