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