Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.RelativeTimeFormat.prototype.format() — formatowanie czasu względnego

Zamienia przesunięcie czasowe ze znakiem i podaną jednostkę na tekst zgodny z ustawieniami językowo-regionalnymi. Nie oblicza różnicy między datami.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);

Intl.RelativeTimeFormat.prototype.format to metoda instancji. Wywołanie formatter.format(value, unit) zwraca tekst zgodny z faktycznie używanymi ustawieniami językowo-regionalnymi i opcjami ustalonymi w konstruktorze. Aplikacja sama oblicza przesunięcie względem punktu odniesienia i wybiera jednostkę; metoda nie odczytuje zegara ani nie odejmuje dat.

Wartość ujemna oznacza przeszłość, a dodatnia przyszłość. Gdy używany jest wzorzec liczbowy, -0 wybiera wzorzec przeszłości, a +0 wzorzec przyszłości. unit przyjmuje dokładne identyfikatory "second", "minute", "hour", "day", "week", "month", "quarter" i "year" oraz ich formy z końcówką s. Forma identyfikatora nie narzuca formy gramatycznej wyniku.

Opcja numeric: "always" (domyślna) używa wzorca liczbowego. numeric: "auto" wybiera gotowy zwrot, jeśli jest dostępny, np. yesterday, a w przeciwnym razie używa wzorca liczbowego. style określa długość zapisu: "long" (domyślna), "short" lub "narrow". Obsługa zależy od środowiska wykonawczego, a tekst może się różnić nawet dla tych samych ustawień językowo-regionalnych, np. spacjami nierozdzielającymi. W przenośnych testach nie porównuj wyniku z tekstem wpisanym na sztywno.

Metoda wymaga instancji jako this; wywołanie odłączonej metody bez poprawnego this zgłasza TypeError. Jako funkcję zwrotną można przekazać formatter.format.bind(formatter). Po sprawdzeniu this metoda stosuje ToNumber do value, a potem ToString do unit. Na przykład BigInt przekazany jako value powoduje TypeError. Po konwersji NaN, Infinity, -Infinity lub nieobsługiwany identyfikator jednostki powodują RangeError.

Przykłady

{
  const numeric = new Intl.RelativeTimeFormat("en", { numeric: "always" });
  const auto = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
  const past = numeric.format(-1, "day");
  console.log(past);
  console.log(auto.format(-1, "day"));
  console.log(past === numeric.format(-1, "days"));
}

Wynik

1 day ago
yesterday
true

Dla tego samego przesunięcia `-1` dnia pierwsze dwa wiersze pokazują typowy tekst angielski w trybach `"always"` i `"auto"`. Trzeci wiersz pokazuje, że `"day"` i `"days"` są równoważne.

Powiązane lekcje

  • JavaScript · Lekcja 24 · Zaawansowany · Wersja: 4

Źródła