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 對象