CKTIS / JavaScript
Časová pásma a hodinové cykly v Intl.DateTimeFormat
`timeZone` určuje, jaký místní čas odpovídá danému okamžiku. `hourCycle` určuje číslování hodin, například zda se půlnoc zobrazí jako `00`, nebo `24`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new Intl.DateTimeFormat(locales, { timeZone, hourCycle, hour: "2-digit" })timeZone vybírá pásmo pro zobrazení okamžiku, aniž by změnilo objekt Date nebo jeho uloženou hodnotu. Pokud volbu vynecháš, použije se výchozí pásmo běhového prostředí. Pojmenované pásmo jako "America/New_York" používá pravidla platná v daném okamžiku, včetně přechodů na letní čas a zpět. Pevný posun, například "-05:00", se těmito pravidly neřídí. Starší prostředí nemusí identifikátory posunu podporovat. timeZoneName určuje zobrazovaný popisek, ne výběr pásma.
hourCycle určuje rozsah hodin: "h11" používá 0–11, "h12" 1–12, "h23" 0–23 a "h24" 1–24. V cyklu "h24" číslo 24 označuje hodinu začínající o půlnoci; neposouvá okamžik do dalšího dne. Samotné hourCycle hodinu do výstupu nepřidá: vyžádej ji pomocí hour nebo timeStyle, ale obě volby nekombinuj.
hour12: true i hour12: false mají přednost před hourCycle i před rozšířením Unicode hc v identifikátoru národního prostředí. true vybírá 12hodinový cyklus, false 24hodinový. Pokud potřebuješ konkrétní cyklus, vynech hour12 a nastav hourCycle, které má přednost před hc. Bez těchto nastavení závisí výchozí cyklus na národním prostředí.
Neplatné hourCycle nebo nerozpoznaný identifikátor timeZone vyvolá při vytváření formátovače výjimku RangeError, i kdyby platné hour12 mělo před hourCycle přednost. Skutečně použité volby zjistíš pomocí resolvedOptions(); pokud formát neobsahuje hodinu, cyklus se nevrací. Samotnou hodinu získej z části hour ve výsledku formatToParts() místo rozebírání celého lokalizovaného řetězce.
Pří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ýsledek
UTC h23: 05 America/New_York h23: 00 America/New_York h24: 24
V prvních dvou řádcích se mění jen pásmo: stejnému okamžiku odpovídá hodina `05` v UTC a půlnoc v New Yorku. V posledním řádku se mění jen cyklus, takže se stejná místní hodina zobrazí jako `24` místo `00`.
Související lekce
- JavaScript · Lekce 25 · Pokročilá · Verze: 4
Zdroje
- ECMAScript® 2024 Internationalization API Specification — CreateDateTimeFormat
- ECMAScript Internationalization API Specification — CreateDateTimeFormat (living specification)
- Intl.DateTimeFormat() constructor — MDN
- Intl.DateTimeFormat.prototype.resolvedOptions() — MDN
- Intl.DateTimeFormat.prototype.formatToParts() — MDN