Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Intl.DateTimeFormat: formatowanie daty na części za pomocą formatToParts()

Pobierz części lokalnie sformatowanej daty lub godziny, aby wyróżnić na przykład miesiąc bez dzielenia tekstu według separatorów i bez zakładania kolejności pól.

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

Składnia

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() to metoda instancji Intl.DateTimeFormat, zdefiniowana na Intl.DateTimeFormat.prototype, a nie metoda statyczna konstruktora. Wywołaj ją jako formatter.formatToParts(date). W przeciwieństwie do format() metoda nie jest automatycznie związana z instancją: wywołanie pobranej funkcji bez właściwego this powoduje TypeError.

Przekaż obiekt Date lub liczbę milisekund od epoki uniksowej, nie sekund. Pominięcie argumentu lub przekazanie undefined oznacza użycie bieżącego czasu z Date.now(). Nieprawidłowy Date lub znacznik czasu poza zakresem powoduje RangeError. Metoda formatuje dane, a nie interpretuje tekst daty. Środowiska z integracją Temporal mogą obsługiwać także niektóre typy Temporal.Plain*; Temporal.ZonedDateTime przekazany bezpośrednio powoduje TypeError.

Wynikiem jest tablica obiektów { type, value } w kolejności wyświetlania; obie właściwości są napisami. type wskazuje na przykład month, day lub year, natomiast literal oznacza tekst wzorca, taki jak przecinek, spacja lub słowo. W kalendarzach z nazwami lat zamiast year może pojawić się relatedYear (odpowiadający rok gregoriański), a wzorzec może też zawierać yearName (nazwę roku).

Wybieraj części według type, nie indeksu. Aby odtworzyć wynik format() dla tej samej instancji i tej samej daty, połącz wszystkie value bez separatora, razem z literal. Ustawienia regionalne i opcje, w tym kalendarz i strefa czasowa, wpływają na wynik; dokładna pisownia i interpunkcja mogą się różnić nawet przy tych samych ustawieniach regionalnych w różnych środowiskach. Nie używaj wyniku jako formatu wymiany danych.

Przykłady

const formatter = new Intl.DateTimeFormat("en-US", {
  timeZone: "UTC",
  year: "numeric",
  month: "long",
  day: "numeric",
});
const date = new Date("2024-07-09T12: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 datę, ustawienia regionalne i strefę UTC. Pierwsze `true` potwierdza obecność części `month`, a drugie zgodność połączonych wartości z wynikiem `format()`.

Powiązane lekcje

  • JavaScript · Lekcja 15 · Podstawowy · Wersja: 4

Źródła