CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — lokalne formatowanie daty i czasu
Użyj `formatter.format()`, aby wyświetlić datę i czas zgodnie z ustawieniami regionalnymi i strefą czasową. Wynik jest tekstem przeznaczonym do wyświetlenia, a nie do zapisu danych.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Wywołuj formatter.format(...) na instancji Intl.DateTimeFormat, a nie na konstruktorze. Utwórz formater za pomocą new Intl.DateTimeFormat(locales, options), podając ustawienia regionalne, strefę czasową i pola, które mają się pojawić. Wywołanie zwraca ciąg znaków i nie zmienia obiektu Date. Bez locales lub timeZone formater używa odpowiednich wartości domyślnych środowiska.
W ECMA-402 z 2024 r. można przekazać obiekt Date lub liczbę oznaczającą milisekundy od epoki Uniksa, nie sekundy. Brak argumentu lub jawne undefined oznacza bieżący moment w chwili wywołania. format() nie parsuje tekstu daty: najpierw zamień go na poprawny obiekt Date lub znacznik czasu. Niepoprawny Date, NaN, nieskończoność lub znacznik czasu poza zakresem Date powodują RangeError.
Intl.DateTimeFormat.prototype.format to właściwość z getterem. Odczyt formatter.format zwraca tę samą funkcję powiązaną z instancją, więc można ją przekazać bezpośrednio jako funkcję zwrotną, np. dates.map(formatter.format), bez bind().
W środowiskach obsługujących integrację z Temporal można też przekazać Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth lub Temporal.PlainMonthDay, o ile typ pasuje do konfiguracji formatera. Temporal.ZonedDateTime powoduje TypeError; aby sformatować go w jego własnej strefie, użyj Temporal.ZonedDateTime.prototype.toLocaleString().
Nawet przy tych samych ustawieniach wynik może różnić się między środowiskami, np. odstępami, interpunkcją lub znakami sterującymi kierunkiem tekstu. Nie porównuj go z wpisanym na stałe tekstem ani nie traktuj jako formatu wymiany danych.
Przykłady
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Wynik
string true
Przykład ustala moment, ustawienia regionalne i strefę UTC. Sprawdza typ wyniku oraz to, czy odłączona funkcja formatuje znacznik czasu tak samo jak wywołanie na instancji z odpowiadającym mu obiektem `Date`, bez zakładania dokładnej postaci tekstu.
Powiązane lekcje
- JavaScript · Lekcja 15 · Podstawowy · Wersja: 4