Intl.RelativeTimeFormat.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 2020.
Die Methode resolvedOptions() von Intl.RelativeTimeFormat-Instanzen gibt ein neues Objekt zurück, das die Optionen widerspiegelt, die bei der Initialisierung dieses RelativeTimeFormat-Objekts berechnet wurden.
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 Optionen widerspiegeln, die bei der Initialisierung dieses RelativeTimeFormat-Objekts berechnet wurden. Das Objekt hat die folgenden Eigenschaften, in der Reihenfolge, in der sie aufgelistet sind:
locale-
Das BCP-47-Sprach-Tag für die tatsächlich verwendete Locale, ermittelt durch den Locale-Aushandlungsprozess. Nur der
nu-Unicode-Erweiterungsschlüssel, falls angefordert, kann im Output enthalten sein. style-
Der in dem
options-Argument angegebene Wert für diese Eigenschaft, mit Standardwerten ausgefüllt, falls erforderlich. Er ist entweder"long","short"oder"narrow". Der Standardwert ist"long". numeric-
Der in dem
options-Argument angegebene Wert für diese Eigenschaft, mit Standardwerten ausgefüllt, falls erforderlich. Er ist entweder"always"oder"auto". Der Standardwert ist"always". numberingSystem-
Der in dem
options-Argument angegebene Wert für diese Eigenschaft oder unter Verwendung des Unicode-Erweiterungsschlüssels"nu", mit Standardwerten ausgefüllt, falls erforderlich. Es ist ein unterstütztes Nummerierungssystem für diese Locale. Der Standardwert ist vom Locale abhängig.
Beispiele
Verwendung der resolvedOptions()-Methode
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
| Specification |
|---|
| ECMAScript® 2025 Internationalization API Specification # sec-intl.relativetimeformat.prototype.resolvedoptions |