Intl.DateTimeFormat.prototype.resolvedOptions()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Die resolvedOptions()
-Methode von Intl.DateTimeFormat
-Instanzen gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung dieses DateTimeFormat
-Objekts berechneten Optionen widerspiegeln.
Probieren Sie es aus
const region1 = new Intl.DateTimeFormat("zh-CN", { timeZone: "UTC" });
const options1 = region1.resolvedOptions();
console.log(options1.locale);
// Expected output: "zh-CN"
console.log(options1.calendar);
// Expected output: "gregory"
console.log(options1.numberingSystem);
// Expected output: "latn"
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses DateTimeFormat
-Objekts berechneten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften, in der angegebenen Reihenfolge:
locale
-
Der BCP 47-Sprachcode für die tatsächlich verwendete Sprache, bestimmt durch den Sprachverhandlungsprozess. Nur die Unicode-Erweiterungsschlüssel
ca
,hc
undnu
können in der Ausgabe enthalten sein, wenn diese angefordert wurden. calendar
-
Der für diese Eigenschaft im
options
-Argument angegebene Wert oder der über den Unicode-Erweiterungsschlüssel"ca"
angeforderte Wert, mit Standardwerten, falls erforderlich. Es handelt sich um einen unterstützten Kalendertyp für diese Locale. Die Standardeinstellung hängt von der Locale ab. numberingSystem
-
Der für diese Eigenschaft im
options
-Argument angegebene Wert oder der über den Unicode-Erweiterungsschlüssel"nu"
angeforderte Wert, mit Standardwerten, falls erforderlich. Es handelt sich um ein unterstütztes Zahlensystem für diese Locale. Die Standardeinstellung hängt von der Locale ab. timeZone
-
Der für diese Eigenschaft im
options
-Argument angegebene Wert, mit Standardwerten, falls erforderlich. Es handelt sich um einen IANA-Zeitzonennamen. Der Standardwert ist die Standardzeitzone der Laufzeitumgebung.Hinweis: Die Standardisierung von
Temporal
erfordert, dass Browser denselben Bezeichner verwenden, wie ursprünglich spezifiziert, ohne Kanonisierung zu einem anderen Alias. Weitere Informationen finden Sie unter Zeitzonen und Offsets. hourCycle
Optional-
Der für diese Eigenschaft im
options
-Argument angegebene Wert oder der über den Unicode-Erweiterungsschlüssel"hc"
angeforderte Wert, mit Standardwerten, falls erforderlich. Wennhour12
imoptions
-Argument angegeben wurde, überschreibt dies anderehourCycle
-Einstellungen. Sie ist nur vorhanden, wenn die aufgelösten Optionen auchhour
odertimeStyle
umfassen. Die möglichen Werte sind"h11"
,"h12"
,"h23"
oder"h24"
. Die Standardeinstellung ist von der Locale abhängig, wobei"h24"
niemals Standard ist. hour12
Optional-
Abgeleitet aus
hourCycle
. Sie ist nur vorhanden, wenn die aufgelösten Optionen auchhour
odertimeStyle
umfassen. Der Wert isttrue
, wennhourCycle
"h11"
oder"h12"
ist, undfalse
, wennhourCycle
"h23"
oder"h24"
ist. weekday
,era
,year
,month
,day
,dayPeriod
,hour
,minute
,second
,fractionalSecondDigits
,timeZoneName
Optional-
Die Werte, die aus dem Formatabgleich zwischen den entsprechenden Eigenschaften im
options
-Argument und den verfügbaren Kombinationen und Darstellungen für Datums- und Zeitformatierung in der ausgewählten Locale resultieren. Einige dieser Eigenschaften können fehlen, was anzeigt, dass die entsprechenden Komponenten nicht in der formatierten Ausgabe enthalten sein werden.weekday
,era
unddayPeriod
sind entweder"narrow"
,"short"
oder"long"
;year
,day
,hour
,minute
undsecond
sind entweder"numeric"
,"2-digit"
oder"narrow"
;month
ist entweder"numeric"
,"2-digit"
,"narrow"
,"short"
oder"long"
;fractionalSecondDigits
ist entweder1
,2
oder3
;timeZoneName
ist entweder"short"
,"long"
,"shortOffset"
,"longOffset"
,"shortGeneric"
oder"longGeneric"
.Falls diese Eigenschaften im
options
-Argument angefordert wurden, verhindert der Konstruktor die Angabe vondateStyle
undtimeStyle
, sodass die unten angegebene Gruppe niemals vorhanden sein wird. dateStyle
,timeStyle
Optional-
Die für diese Eigenschaften im
options
-Argument angegebenen Werte. Die möglichen Werte sind"full"
,"long"
,"medium"
,"short"
oder"none"
. Einige dieser Eigenschaften können fehlen, was darauf hinweist, dass die entsprechenden Komponenten nicht in der formatierten Ausgabe enthalten sein werden.Falls diese Eigenschaften im
options
-Argument angefordert wurden, verhindert der Konstruktor die Angabe einzelner Datums- oder Zeitkomponentenoptionen, sodass die oben angegebene Gruppe niemals vorhanden sein wird.Hinweis: Obwohl
dateStyle
undtimeStyle
Abkürzungen für einzelne Datums- und Zeitkomponentenstile sind, sind die genauen (locale-abhängigen) Komponentenstile, die daraus abgeleitet werden, nicht in den aufgelösten Optionen enthalten. Dies stellt sicher, dass das Ergebnis vonresolvedOptions()
direkt an denIntl.DateTimeFormat()
-Konstruktor übergeben werden kann (weil einoptions
-Objekt mit sowohldateStyle
odertimeStyle
als auch einzelnen Datums- oder Zeitkomponentenstilen nicht gültig ist).
Beispiele
Verwendung der Methode resolvedOptions
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"
Abrufen von Zeitzonen- und Spracheinstellungen des Benutzers
Der Intl.DateTimeFormat
-Konstruktor ohne Optionen verwendet die aktuellen Systemeinstellungen. Sie können resolvedOptions()
verwenden, um die aktuelle Zeitzone des Benutzers und das bevorzugte Kalender- und Zahlensystem der Locale zu 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
Specification |
---|
ECMAScript® 2025 Internationalization API Specification # sec-intl.datetimeformat.prototype.resolvedoptions |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
resolvedOptions | ||||||||||||||
computed timeZone |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.