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
Syntax
Parameter
tag
-
Die Unicode-Locale-Identifikatorzeichenfolge. Für die Syntax von Locale-Identifikatorzeichenfolgen siehe die Intl Hauptseite. Beachten Sie, dass der
Intl.Locale
Konstruktor, im Gegensatz zu den meisten anderenIntl
Konstruktoren, kein Array von Locales oderundefined
akzeptiert. options
-
Ein Objekt, das die Konfiguration für die Locale enthält. Optionswerte hier haben Vorrang vor Erweiterungsschlüsseln im Locale-Identifikator. Mögliche Eigenschaften sind:
language
-
Die Sprache. Jede syntaktisch gültige Zeichenfolge gemäß der
unicode_language_subtag
Grammatik (2–3 oder 5–8 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten. script
-
Das Skript. Jede syntaktisch gültige Zeichenfolge gemäß der
unicode_script_subtag
Grammatik (4 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten. region
-
Die Region. Jede syntaktisch gültige Zeichenfolge gemäß der
unicode_region_subtag
Grammatik (entweder 2 Buchstaben oder 3 Ziffern) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten. calendar
-
Der Kalender. Jede syntaktisch gültige Zeichenfolge gemäß der
type
Grammatik (ein oder mehrere Segmente aus 3–8 alphanumerischen Zeichen, verbunden durch Bindestriche) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die inIntl.supportedValuesOf()
aufgelistet sind. collation
-
Die Sortierung. Jede syntaktisch gültige Zeichenfolge gemäß der
type
Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die inIntl.supportedValuesOf()
aufgelistet sind. numberingSystem
-
Das Zahlensystem. Jede syntaktisch gültige Zeichenfolge gemäß der
type
Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die inIntl.supportedValuesOf()
aufgelistet sind. caseFirst
-
Die Groß-Klein-Schreibung als Sortieroption. Mögliche Werte sind
"upper"
,"lower"
oder"false"
. hourCycle
-
Der Stundenzyklus. Mögliche Werte sind
"h23"
,"h12"
,"h11"
oder das praktisch ungenutzte"h24"
, welche inIntl.Locale.prototype.getHourCycles
erklärt werden. numeric
-
Die numerische Sortieroption. Ein boolescher Wert.
Beispiele
Grundlegende Verwendung
Im einfachsten Fall nimmt der Intl.Locale()
Konstruktor eine Locale-Identifikatorzeichenfolge als Argument:
const us = new Intl.Locale("en-US");
Verwendung des Locale-Konstruktors mit einem Optionsobjekt
Der Konstruktor kann auch ein optionales Konfigurationsobjekt als Argument annehmen, das verschiedene Erweiterungstypen enthalten kann. Setzen Sie zum Beispiel die hourCycle
Eigenschaft des Konfigurationsobjekts auf den gewünschten Stundenzyklustyp und übergeben Sie es dann an den Konstruktor:
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"
Spezifikationen
Specification |
---|
ECMAScript® 2025 Internationalization API Specification # sec-intl-locale-constructor |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
Intl.Collator
- Kanonische Unicode Locale Identifikatoren in der Unicode-Locale-Daten-Markup-Sprachspezifikation