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
- ECMAScript® 2024 Internationalization API Specification — Intl.RelativeTimeFormat.prototype.format
- ECMAScript® 2024 Internationalization API Specification — PartitionRelativeTimePattern
- ECMAScript Internationalization API Specification (living draft) — Intl.RelativeTimeFormat.prototype.format
- Intl.RelativeTimeFormat.prototype.format() - JavaScript | MDN