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 Unicode-Locale-Identifier-Konzepts. Informationen über ein bestimmtes Locale (Sprache, Schrift, Kalendertyp, etc.) können in einem Locale-Identifier-String kodiert werden. Um die Arbeit mit diesen Locale-Identifikatoren zu erleichtern, wurde das Locale-Objekt in JavaScript eingeführt. Ein Aufruf der Methode toString auf einem Locale-Objekt gibt den Identifier-String für dieses spezielle Locale zurück. Die toString-Methode ermöglicht es, Locale-Instanzen als Argumente für bestehende Intl-Konstruktoren bereitzustellen, in JSON zu serialisieren oder in jedem anderen Kontext zu nutzen, 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