Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła