CKTIS / JavaScript
Intl.RelativeTimeFormat — formatowanie czasu względnego
Intl.RelativeTimeFormat tworzy zlokalizowane opisy czasu względnego. Metoda format(value, unit) przyjmuje liczbę i jednostkę, a nie datę; obliczenie różnicy czasu pozostaje zadaniem aplikacji.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);Intl.RelativeTimeFormat należy do standardu internacjonalizacji ECMA-402, nie do interfejsów DOM. Utwórz instancję przez new. RelativeTimeFormat.format oznacza tutaj metodę instancji Intl.RelativeTimeFormat.prototype.format(value, unit), zwracającą tekst. Liczby ujemne opisują przeszłość, a dodatnie — przyszłość; metoda nie oblicza różnic między datami.
unit przyjmuje second, minute, hour, day, week, month, quarter, year oraz ich angielskie formy mnogie. Nieobsługiwana jednostka, NaN lub nieskończoność powodują RangeError.
Domyślne numeric: "always" pomija specjalne określenia takie jak yesterday, ale wzorzec właściwy dla danej lokalizacji może wyrażać ilość bez podawania liczby wprost. Na przykład w języku arabskim forma liczby podwójnej rzeczownika może oznaczać dwa dni bez osobnego elementu liczbowego. numeric: "auto" pozwala używać określeń takich jak yesterday, jeśli są dostępne. style przyjmuje long (domyślnie), short lub narrow.
Przykład jawnie wybiera en i stałe wartości. Dokładny tekst zależy od danych lokalizacyjnych. Sprawdź dostępność konstruktora i wymaganej lokalizacji w docelowej przeglądarce; obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.
Przykłady
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Wynik
yesterday tomorrow
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.