Temporal.ZonedDateTime.prototype.offset

Свойство offset доступа экземпляров Temporal.ZonedDateTime возвращает строку, представляющую смещение, используемое для интерпретации внутреннего момента времени, в форме ±HH:mm (или ±HH:mm:ss.sssssssss с такой точностью до долей минуты, какая необходима). Это смещение гарантированно будет действительным для заданного момента времени и часового пояса во время создания.

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

Примеры

Использование смещения

const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
console.log(dt.offset); // "-07:00"

const dt2 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00-07[-07]");
console.log(dt2.offset); // "-07:00"

const dt3 = Temporal.ZonedDateTime.from(
  "1900-01-01T00:00:00+00:09:21[Europe/Paris]",
);
console.log(dt3.offset); // "+00:09:21"

const dt4 = Temporal.ZonedDateTime.from("2021-07-01T12:00:00Z[Asia/Shanghai]");
console.log(dt4.offset); // "+08:00"

Изменение смещения

Если местное время имеет два допустимых смещения, например, во время перехода на летнее время, вы можете изменить смещение, не меняя ничего другого:

const zdt = Temporal.ZonedDateTime.from(
  "2024-11-03T01:05:00-04:00[America/New_York]",
);
const newZDT = zdt.with({ offset: "-05:00" });
console.log(newZDT.toString()); // "2024-11-03T01:05:00-05:00[America/New_York]"

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

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

Смотрите также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.with()
• Temporal.ZonedDateTime.prototype.withTimeZone()
• Temporal.ZonedDateTime.prototype.timeZoneId
• Temporal.ZonedDateTime.prototype.offsetNanoseconds