Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Strefa czasowa i cykl godzin w Intl.DateTimeFormat

`timeZone` określa, jaki czas lokalny odpowiada danej chwili, a `hourCycle` decyduje, jak zapisać godzinę, na przykład jako `00` lub `24` o północy.

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

Składnia

new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })

timeZone wybiera strefę używaną do wyświetlenia danej chwili, ale nie zmienia obiektu Date ani zapisanej w nim wartości. Bez tej opcji formater używa domyślnej strefy środowiska wykonawczego. Strefa nazwana, np. "America/New_York", stosuje reguły obowiązujące w danej chwili, w tym zmiany czasu letniego. Stałe przesunięcie, np. "-05:00", nie stosuje tych reguł. Starsze środowiska mogą nie obsługiwać identyfikatorów przesunięć. timeZoneName steruje widoczną etykietą, a nie wyborem strefy.

hourCycle określa zakres godzin: "h11" to 0–11, "h12" to 1–12, "h23" to 0–23, a "h24" to 1–24. W "h24" liczba 24 oznacza godzinę z przedziału od północy do pierwszej, a nie przesunięcie chwili na następny dzień. Sama opcja hourCycle nie dodaje godziny do wyniku: poproś o nią przez hour lub timeStyle, ale nie łącz obu opcji.

Jeśli podasz hour12: true lub hour12: false, ta opcja ma pierwszeństwo przed hourCycle i rozszerzeniem Unicode hc w identyfikatorze lokalizacji. true wybiera cykl 12-godzinny, a false 24-godzinny. Aby wymusić konkretny cykl, pomiń hour12 i ustaw hourCycle: ma ono pierwszeństwo przed hc. Jeśli nic nie ustawisz, cykl zależy od lokalizacji.

Nieprawidłowy hourCycle lub nierozpoznany identyfikator timeZone powoduje RangeError podczas tworzenia formatera, nawet jeśli poprawne hour12 miałoby pierwszeństwo przed hourCycle. Sprawdź dobrane ustawienia przez resolvedOptions(); cykl nie jest zwracany, jeśli format nie zawiera godziny. Aby pobrać samą godzinę, wybierz część typu hour z formatToParts() zamiast analizować cały zlokalizowany tekst.

Przykłady

const instant = new Date("2024-01-15T05:00:00Z");

function showHour(timeZone, hourCycle) {
  const formatter = new Intl.DateTimeFormat("en-US", {
    timeZone,
    hourCycle,
    hour: "2-digit",
    numberingSystem: "latn",
    formatMatcher: "basic",
  });
  const hour = formatter.formatToParts(instant).find(part => part.type === "hour");
  const displayHour = hour.value.padStart(2, "0");
  console.log(`${timeZone} ${formatter.resolvedOptions().hourCycle}: ${displayHour}`);
}

showHour("UTC", "h23");
showHour("America/New_York", "h23");
showHour("America/New_York", "h24");

Wynik

UTC h23: 05
America/New_York h23: 00
America/New_York h24: 24

Pierwsze dwa wiersze zmieniają tylko strefę: tej samej chwili odpowiada godzina `05` w UTC i północ w Nowym Jorku. Ostatni wiersz zmienia tylko cykl, więc ta sama lokalna godzina jest zapisana jako `24` zamiast `00`.

Powiązane lekcje

  • JavaScript · Lekcja 25 · Zaawansowany · Wersja: 4

Źródła