Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Časové pásma a hodinové cykly v Intl.DateTimeFormat

`timeZone` vyberá miestny čas zobrazený pre daný okamih. `hourCycle` určuje číslovanie hodín, napríklad či sa polnoc zobrazí ako `00` alebo `24`.

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

Syntax

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

timeZone vyberá pásmo na zobrazenie okamihu bez zmeny objektu Date alebo jeho uloženej hodnoty. Ak túto voľbu vynecháš, použije sa predvolené pásmo prostredia vykonávania. Pomenované pásmo ako "America/New_York" uplatňuje pravidlá platné v danom okamihu vrátane prechodov na letný čas a späť. Pevný posun ako "-05:00" sa týmito pravidlami neriadi. Staršie prostredia nemusia identifikátory posunu podporovať. timeZoneName určuje zobrazené označenie, nie výber pásma.

hourCycle určuje rozsah hodín: "h11" používa 0–11, "h12" 1–12, "h23" 0–23 a "h24" 1–24. V cykle "h24" číslo 24 označuje hodinu začínajúcu o polnoci; neposúva okamih na ďalší deň. Samotné hourCycle hodinu do výstupu nepridá: vyžiadaj si ju cez hour alebo timeStyle, ale tieto voľby nekombinuj.

hour12: true a hour12: false majú prednosť pred hourCycle aj pred rozšírením Unicode hc identifikátora miestnych nastavení. true vyberá 12-hodinový cyklus, false 24-hodinový. Ak chceš konkrétny cyklus, vynechaj hour12 a nastav hourCycle, ktoré má prednosť pred hc. Bez týchto volieb závisí predvolený cyklus od miestnych nastavení.

Neplatné hourCycle alebo nerozpoznaný identifikátor timeZone vyvolá pri vytváraní formátovača výnimku RangeError, aj keby platné hour12 malo pred hourCycle prednosť. Skutočne použité nastavenia zistíš pomocou resolvedOptions(); cyklus sa nevráti, ak formát neobsahuje hodinu. Samotnú hodinu získaš z časti hour vo výsledku formatToParts() namiesto spracovania celého lokalizovaného reťazca.

Príklady

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");

Výsledok

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

V prvých dvoch riadkoch sa mení iba pásmo: tomu istému okamihu zodpovedá hodina `05` v UTC a polnoc v New Yorku. V poslednom riadku sa mení iba cyklus, takže tá istá miestna hodina sa zobrazí ako `24` namiesto `00`.

Súvisiace lekcie

  • JavaScript · Lekcia 25 · Pokročilá · Verzia: 4

Zdroje