Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła