Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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