Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.DateTimeFormat.formatToParts(): części daty i czasu

Pobierz części zlokalizowanej daty i godziny, aby wyróżnić wybrany składnik bez zgadywania kolejności pól ani dzielenia tekstu po separatorach.

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

Składnia

formatter.formatToParts()
formatter.formatToParts(date)

Intl.DateTimeFormat.prototype.formatToParts to metoda instancji Intl.DateTimeFormat. Zamiast jednego napisu, jak format(), zwraca tablicę obiektów { type, value } w kolejności wyświetlania. Obie właściwości są napisami. Połączenie wszystkich value przez join("") odtwarza wynik format() dla tego samego formatera i argumentu. W przeciwieństwie do funkcji zwracanej przez format, formatToParts nie jest automatycznie związana z instancją. Przekaż ją jako date => formatter.formatToParts(date) albo użyj bind; wywołanie z nieprawidłowym this zgłasza TypeError.

Wybieraj składniki po type, np. month lub dayPeriod, a nie po indeksie. Zachowaj literal: może zawierać spacje, znaki interpunkcyjne lub słowa. W niektórych kalendarzach zamiast year pojawia się relatedYear (odpowiadający rok gregoriański), czasem razem z yearName (nazwą roku). Zachowuj też części, których nie rozpoznajesz. Ustawienia regionalne, opcje i dane środowiska mogą wpływać na wynik. To dane do wyświetlania, nie format do parsowania ani zapisu. W przeglądarce wstawiaj wartości jako tekst przez textContent, nie przez innerHTML.

W ECMA-402 dla ECMAScript 2024 podaj Date lub liczbę milisekund od epoki Uniksa. Metoda konwertuje argument na liczbę, a nie interpretuje go jako tekst daty. Brak argumentu lub undefined oznacza bieżący czas wywołania. Nieprawidłowy Date lub znacznik czasu poza zakresem powoduje RangeError.

Środowiska z integracją Temporal obsługują też Temporal.Instant i typy Temporal.Plain* opisane w specyfikacji, z ograniczeniami zależnymi od typu, kalendarza i opcji. Sprawdź obsługę w docelowym środowisku. Przekazanie Temporal.ZonedDateTime bezpośrednio powoduje TypeError. Jeśli potrzebujesz części dla tego samego momentu w jego strefie, użyj toInstant() i ustaw timeZone formatera na strefę tego obiektu.

Przykłady

{
  const formatter = new Intl.DateTimeFormat("en-US", {
    timeZone: "UTC",
    calendar: "gregory",
    year: "numeric",
    month: "long",
    day: "numeric",
  });
  const date = new Date("2024-07-05T12:00:00Z");
  const parts = formatter.formatToParts(date);

  console.log(parts.some(({ type }) => type === "month"));
  console.log(parts.map(({ value }) => value).join("") === formatter.format(date));
}

Wynik

true
true

Przykład ustala moment, ustawienia regionalne i strefę UTC. Pierwsze `true` potwierdza obecność `month`, a drugie — że połączenie wartości odtwarza wynik `format(date)` bez zakładania konkretnych separatorów.

Powiązane lekcje

  • JavaScript · Lekcja 25 · Zaawansowany · Wersja: 4

Źródła