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 哥倫比亞西班牙語
  • 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
支持 支持 支持 支持 支持 支持