JavaScript Number toLocaleString() Methode

Definition und Verwendung

toLocaleString() Geben Sie die Zahl als Zeichenkette zurück, formatiert in der lokalen Spracheinstellung.

Die Sprachformatierung hängt von der Regionaleinstellung Ihres Computers ab.

Beispiel

Beispiel 1

Verwenden Sie die Regionaleinstellungen, um die Zahl in eine Zeichenkette zu formatieren:

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

Persönlich ausprobieren

Beispiel 2

Verwenden Sie die spezifische Spracheinstellung Finnlands, um die Zahl in eine Zeichenkette zu formatieren:

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

Persönlich ausprobieren

Beispiel 3

Verwenden Sie die spezifische Spracheinstellung der USA, um die Zahl in eine Währungssymbolzeichenkette zu formatieren:

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

Persönlich ausprobieren

Beispiel 4

Verwenden Sie options Parameter (Objekt) für Währungsformatierung:

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

Persönlich ausprobieren

Beispiel 5

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

Persönlich ausprobieren

Beispiel 6

Verwenden Sie die spezifische Sprache-Umgebung von JAPAN:

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

Persönlich ausprobieren

Grammatik

number.toLocaleString(locales, options)

Parameter

Parameter Beschreibung
locales Optional. Sprache-spezifische Formate, die verwendet werden sollen. Bitte siehe Tabelle unten.
options Optional. Ein Objekt mit Formatoptionen. Bitte siehe Tabelle unten.

locales Akzeptable Werte für den Parameter:

  • ar-SA Arabische Sprache (Saudi-Arabien)
  • bn-BD Bengalische Sprache (Bangladesch)
  • bn-IN Bengalische Sprache (Indien)
  • cs-CZ Tschechische Sprache (Tschechische Republik)
  • da-DK Dänische Sprache (Dänemark)
  • de-AT Österreichisches Deutsch
  • de-CH Deutsche Sprache "Schweiz"
  • de-DE Standarddeutsche Sprache (in Deutschland verwendet)
  • el-GR Neugriechische Sprache
  • en-AU Australisches Englisch
  • en-CA Kanadisches Englisch
  • en-GB Britisches Englisch
  • en-IE Irisches Englisch
  • en-IN Indisches Englisch
  • en-NZ Neuseeländisches Englisch
  • en-US US-amerikanisches Englisch
  • en-ZA Englisch (Südafrika)
  • es-AR Argentinisches Spanisch
  • es-CL Chilenisches Spanisch
  • es-CO Kolumbianisches Spanisch
  • es-ES Kastiljanisches Spanisch (in Nordwestspanien verwendet)
  • es-MX Mexikanisches Spanisch
  • es-US US-amerikanisches Spanisch
  • fi-FI Finnische Sprache (Finnland)
  • fr-BE Belgisches Französisch
  • fr-CA Kanadisches Französisch
  • fr-CH Französisch "Schweiz"
  • fr-FR Standardfranzösisch (insbesondere in Frankreich)
  • he-IL Hebräische Sprache (Israel)
  • hi-IN Hindi (Indien)
  • hu-HU Ungarische Sprache (Ungarn)
  • id-ID Indonesisch (Indonesien)
  • it-CH “Schweizer” Italienisch
  • it-IT Standarditalienisch (in Italien verwendet)
  • ja-JP Japanisch (Japan)
  • ko-KR Koreanisch (Republik Korea)
  • nl-BE Belgischer Niederländisch
  • nl-NL Standardniederländisch (Niederländisch)
  • no-NO Norwegisch (Norwegen)
  • pl-PL Polnisch (Polen)
  • pt-BR Brasilianisches Portugiesisch
  • pt-PT Europäisches Portugiesisch (Schreib- und Ausdrucksportugiesisch)
  • ro-RO Rumänisch (Rumänien)
  • ru-RU Russisch (Russische Föderation)
  • sk-SK Slowakisch (Slowakei)
  • sv-SE Schwedisch (Schweden)
  • ta-IN Indische Tamil
  • ta-LK Sri Lankische Tamil
  • th-TH Thai (Thailand)
  • tr-TR Türkisch (Türkei)
  • zh-CN China, vereinfachte chinesische Schrift
  • zh-HK Hongkong, traditionelle chinesische Schrift
  • zh-TW Taiwan, traditionelle chinesische Schrift

options Optionen, die der Parameter akzeptiert:

Optionen Wert
currency Gültige Werte: Jeglicher Währungscode (z.B. "EUR", "USD", "INR" usw.)
currencyDisplay

Gültige Werte:

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

Gültige Werte:

  • "best-fit"(Standard)
  • "lookup"
maximumFractionDigits Zahl von 0 bis 20 (Standard ist 3)
maximumSignificantDigits Zahl von 1 bis 21 (Standard ist 21)
minimumFractionDigits Zahl von 0 bis 20 (Standard ist 3)
minimumIntegerDigits Zahl von 1 bis 21 (Standard ist 1)
minimumSignificantDigits Zahl von 1 bis 21 (Standard ist 21)
style

Gültige Werte:

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

Gültige Werte:

  • "true"(Standard)
  • "false"

Rückgabewert

Typ Beschreibung
Zeichenfolge Zeichenfolge zur Darstellung der lokalen Formatzahl.

Technische Details

Rückgabewert

Die Zeichenfolge der Zahl, die von der Implementierung festgelegt wird, wird formatiert, um der lokalen Norm zu entsprechen und kann die durch Kommata oder Tausendertrennzeichen verwendeten Zeichensetzung beeinflussen.

Ausgelöst

Ausnahme Beschreibung
TypeError Wird eine Ausnahme ausgelöst, wenn das Objekt, das diese Methode aufruft, nicht ein Number ist.

Browser-Unterstützung

toLocaleString() Dies ist eine Eigenschaft von ECMAScript3 (ES3).

Alle Browser unterstützen ES3 (JavaScript 1999) vollständig:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Unterstützung Unterstützung Unterstützung Unterstützung Unterstützung Unterstützung