CKTIS / JavaScript
Intl.RelativeTimeFormat — relative Zeitangaben formatieren
Intl.RelativeTimeFormat erstellt lokalisierte Beschreibungen relativer Zeit. Die Methode format(value, unit) erwartet eine Zahl und eine Einheit, kein Datum; die Zeitdifferenz muss die Anwendung selbst berechnen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);Intl.RelativeTimeFormat gehört zum Internationalisierungsstandard ECMA-402 und nicht zu den DOM-APIs. Erstelle eine Instanz mit new. RelativeTimeFormat.format bezeichnet hier die Instanzmethode Intl.RelativeTimeFormat.prototype.format(value, unit), die Text zurückgibt. Negative Zahlen beschreiben die Vergangenheit, positive die Zukunft; die Methode berechnet keine Differenzen zwischen Datumsangaben.
unit akzeptiert second, minute, hour, day, week, month, quarter, year sowie deren englische Pluralformen. Eine nicht unterstützte Einheit, NaN oder Unendlich lösen einen RangeError aus.
Mit dem Standardwert numeric: "always" werden besondere Ausdrücke wie yesterday nicht verwendet. Das Muster für die jeweilige Locale kann eine Menge aber auch ohne ausdrückliche Zahlenangabe wiedergeben. Im Arabischen kann etwa die Dualform eines Substantivs zwei Tage bezeichnen, ohne dass eine eigene Zahlenangabe nötig ist. numeric: "auto" ermöglicht Ausdrücke wie yesterday, sofern verfügbar. Für style sind long (Standard), short und narrow zulässig.
Das Beispiel wählt ausdrücklich en und feste Werte. Der genaue Wortlaut hängt von den Lokalisierungsdaten ab. Prüfe, ob der Konstruktor und die benötigte Sprache im Zielbrowser verfügbar sind; dass Node 24 in einem Repository vorhanden ist, belegt keine Browserunterstützung.
Beispiele
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Ergebnis
yesterday tomorrow
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.