CKTIS / JavaScript
Intl.DateTimeFormat: odczyt faktycznych ustawień
Użyj `resolvedOptions()`, aby sprawdzić, jakie ustawienia formatowania daty i czasu faktycznie przyjęła instancja, zamiast wnioskować o nich z argumentów konstruktora.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions to metoda instancji bez argumentów. Z każdym wywołaniem zwraca nowy, zwykły obiekt z ustawieniami ustalonymi podczas tworzenia formatera. Zmiana wyniku nie zmienia formatera. W przeciwieństwie do format() metoda nie przyjmuje daty ani nie zwraca sformatowanego tekstu. Wywołanie jej bez powiązania this lub z nieodpowiednim this (np. {}) powoduje TypeError.
Wynik zawiera locale (faktycznie wybrany znacznik językowy BCP 47), calendar, numberingSystem i timeZone. Nie jest kopią danych przekazanych do konstruktora: wybór spośród obsługiwanych ustawień regionalnych i wartości domyślne mogą zmienić wynik. Bez jawnego timeZone formater przyjmuje domyślną strefę środowiska uruchomieniowego przy tworzeniu. Identyfikator strefy może być znormalizowany, więc nie zakładaj, że będzie identyczny z podanym ciągiem znaków.
Bez dateStyle i timeStyle właściwości takie jak year, month i hour odzwierciedlają dopasowany wzorzec; nieużywane składniki są pomijane. Gdy podasz dateStyle lub timeStyle, wynik zawiera podane style, ale nie rozwija ich na poszczególne składniki. Połączenie stylu z jawną opcją składnika, np. hour, powoduje TypeError już w konstruktorze.
Jeśli wzorzec obejmuje godzinę, wynik zawiera hourCycle i wyliczone z niego hour12, nawet gdy timeStyle ukrywa właściwość hour. hour12 ma wartość true dla h11 i h12, a false dla h23 i h24. Bez godziny obie właściwości są pomijane. Przy wyborze cyklu opcja hour12 ma pierwszeństwo przed hourCycle i rozszerzeniem Unicode hc.
Używaj wyniku do diagnozowania różnic między środowiskami. Obsługa opcji i dane regionalne mogą się różnić, a zgodność zwróconych ustawień nie gwarantuje identycznego sformatowanego tekstu.
Przykłady
const formatter = new Intl.DateTimeFormat("en-GB", {
timeZone: "UTC",
timeStyle: "short",
hour12: false,
});
const options = formatter.resolvedOptions();
console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));
options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);Wynik
UTC short false false UTC
Kod wypisuje kolejno `UTC`, `short`, `false`, `false` i `UTC`. Pierwsze `false` oznacza tryb 24-godzinny, drugie — brak własnej właściwości `hour`. Przypisanie `Asia/Tokyo` zmienia tylko zwrócony obiekt.
Powiązane lekcje
- JavaScript · Lekcja 25 · Zaawansowany · Wersja: 4
Źródła
- ECMAScript® 2024 Internationalization API Specification — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — CreateDateTimeFormat