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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch