JavaScript Number toLocaleString() Method

Paglilinaw at paggamit

toLocaleString() Ibabalik bilang string ang numero gamit ang local na format ng wika.

Ang pag-format ng wika ay depende sa setting ng lugar ng iyong kompyuter.

Mga salin

Mga halimbawa 1

Gamit ang set up ng lugar upang formatuhin ang numero bilang string:

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

親自試試

Mga halimbawa 2

Gamit ang partikular na wika ng Finland upang formatuhin ang numero bilang string:

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

親自試試

Mga halimbawa 3

Gamit ang partikular na wika ng Estados Unidos upang formatuhin ang numero bilang string ng pera:

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)

參數

參數 Paglalarawan
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 Indonesian (Indonesia)
  • it-CH “Swiss” Italian
  • it-IT Standard Italian (used in Italy)
  • ja-JP Japanese (Japan)
  • ko-KR Korean (Republic of Korea)
  • nl-BE Belgian Dutch
  • nl-NL Standard Dutch (Dutch)
  • no-NO Norwegian (Norway)
  • pl-PL Polish (Poland)
  • pt-BR Brazilian Portuguese
  • pt-PT European Portuguese (Portuguese written and spoken)
  • ro-RO Romanian (Romania)
  • ru-RU Russian (Russian Federation)
  • sk-SK Slovak (Slovakia)
  • sv-SE Swedish (Sweden)
  • ta-IN Tamil (India)
  • ta-LK Sinhala (Sri Lanka)
  • th-TH Thai (Thailand)
  • tr-TR Turkish (Turkey)
  • zh-CN Mainland China, simplified Chinese
  • zh-HK Hongkong, kalye
  • zh-TW Taywan, kalye

options Mga opsyon na tinatanggap ng parameter:

Option Halaga
currency Legal na halaga: Anumang kodigo ng pera (tulad ng "EUR", "USD", "INR" at iba pa)
currencyDisplay

Legal na halaga:

  • "symbol"(Default)
  • "code"
  • "name"
localeMatcher

Legal na halaga:

  • "best-fit"(Default)
  • "lookup"
maximumFractionDigits Number mula 0 hanggang 20 (default ay 3)
maximumSignificantDigits Number mula 1 hanggang 21 (default ay 21)
minimumFractionDigits Number mula 0 hanggang 20 (default ay 3)
minimumIntegerDigits Number mula 1 hanggang 21 (default ay 1)
minimumSignificantDigits Number mula 1 hanggang 21 (default ay 21)
Style

Legal na halaga:

  • "currency"
  • "decimal"(Default)
  • "percent"
useGrouping

Legal na halaga:

  • "true"(Default)
  • "false"

Halimbawa ng pagbabalik

Uri Paglalarawan
String String na naglalarawan ng lokal na format ng numero.

Detalye ng teknolohiya

Halimbawa ng pagbabalik

Ang string na paglalarawan ng numero, pinili ng implementasyon, na naglalagay ng format ayon sa lokal na patakaran, maaaring maapektuhan ang simbolo ng pampunyagi ng titik ng dalampasigan o simbolo ng paghihiwalay ng libong pasyon.

Ihahabla

Kawalan Paglalarawan
TypeError Ihahabla ang kawalan ng Number na ginamit na object sa pagtawag sa paraan.

Suporta ng browser

toLocaleString() Ito ay katangian ng ECMAScript3 (ES3).

Lahat ng mga browser ay ganap na sumusuporta sa ES3 (JavaScript 1999):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporta Suporta Suporta Suporta Suporta Suporta