JavaScript Number toLocaleString() 方法

定义和用法

toLocaleString() 使用本地语言格式将数字作为字符串返回。

语言格式取决于您计算机上的区域设置。

实例

例子 1

使用区域设置将数字格式化为字符串：

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

Try it yourself

例子 2

使用芬兰的特定语言环境将数字格式化为字符串：

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

Try it yourself

例子 3

使用美国的特定语言环境将数字格式化为货币字符串：

let num = 1000000;
let text = num.toLocaleString("en-US", {style:"currency", currency:"USD"});

Try it yourself

Example 4

Using options Parameter (object) for currency formatting:

let num = new Number(1000000);
const myObj = {
  style: "currency",
  currency: "EUR"
}
let text = num.toLocaleString("en-GB", myObj);

Try it yourself

Example 5

let num = new Number(1000000);
let text = num.toLocaleString("en-GB", {style:"currency", currency:"EUR"});

Try it yourself

Example 6

Use the specific language environment of JAPAN:

let num = 1000000;
let text = num.toLocaleString("ja-JP", {style:"currency", currency:"JPY"});

Try it yourself

Grammar

number.toLocaleString(locales, options)

Parameter

Parameter Περιγραφή
locales Optional. The language-specific format to use. See the table below.
options Optional. An object with format options. See the table below.

locales The acceptable values for the parameter:

  • ar-SA Arabic (Saudi Arabia)
  • bn-BD Bengali (Bangladesh)
  • bn-IN Bengali (India)
  • cs-CZ Czech (Czech Republic)
  • da-DK Danish (Denmark)
  • de-AT Austrian German
  • de-CH Swiss German
  • de-DE Standard German (used in Germany)
  • el-GR Modern Greek
  • en-AU Australian English
  • en-CA Canadian English
  • en-GB British English
  • en-IE Irish English
  • en-IN Indian English
  • en-NZ New Zealand English
  • en-US American English
  • en-ZA English (South Africa)
  • es-AR Argentinian Spanish
  • es-CL Chilean Spanish
  • es-CO Colombian Spanish
  • es-ES Castilian Spanish (used in northern and central Spain)
  • es-MX Mexican Spanish
  • es-US American Spanish
  • fi-FI Finnish (Finland)
  • fr-BE Belgian French
  • fr-CA Canadian French
  • fr-CH Swiss French
  • fr-FR Standard French (especially in France)
  • he-IL Hebrew (Israel)
  • hi-IN Hindi (India)
  • hu-HU Magyar nyelv (Magyarország)
  • 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 Επιλογές που αποδέχονται οι παραμέτρους:

επιλογές τιμή
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
Υποστήριξη Υποστήριξη Υποστήριξη Υποστήριξη Υποστήριξη Υποστήριξη