Temporal.ZonedDateTime.prototype.timeZoneId

Свойство доступа (аксессор) timeZoneId экземпляров Temporal.ZonedDateTime возвращает строку, представляющую идентификатор часового пояса, используемый для интерпретации внутреннего момента времени. Строка представляет собой либо именованный идентификатор в предпочтительном регистре (например, "America/New_York"), либо смещение в форме "±hh:mm". Если часовой пояс имеет псевдонимы, timeZoneId является идентификатором, использованным для создания ZonedDateTime, без канонизации до первичного идентификатора.

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

Примеры

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

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

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

const dt3 = dt2.withTimeZone("Asia/Shanghai");
console.log(dt3.timeZoneId); // "Asia/Shanghai"

timeZoneId никогда не канонизируется до первичного идентификатора; он совпадает с тем, который использовался для создания ZonedDateTime.

const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00+07:00[Asia/Ho_Chi_Minh]",
);
const dt2 = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00+07:00[Asia/Saigon]",
);
console.log(dt.timeZoneId); // "Asia/Ho_Chi_Minh"
console.log(dt2.timeZoneId); // "Asia/Saigon"

Однако различия в представлении будут канонизированы.

const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00+07:00[asia/ho_chi_minh]",
);
console.log(dt.timeZoneId); // "Asia/Ho_Chi_Minh"

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

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

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

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.withTimeZone()
• Temporal.ZonedDateTime.prototype.offset
• Temporal.ZonedDateTime.prototype.offsetNanoseconds