JavaScript Array.toLocaleString()-Methode

Array 对象参考手册JavaScript Array-Objekt


Beispiel

In verschiedene regionale Formate formatieren:

const prices = [1234.56, 7890.12, 3456.78]; const dateArray = [new Date(), new Date('2023-01-01')]; //Number-Arrays verwenden lokalisiertes Format console.log(prices.toLocaleString('en-US')); //Ausgabe ähnlich wie: "1,234.56,7,890.12,3,456.78" (englisches Format) console.log(prices.toLocaleString('de-DE')); //Ausgabe ähnlich wie: "1.234,56,7.890,12,3.456,78" (deutsches Format) //Datums-Arrays verwenden lokalisiertes Format console.log(dateArray.toLocaleString('en-US')); //Ausgabe ähnlich wie: "5/6/2023, 1/1/2023" (englisches Datumsformat) console.log(dateArray.toLocaleString('ja-JP')); //Ausgabe ähnlich wie: "2023/5/6, 2023/1/1" (japanisches Datumsformat)

Selbst ausprobieren »

Definition und Verwendung

Array.toLocaleString()Es ist eine eingebaute Methode des JavaScript-Array-Objekts, die eine Zeichenfolge zurückgibt, die die Array-Elemente darstellt.

Array.toLocaleString()Die Besonderheit dieser Methode ist, dass sie jedes Element im Array entsprechend den Gebietsschema-Einstellungen der aktuellen Umgebung formatiert.

Einfach ausgedrückt, diese Methode:

  • Konvertiert ein Array in eine Zeichenfolge
  • Verarbeitet automatisch lokalisierte Formate (wie Datumsangaben, Zahlen usw.)
  • Elemente werden durch Kommas getrennt

Grundlegende Syntax

array.toLocaleString([locales[, options]])

Parameterbeschreibung

  • locales(Optional): Eine Zeichenfolge oder ein Array von Zeichenfolgen, die den Sprachcode darstellen (z. B. "en-US", "zh-CN")
  • options(Optional): Ein Konfigurationsobjekt, das zum Angeben von Formatierungsoptionen verwendet wird

Verwendung

Grundlegende Verwendung

Beispiel

const numbers = [12345.67, 1000, 3.14159];
console.log(numbers.toLocaleString('en-US'));
// Ausgabe: "12,345.67,1,000,3.142"

console.log(numbers.toLocaleString('de-DE'));
// Ausgabe: "12.345,67,1.000,3,142"

Umgang mit Date-Objekten

Beispiel

const dates = [new Date(), new Date('2023-01-01')];
console.log(dates.toLocaleString('en-US'));
// Mögliche Ausgabe: "1/2/2024, 2:30:45 PM,1/1/2023, 12:00:00 AM"

Erweiterte Nutzung

Verwenden des options-Parameters

Beispiel

const numbers = [12345.67, 1000, 3.14159];

// Währungsformat angeben
console.log(numbers.toLocaleString('en-US', {
  style: 'currency',
  currency: 'USD'
}));
// Ausgabe: "$12,345.67,$1,000.00,$3.14"

// Prozentformat angeben
console.log([0.25, 0.5, 0.75].toLocaleString('en-US', {
  style: 'percent'
}));
// Ausgabe: "25%,50%,75%"

Unterschied zu toString()

Methode Lokalisierungsverarbeitung Datumsformatierung Zahlenformatierung
toString() Keine Konvertiert in Standardzeichenfolge Keine spezielle Behandlung
toLocaleString() Ja Gemäß lokalem Format Gemäß lokalem Format

Beispiel

const arr = [1000, new Date()];

console.log(arr.toString());
// Ausgabe: "1000,Wed Jan 03 2024 14:30:00 GMT+0800 (China Standard Time)"

console.log(arr.toLocaleString('zh-CN'));
// Ausgabe: "1,000,2024/1/3 14:30:00"

Praktische Anwendungsszenarien

  1. Mehrsprachige Websites: Formatierte Daten basierend auf den Sprachpräferenzen der Benutzer anzeigen
  2. Finanzanwendungen: Währungsformate für verschiedene Regionen korrekt anzeigen
  3. Datenanalyse: Zahlen und Datumsangaben in vertrauten Formaten anzeigen
  4. Formularanzeige: Daten in lokalisierten Formaten in Eingabefeldern anzeigen

Hinweise

  1. Leistungsaspekte: Häufige Aufrufe können die Leistung beeinträchtigen, insbesondere bei großen Arrays
  2. Browser-Kompatibilität: Obwohl moderne Browser dies unterstützen, können einige Optionen abweichen
  3. Standardverhalten: Wenn der Parameter locales nicht angegeben ist, werden die Standardspracheinstellungen der Laufzeitumgebung verwendet
  4. Elementbehandlung: Bei Objekten, die keine Datums- oder Zahlenobjekte sind, wird deren toString()-Methode aufgerufen

Zusammenfassung

Array.toLocaleString()Es ist ein leistungsstarkes Lokalisierungswerkzeug, besonders geeignet für Szenarien, in denen formatierte Daten entsprechend der Region des Benutzers angezeigt werden müssen. Es vereinfacht die Implementierung der Internationalisierung (i18n) und ermöglicht Entwicklern, Unterschiede bei Zahlen- und Datumsformaten zwischen Regionen einfach zu handhaben.

Denken Sie daran: Wenn Ihre Anwendung globale Benutzer bedienen muss, kann die Verwendung dieser Methode die Benutzererfahrung erheblich verbessern!

Array 对象参考手册JavaScript Array-Objekt

Weitere Erweiterungen