Intl.RelativeTimeFormat.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 2020 browserübergreifend verfügbar.
Die Methode resolvedOptions() von Intl.RelativeTimeFormat-Instanzen gibt ein neues Objekt zurück, dessen Eigenschaften die bei der Initialisierung dieses RelativeTimeFormat-Objekts ermittelten Optionen widerspiegeln.
Probieren Sie es aus
const rtf1 = new Intl.RelativeTimeFormat("en", { style: "narrow" });
const options1 = rtf1.resolvedOptions();
const rtf2 = new Intl.RelativeTimeFormat("es", { numeric: "auto" });
const options2 = rtf2.resolvedOptions();
console.log(`${options1.locale}, ${options1.style}, ${options1.numeric}`);
// Expected output: "en, narrow, always"
console.log(`${options2.locale}, ${options2.style}, ${options2.numeric}`);
// Expected output: "es, long, auto"
Syntax
resolvedOptions()
Parameter
Keine.
Rückgabewert
Ein neues Objekt mit Eigenschaften, die die anhand der an den Konstruktor Intl.RelativeTimeFormat() übergebenen Argumente ermittelten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften in der aufgeführten Reihenfolge:
locale-
Der BCP-47-Sprach-Tag für die tatsächlich verwendete Locale, die durch den Prozess der Locale-Aushandlung bestimmt wird. Nur der Unicode-Erweiterungsschlüssel
nukann, falls angefordert, in der Ausgabe enthalten sein. style-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt durch den Standardwert. Der Wert ist entweder"long","short"oder"narrow". Der Standardwert ist"long". numeric-
Der für diese Eigenschaft im Argument
optionsangegebene Wert, gegebenenfalls ergänzt durch den Standardwert. Der Wert ist entweder"always"oder"auto". Der Standardwert ist"always". numberingSystem-
Der für diese Eigenschaft im Argument
optionsoder über den Unicode-Erweiterungsschlüssel"nu"angegebene Wert, gegebenenfalls ergänzt durch den Standardwert. Der Wert ist ein für diese Locale unterstütztes Zahlensystem. Der Standardwert hängt von der Locale ab.
Beispiele
>Verwendung der Methode resolvedOptions()
const de = new Intl.RelativeTimeFormat("de-DE");
const usedOptions = de.resolvedOptions();
usedOptions.locale; // "de-DE"
usedOptions.style; // "long"
usedOptions.numeric; // "always"
usedOptions.numberingSystem; // "latn"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.relativetimeformat.prototype.resolvedoptions> |