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