База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Часови зони и часови цикли в Intl.DateTimeFormat

`timeZone` избира местното време, което се показва за даден момент. `hourCycle` определя номерирането на часовете, например дали полунощ се показва като `00` или `24`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

timeZone избира зоната за показване на даден момент, без да променя обекта Date или съхранената му стойност. Ако пропуснеш опцията, се използва часовата зона по подразбиране на средата за изпълнение. Наименувана зона като "America/New_York" прилага правилата, валидни в дадения момент, включително преминаването към лятно часово време и обратно. Фиксирано отместване като "-05:00" не следва тези правила. По-старите среди може да не поддържат идентификатори на отместване. timeZoneName управлява показвания надпис, а не избора на зона.

hourCycle определя диапазона на часовете: "h11" използва 0–11, "h12" — 1–12, "h23" — 0–23, а "h24" — 1–24. При "h24" числото 24 означава часа, който започва в полунощ; то не измества момента към следващия ден. Само hourCycle не добавя час към резултата: поискай час чрез hour или timeStyle, но не комбинирай двете опции.

hour12: true и hour12: false имат предимство пред hourCycle и пред разширението на Unicode hc в идентификатора на регионалните настройки. true избира 12-часов цикъл, а false — 24-часов. Ако ти трябва конкретен цикъл, пропусни hour12 и задай hourCycle, което има предимство пред hc. Без тези настройки цикълът по подразбиране зависи от регионалните настройки.

Невалидна стойност на hourCycle или неразпознат идентификатор на timeZone предизвиква RangeError при създаване на форматиращия обект, дори ако валидно hour12 би имало предимство пред hourCycle. Провери действителните настройки с resolvedOptions(); цикълът липсва, ако форматът не съдържа час. За да извлечеш само часа, използвай частта hour от formatToParts(), вместо да разчиташ целия локализиран низ.

Примери

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

Резултат

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

В първите два реда се променя само зоната: един и същ момент съответства на час `05` в UTC и на полунощ в Ню Йорк. В последния ред се променя само цикълът, така че същият местен час се показва като `24` вместо `00`.

Свързани уроци

  • JavaScript · Урок 25 · Напреднало · Версия: 4

Източници