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 den vollständigen Locale-Identifier-String dieser Locale 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

Der Unicode-Locale-Identifier-String der Locale.

Beschreibung

Das Locale-Objekt ist eine JavaScript-Repräsentation eines Konzepts von Unicode-Locale-Identifiern. Informationen über eine bestimmte Locale (Sprache, Skript, Kalendertyp usw.) können in einem Locale-Identifier-String kodiert werden. Um die Arbeit mit diesen Locale-Identifiern zu erleichtern, wurde das Locale-Objekt in JavaScript eingeführt. Das Aufrufen der toString-Methode auf einem Locale-Objekt gibt den Identifier-String für diese bestimmte Locale zurück. Die toString-Methode ermöglicht es, Locale-Instanzen als Argument an bestehende Intl-Konstruktoren zu übergeben, in JSON zu serialisieren oder in jedem anderen Kontext zu verwenden, in dem eine exakte String-Reprä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® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.toString

Browser-Kompatibilität

Siehe auch