Intl.Locale() Konstruktor

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.

Der Intl.Locale() Konstruktor erstellt Intl.Locale Objekte.

Probieren Sie es aus

const korean = new Intl.Locale("ko", {
  script: "Kore",
  region: "KR",
  hourCycle: "h23",
  calendar: "gregory",
});

const japanese = new Intl.Locale("ja-Jpan-JP-u-ca-japanese-hc-h12");

console.log(korean.baseName, japanese.baseName);
// Expected output: "ko-Kore-KR" "ja-Jpan-JP"

console.log(korean.hourCycle, japanese.hourCycle);
// Expected output: "h23" "h12"

Syntax

js
new Intl.Locale(tag)
new Intl.Locale(tag, options)

Hinweis: Intl.Locale() kann nur mit new konstruiert werden. Ein Versuch, es ohne new aufzurufen, wirft einen TypeError.

Parameter

tag

Der Unicode-Locale-Identifier-String. Für die Syntax von Locale-Identifier-Strings sehen Sie die Intl Hauptseite. Beachten Sie, dass der Intl.Locale Konstruktor, im Gegensatz zu den meisten anderen Intl Konstruktoren, kein Array von Locales oder undefined akzeptiert.

options

Ein Objekt, das die Konfiguration für die Locale enthält. Optionswerte hier haben Vorrang vor Erweiterungsschlüsseln im Locale-Identifier. Mögliche Eigenschaften sind:

language

Die Sprache. Jeder syntaktisch gültige String, der der unicode_language_subtag Grammatik entspricht (2–3 oder 5–8 Buchstaben), wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

script

Das Skript. Jeder syntaktisch gültige String, der der unicode_script_subtag Grammatik entspricht (4 Buchstaben), wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

region

Die Region. Jeder syntaktisch gültige String, der der unicode_region_subtag Grammatik entspricht (entweder 2 Buchstaben oder 3 Ziffern), wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.

calendar

Der Kalender. Jeder syntaktisch gültige String, der der type Grammatik entspricht (ein oder mehrere Segmente von 3–8 alphanumerischen Zeichen, durch Bindestriche verbunden), wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

collation

Die Kollation. Jeder syntaktisch gültige String, der der type Grammatik entspricht, wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

numberingSystem

Das Nummerierungssystem. Jeder syntaktisch gültige String, der der type Grammatik entspricht, wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf() aufgelistet sind.

caseFirst

Die Groß-/Kleinschreibungsvorgabe für die Sortierung. Mögliche Werte sind "upper", "lower", oder "false".

hourCycle

Der Stundenzyklus. Mögliche Werte sind "h23", "h12", "h11", oder das praktisch ungenutzte "h24", die in Intl.Locale.prototype.getHourCycles beschrieben werden.

numeric

Die numerische Sortieroption. Ein boolescher Wert.

Beispiele

Grundlegende Verwendung

Im einfachsten Fall nimmt der Intl.Locale() Konstruktor einen Locale-Identifier-String als Argument:

js
const us = new Intl.Locale("en-US");

Verwendung des Locale-Konstruktors mit einem Optionsobjekt

Der Konstruktor nimmt auch ein optionales Konfigurationsobjekt als Argument, das beliebige Erweiterungstypen enthalten kann. Setzen Sie zum Beispiel die hourCycle Eigenschaft des Konfigurationsobjekts auf den gewünschten Stundentyp und übergeben Sie es dann dem Konstruktor:

js
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"

Spezifikationen

Specification
ECMAScript® 2026 Internationalization API Specification
# sec-intl-locale-constructor

Browser-Kompatibilität

Siehe auch