Intl.RelativeTimeFormat

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⁩.

Das Intl.RelativeTimeFormat-Objekt ermöglicht die sprachsensitive relative Zeitformatierung.

Probieren Sie es aus

Intl.RelativeTimeFormat(): Erstellt ein neues Intl.RelativeTimeFormat-Objekt.

Intl.RelativeTimeFormat.supportedLocalesOf(): Gibt ein Array zurück, das die der angegebenen Locales enthält, die unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.

Diese Eigenschaften sind auf Intl.RelativeTimeFormat.prototype definiert und werden von allen Intl.RelativeTimeFormat-Instanzen geteilt.

Intl.RelativeTimeFormat.prototype.constructor: Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Bei Intl.RelativeTimeFormat-Instanzen ist der Anfangswert der Intl.RelativeTimeFormat-Konstruktor.
Intl.RelativeTimeFormat.prototype[Symbol.toStringTag]: Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "Intl.RelativeTimeFormat". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Intl.RelativeTimeFormat.prototype.format(): Formatiert einen value und eine unit entsprechend der Locale und der Formatierungsoptionen des gegebenen Intl.RelativeTimeFormat-Objekts.
Intl.RelativeTimeFormat.prototype.formatToParts(): Gibt ein Array von Objekten zurück, das das relative Zeitformat in Teilen repräsentiert, die für eine benutzerdefinierte locale-sensible Formatierung verwendet werden können.
Intl.RelativeTimeFormat.prototype.resolvedOptions(): Gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung des Objekts errechneten Locale- und Formatierungsoptionen widerspiegeln.

Das folgende Beispiel zeigt, wie ein relativer Zeitformatierer für die englische Sprache verwendet wird.

Das folgende Beispiel zeigt, wie man einen relativen Zeitformatierer erstellt, der formatierte Teile zurückgibt.

Specification
ECMAScript® 2026 Internationalization API Specification # relativetimeformat-objects

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.