Intl.DateTimeFormat.prototype.resolvedOptions()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die Methode resolvedOptions() von Intl.DateTimeFormat-Instanzen gibt ein neues Objekt mit Eigenschaften zurück, die die bei der Initialisierung dieses DateTimeFormat-Objekts ermittelten Optionen widerspiegeln.
Probieren Sie es aus
const region = new Intl.DateTimeFormat("zh-CN", { timeZone: "UTC" });
const options = region.resolvedOptions();
console.log(options.locale);
// Expected output: "zh-CN"
console.log(options.calendar);
// Expected output: "gregory"
console.log(options.numberingSystem);
// Expected output: "latn"
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die anhand der an den Konstruktor Intl.DateTimeFormat() übergebenen Argumente ermittelten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der aufgeführten Reihenfolge:
locale-
Der BCP-47-Sprachtag für die tatsächlich verwendete Locale, die durch den Prozess der Locale-Aushandlung bestimmt wird. Nur die Unicode-Erweiterungsschlüssel
ca,hcundnukönnen in der Ausgabe enthalten sein, sofern sie angefordert wurden. calendar-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"ca"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Es handelt sich um einen für diese Locale unterstützten Kalendertyp. Der Standardwert hängt von der Locale ab. numberingSystem-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"nu"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Es handelt sich um ein für diese Locale unterstütztes Zahlensystem. Der Standardwert hängt von der Locale ab. timeZone-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt um den Standardwert. Es handelt sich um einen IANA-Zeitzonennamen oder einen Zeitzonenbezeichner mit UTC-Offset. Der Standardwert ist die Standardzeitzone der Laufzeitumgebung.Hinweis: Die Standardisierung von
Temporalverlangt, dass Browser denselben Bezeichner verwenden, der ursprünglich angegeben wurde, ohne ihn auf einen anderen Alias zu kanonisieren. Weitere Informationen finden Sie unter Zeitzonen und Offsets. hourCycleOptional-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"hc"angegebene Wert, gegebenenfalls ergänzt um den Standardwert. Wennhour12inoptionsangegeben wurde, hat dieser Wert Vorrang vor anderenhourCycle-Einstellungen. Die Eigenschaft ist nur vorhanden, wenn die aufgelösten Optionen auchhourodertimeStyleenthalten. Ihr Wert ist entweder"h11","h12","h23"oder"h24". Der Standardwert hängt von der Locale ab, wobei"h24"nie ein Standardwert ist. hour12Optional-
Wird aus
hourCycleberechnet. Die Eigenschaft ist nur vorhanden, wenn die aufgelösten Optionen auchhourodertimeStyleenthalten. Ihr Wert isttrue, wennhourCycle"h11"oder"h12"ist, undfalse, wennhourCycle"h23"oder"h24"ist. weekday,era,year,month,day,dayPeriod,hour,minute,second,fractionalSecondDigits,timeZoneNameOptional-
Die Werte, die sich aus dem Abgleich der entsprechenden Eigenschaften im Argument
optionsmit den verfügbaren Kombinationen und Darstellungen für die Datums- und Uhrzeitformatierung in der ausgewählten Locale ergeben. Einige dieser Eigenschaften sind möglicherweise nicht vorhanden. Das bedeutet, dass die entsprechenden Komponenten in der formatierten Ausgabe nicht dargestellt werden.weekday,eraunddayPeriodsind entweder"narrow","short"oder"long";year,day,hour,minuteundsecondsind entweder"numeric"oder"2-digit";monthist entweder"numeric","2-digit","narrow","short"oder"long";fractionalSecondDigitsist entweder1,2oder3;timeZoneNameist entweder"short","long","shortOffset","longOffset","shortGeneric"oder"longGeneric".Wenn diese Eigenschaften in
optionsangefordert wurden, verhindert der Konstruktor die Angabe vondateStyleundtimeStyle. Daher ist die folgende Gruppe nie vorhanden. dateStyle,timeStyleOptional-
Die für diese Eigenschaften im Argument
optionsangegebenen Werte. Sie sind entweder"full","long","medium"oder"short". Einige dieser Eigenschaften sind möglicherweise nicht vorhanden. Das bedeutet, dass die entsprechenden Komponenten in der formatierten Ausgabe nicht dargestellt werden.Wenn diese Eigenschaften in
optionsangefordert wurden, verhindert der Konstruktor die Angabe von Optionen für einzelne Datums- und Uhrzeitkomponenten. Daher ist die vorherige Gruppe nie vorhanden.Hinweis: Obwohl
dateStyleundtimeStyleKurzformen für Formatierungsstile einzelner Datums- und Uhrzeitkomponenten sind, sind die genauen (von der Locale abhängigen) Komponentenstile, in die sie aufgelöst werden, nicht in den aufgelösten Optionen enthalten. Dadurch kann das Ergebnis vonresolvedOptions()direkt an den KonstruktorIntl.DateTimeFormat()übergeben werden (denn einoptions-Objekt, das sowohldateStyleodertimeStyleals auch Formatierungsstile einzelner Datums- oder Uhrzeitkomponenten enthält, ist ungültig).
Beispiele
>Die Methode resolvedOptions verwenden
const germanFakeRegion = new Intl.DateTimeFormat("de-XX", { timeZone: "UTC" });
const usedOptions = germanFakeRegion.resolvedOptions();
usedOptions.locale; // "de" (because "de-XX" does not exist)
usedOptions.calendar; // "gregory"
usedOptions.numberingSystem; // "latn"
usedOptions.timeZone; // "UTC"
usedOptions.month; // "numeric"
Zeitzone und Locale-Einstellungen des Benutzers ermitteln
Der Konstruktor Intl.DateTimeFormat verwendet ohne Angabe von Optionen die aktuellen Systemeinstellungen. Mit resolvedOptions() können Sie die aktuelle Zeitzone des Benutzers sowie den für seine Locale bevorzugten Kalender und das bevorzugte Zahlensystem ermitteln:
const systemOptions = new Intl.DateTimeFormat().resolvedOptions();
systemOptions.timeZone; // e.g., "Europe/Brussels" or "Asia/Riyadh"
systemOptions.calendar; // e.g., "gregory" or "islamic-umalqura"
systemOptions.numberingSystem; // e.g., "latn" or "arab"
systemOptions.locale; // e.g., "nl-BE" or "ar-SA"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.datetimeformat.prototype.resolvedoptions> |