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 resolvedOptions() Methode von Instanzen des Objekts Intl.RelativeTimeFormat gibt ein neues Objekt zurück, das die während der Initialisierung dieses RelativeTimeFormat-Objekts berechneten Optionen widerspiegelt.

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

js
resolvedOptions()

Parameter

Keine.

Rückgabewert

Ein neues Objekt mit Eigenschaften, die die während der Initialisierung dieses RelativeTimeFormat-Objekts berechneten Optionen widerspiegeln. Das Objekt hat die folgenden Eigenschaften, in der Reihenfolge wie sie aufgeführt sind:

locale

Der BCP 47-Sprachcode für die tatsächlich verwendete Locale, bestimmt durch den Locale-Verhandlungsprozess. Nur der nu Unicode-Erweiterungsschlüssel kann in die Ausgabe aufgenommen werden, wenn er angefordert wird.

style

Der für diese Eigenschaft im options Argument angegebene Wert, mit Standardwerten, die bei Bedarf ausgefüllt werden. Es ist entweder "long", "short" oder "narrow". Der Standardwert ist "long".

numeric

Der für diese Eigenschaft im options Argument angegebene Wert, mit Standardwerten, die bei Bedarf ausgefüllt werden. Es ist entweder "always" oder "auto". Der Standardwert ist "always".

numberingSystem

Der im options Argument oder über den Unicode-Erweiterungsschlüssel "nu" angegebene Wert, mit Standardwerten, die bei Bedarf ausgefüllt werden. Es handelt sich um ein unterstütztes Nummerierungssystem für diese Locale. Der Standardwert ist abhängig von der Locale.

Beispiele

Verwendung der resolvedOptions() Methode

js
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® 2026 Internationalization API Specification
# sec-intl.relativetimeformat.prototype.resolvedoptions

Browser-Kompatibilität

Siehe auch