Temporal.ZonedDateTime.prototype.hour

Свойство доступа hour экземпляров Temporal.ZonedDateTime возвращает целое число от 0 до 23, представляющее компонент часа этого времени.

Сеттер hour является undefined. Вы не можете изменить это свойство напрямую. Используйте метод with(), чтобы создать новый объект Temporal.ZonedDateTime с желаемым новым значением.

Для общей информации и дополнительных примеров см. Temporal.PlainTime.prototype.hour.

Для ZonedDateTime, hour может быть не непрерывным из-за изменений смещения, таких как переход на летнее время. В этом случае час может быть повторен или пропущен.

Примеры

Использование часа

const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56.123456789-04:00[America/New_York]",
);
console.log(dt.hour); // 12

Непрерывный час

Непрерывный час очень распространен из-за переходов на летнее время, что более подробно объясняется в разделе Неоднозначность и пробелы от местного времени к времени UTC.

const dt = Temporal.ZonedDateTime.from(
  "2024-11-03T01:59:00-04:00[America/New_York]",
);
console.log(dt.hour); // 1
const dt2 = dt.add({ minutes: 1 });
console.log(dt2.hour); // 1
console.log(dt2.toString()); // 2024-11-03T01:00:00-05:00[America/New_York]

const dt3 = Temporal.ZonedDateTime.from(
  "2024-03-10T01:59:00-05:00[America/New_York]",
);
console.log(dt3.hour); // 1
const dt4 = dt3.add({ minutes: 1 });
console.log(dt4.hour); // 3
console.log(dt4.toString()); // 2024-03-10T03:00:00-04:00[America/New_York]

По этой причине всегда следует предпочитать add() и subtract() для манипулирования датами и временем, а не напрямую изменять свойство hour.

Спецификации

Совместимость с браузерами

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.with()
• Temporal.ZonedDateTime.prototype.add()
• Temporal.ZonedDateTime.prototype.subtract()
• Temporal.PlainTime.prototype.hour