Baseline Widely available *
Das Intl.Locale
-Objekt ist eine standardmäÃig integrierte Eigenschaft des Intl-Objekts, das einen Unicode-Locale-Identifikator darstellt.
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"
Beschreibung
Das Intl.Locale
-Objekt wurde erstellt, um die Manipulation von Unicode-Locale zu erleichtern. Unicode repräsentiert Locales mit einem String, der ein Locale-Identifikator genannt wird. Der Locale-Identifikator besteht aus einem Sprachidentifikator und Erweiterungstags. Sprachidentifikatoren sind der Kern der Locale und bestehen aus Sprache, Schrift, Region und Varianten Subtags. Zusätzliche Informationen über die Locale werden in den optionalen Erweiterungstags gespeichert. Erweiterungstags enthalten Informationen über Aspekte der Locale wie Kalenderart, Uhrzeitsystem und Nummerierungssystem.
Traditionell hat die Intl-API Strings verwendet, um Locales darzustellen, genau wie Unicode. Dies ist eine einfache und leichte Lösung, die gut funktioniert. Das Hinzufügen einer Locale-Klasse erleichtert jedoch das Parsen und Manipulieren von Sprache, Schrift und Region sowie Erweiterungstags. Die folgenden Eigenschaften von Intl.Locale
entsprechen Unicode-Locale-Identifikator-Subtags:
Die obigen Informationen werden genau so bereitgestellt, wie sie sind, wenn das Locale
-Objekt erstellt wird, ohne eine externe Datenbank zu konsultieren. Das Intl.Locale
-Objekt bietet zusätzlich einige Methoden, die Informationen über die realen Informationen der Locale zurückgeben, wie verfügbare Kalender, Kollationen und Nummerierungssysteme.
Intl.Locale()
Erstellt ein neues Locale
-Objekt.
Diese Eigenschaften sind auf Intl.Locale.prototype
definiert und werden von allen Intl.Locale
-Instanzen geteilt.
Intl.Locale.prototype.baseName
Gibt grundlegende, zentrale Informationen über das Locale
in Form eines Substrings der vollständigen Datenzeichenkette zurück.
Intl.Locale.prototype.calendar
Gibt den Teil des Locale
zurück, der die Kalenderära der Locale angibt.
Intl.Locale.prototype.caseFirst
Gibt zurück, ob bei der Kollation der Locale die GroÃ- und Kleinschreibung berücksichtigt wird.
Intl.Locale.prototype.collation
Gibt den Kollationstyp für das Locale
zurück, der verwendet wird, um Zeichenfolgen entsprechend den Regeln der Locale zu ordnen.
Intl.Locale.prototype.constructor
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Bei Intl.Locale
-Instanzen ist der Ausgangswert der Intl.Locale
-Konstruktor.
Intl.Locale.prototype.hourCycle
Gibt das Zeitformatkonvention zurück, das von der Locale verwendet wird.
Intl.Locale.prototype.language
Gibt die Sprache zurück, die mit der Locale verbunden ist.
Intl.Locale.prototype.numberingSystem
Gibt das Ziffernsystem zurück, das von der Locale verwendet wird.
Intl.Locale.prototype.numeric
Gibt zurück, ob die Locale spezielle Kollationsverarbeitung für numerische Zeichen hat.
Intl.Locale.prototype.region
Gibt die Region der Welt (meist ein Land) zurück, die mit der Locale verbunden ist.
Intl.Locale.prototype.script
Gibt das Skript zurück, das für das Schreiben der bestimmten Sprache verwendet wird, die in der Locale verwendet wird.
Intl.Locale.prototype.variants
Gibt die Varianten-Subtags (wie verschiedene Orthografien) zurück, die mit der Locale verbunden sind.
Intl.Locale.prototype[Symbol.toStringTag]
Der Ausgangswert der [Symbol.toStringTag]
-Eigenschaft ist die Zeichenfolge "Intl.Locale"
. Diese Eigenschaft wird in Object.prototype.toString()
verwendet.
Intl.Locale.prototype.getCalendars()
Gibt ein Array
von verfügbaren Kalender-Identifikatoren entsprechend den Regeln der Locale zurück.
Intl.Locale.prototype.getCollations()
Gibt ein Array
der Kollationstypen für das Locale
zurück.
Intl.Locale.prototype.getHourCycles()
Gibt ein Array
von Stundensystem-Identifikatoren zurück und zeigt entweder die 12-Stunden-Uhr ("h12"), die japanische 12-Stunden-Uhr ("h11"), die 24-Stunden-Uhr ("h23") oder das unbenutzte Format "h24" an.
Intl.Locale.prototype.getNumberingSystems()
Gibt ein Array
von Nummerierungssystem-Identifikatoren zurück, die entsprechend den Regeln der Locale verfügbar sind.
Intl.Locale.prototype.getTextInfo()
Gibt den Teil zurück, der die Anordnung der Zeichen ltr
(von links nach rechts) oder rtl
(von rechts nach links) angibt.
Intl.Locale.prototype.getTimeZones()
Gibt ein Array
von Zeitzonen-Identifikatoren zurück, die mit der Locale
verbunden sind.
Intl.Locale.prototype.getWeekInfo()
Gibt die Wochenelemente von UTS 35 entsprechend den Locale-Regeln zurück.
Intl.Locale.prototype.maximize()
Ruft die wahrscheinlichsten Werte für Sprache, Skript und Region der Locale basierend auf bestehenden Werten ab.
Intl.Locale.prototype.minimize()
Versucht, Informationen über die Locale zu entfernen, die durch den Aufruf von maximize()
hinzugefügt würde.
Intl.Locale.prototype.toString()
Gibt die vollständige Locale-Identifikator-Zeichenkette der Locale zurück.
Im einfachsten Fall nimmt der Intl.Locale()
-Konstruktor eine Locale-Identifikator-Zeichenkette als Argument:
const us = new Intl.Locale("en-US");
Verwenden des Locale-Konstruktors mit einem Optionsobjekt
Der Konstruktor nimmt auch ein optionales Konfigurationsobjektargument, das eine beliebige Anzahl von Erweiterungstypen enthalten kann. Zum Beispiel setzen Sie die hourCycle
-Eigenschaft des Konfigurationsobjekts auf Ihren gewünschten Stundensystem-Typ und übergeben es dann an den Konstruktor:
const us12hour = new Intl.Locale("en-US", { hourCycle: "h12" });
console.log(us12hour.hourCycle); // Prints "h12"
Spezifikationen Browser-Kompatibilität Siehe auch
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