Intl.Locale.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die toString()-Methode von Intl.Locale-Instanzen gibt die vollständige Locale-Identifier-Zeichenkette dieses Locales zurück.

Probieren Sie es aus

const french = new Intl.Locale("fr-Latn-FR", {
  calendar: "gregory",
  hourCycle: "h12",
});
const korean = new Intl.Locale("ko-Kore-KR", {
  numeric: true,
  caseFirst: "upper",
});

console.log(french.toString());
// Expected output: "fr-Latn-FR-u-ca-gregory-hc-h12"

console.log(korean.toString());
// Expected output: "ko-Kore-KR-u-kf-upper-kn"

Syntax

js
toString()

Parameter

Keine.

Rückgabewert

Die Unicode-Locale-Identifier-Zeichenkette des Locale.

Beschreibung

Das Locale-Objekt ist eine JavaScript-Darstellung des Konzepts eines Unicode-Locale-Identifiers. Informationen über ein bestimmtes Locale (Sprache, Schrift, Kalenderart usw.) können in einer Locale-Identifier-Zeichenkette kodiert werden. Um die Arbeit mit diesen Locale-Identifiern zu erleichtern, wurde das Locale-Objekt in JavaScript eingeführt. Der Aufruf der toString-Methode eines Locale-Objekts gibt die Identifier-Zeichenkette für dieses konkrete Locale zurück. Die toString-Methode ermöglicht es, Locale-Instanzen als Argumente für bestehende Intl-Konstruktoren zu verwenden, in JSON zu serialisieren oder in jedem anderen Kontext einzusetzen, in dem eine exakte Zeichenkettenrepräsentation nützlich ist.

Beispiele

Verwendung von toString

js
const myLocale = new Intl.Locale("fr-Latn-FR", {
  hourCycle: "h12",
  calendar: "gregory",
});
console.log(myLocale.baseName); // Prints "fr-Latn-FR"
console.log(myLocale.toString()); // Prints "fr-Latn-FR-u-ca-gregory-hc-h12"

Spezifikationen

Specification
ECMAScript® 2025 Internationalization API Specification
# sec-Intl.Locale.prototype.toString

Browser-Kompatibilität

Siehe auch