Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Vremenske zone i ciklusi sati u Intl.DateTimeFormat

`timeZone` bira lokalno vrijeme koje se prikazuje za zadani trenutak. `hourCycle` određuje numeriranje sati, primjerice prikazuje li se ponoć kao `00` ili `24`.

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

Sintaksa

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

timeZone bira zonu za prikaz trenutka, bez promjene objekta Date ili njegove pohranjene vrijednosti. Ako izostaviš tu opciju, koristi se zadana zona izvršnog okruženja. Imenovana zona kao što je "America/New_York" primjenjuje pravila koja vrijede u tom trenutku, uključujući prijelaze na ljetno računanje vremena i natrag. Fiksni pomak kao što je "-05:00" ne slijedi ta pravila. Starija okruženja možda ne podržavaju identifikatore pomaka. timeZoneName određuje prikazanu oznaku, a ne odabir zone.

hourCycle određuje raspon sati: "h11" koristi 0–11, "h12" 1–12, "h23" 0–23, a "h24" 1–24. U ciklusu "h24" broj 24 označava sat koji počinje u ponoć; ne pomiče trenutak na sljedeći dan. Sam hourCycle ne dodaje sat u izlaz: zatraži ga opcijom hour ili timeStyle, ali nemoj kombinirati te dvije opcije.

hour12: true i hour12: false imaju prednost pred opcijom hourCycle i proširenjem Unicode hc u identifikatoru regionalnih postavki. true bira 12-satni, a false 24-satni ciklus. Za točno određen ciklus izostavi hour12 i postavi hourCycle, koji ima prednost pred hc. Bez tih postavki zadani ciklus ovisi o regionalnim postavkama.

Nevaljan hourCycle ili neprepoznat identifikator timeZone uzrokuje RangeError pri stvaranju formatera, čak i ako bi valjani hour12 imao prednost pred hourCycle. Provjeri primijenjene postavke metodom resolvedOptions(); ciklus nije naveden ako format ne sadrži sat. Za izdvajanje samo sata uzmi dio hour iz rezultata metode formatToParts() umjesto raščlanjivanja cijelog lokaliziranog niza.

Primjeri

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

Rezultat

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

U prva se dva retka mijenja samo zona: isti trenutak odgovara satu `05` u UTC-u i ponoći u New Yorku. U posljednjem se retku mijenja samo ciklus pa se isti lokalni sat prikazuje kao `24` umjesto `00`.

Povezane lekcije

  • JavaScript · Lekcija 25 · Napredno · Verzija: 4

Izvori