Baseline Widely available
Der Intl.Locale()
Konstruktor erstellt Intl.Locale
Objekte.
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
new Intl.Locale(tag)
new Intl.Locale(tag, options)
Hinweis: Intl.Locale()
kann nur mit new
konstruiert werden. Der Versuch, es ohne new
aufzurufen, führt zu einem TypeError
.
tag
Der Unicode-Locale-Bezeichner-String. Für die Syntax von Locale-Bezeichner-Strings siehe 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. Die hier angegebenen Optionswerte haben Vorrang vor Erweiterungsschlüsseln im Locale-Bezeichner. Mögliche Eigenschaften sind:
language
Die Sprache. Jeder syntaktisch gültige String entsprechend der unicode_language_subtag
Grammatik (2â3 oder 5â8 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.
script
Das Schrift-System. Jeder syntaktisch gültige String entsprechend der unicode_script_subtag
Grammatik (4 Buchstaben) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.
region
Die Region. Jeder syntaktisch gültige String entsprechend der unicode_region_subtag
Grammatik (entweder 2 Buchstaben oder 3 Ziffern) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten.
variants
Die Varianten. Es sollte eine durch Bindestriche (-
) getrennte Liste von einzigartigen Varianten-Tags sein, wobei jedes Tag ein syntaktisch gültiger String entsprechend der unicode_variant_subtag
Grammatik ist (entweder 5â8 alphanumerische Zeichen oder eine Ziffer gefolgt von 3 alphanumerischen Zeichen), aber die Implementierung erkennt nur bestimmte Arten.
calendar
Der Kalender. Jeder syntaktisch gültige String entsprechend der type
Grammatik (ein oder mehrere Segmente von 3â8 alphanumerischen Zeichen, verbunden durch Bindestriche) wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf()
aufgelistet sind.
collation
Die Kollation. Jeder syntaktisch gültige String entsprechend der type
Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf()
aufgelistet sind.
numberingSystem
Das Zahlsystem. Jeder syntaktisch gültige String entsprechend der type
Grammatik wird akzeptiert, aber die Implementierung erkennt nur bestimmte Arten, die in Intl.supportedValuesOf()
aufgelistet sind.
caseFirst
Die Case-First-Sortieroption. Mögliche Werte sind "upper"
, "lower"
, oder "false"
.
hourCycle
Der Stundenzyklus. Mögliche Werte sind "h23"
, "h12"
, "h11"
, oder das praktisch unbenutzte "h24"
, welche in Intl.Locale.prototype.getHourCycles
erklärt werden.
numeric
Die numerische Sortieroption. Ein boolean.
Im einfachsten Fall nimmt der Intl.Locale()
Konstruktor einen Locale-Bezeichner-String 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 nehmen, das verschiedene Erweiterungstypen enthalten kann. Setzen Sie zum Beispiel die hourCycle
Eigenschaft des Konfigurationsobjekts auf den gewünschten Stundenzylus-Typ und übergeben Sie es dann an den Konstruktor:
const locale = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(locale.hourCycle); // "h12"
Spezifikationen Browser-Kompatibilität Siehe auch
Intl.Collator
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4