Temporal.ZonedDateTime.prototype.withPlainTime()

Метод withPlainTime() экземпляров Temporal.ZonedDateTime возвращает новый объект Temporal.ZonedDateTime, представляющий это дата-время с частью времени, полностью замененной новым временем (в форме, преобразуемой с помощью Temporal.PlainTime.from()).

Этот метод заменит все свойства времени, по умолчанию устанавливая 0, где свойства не указаны. Если вы хотите заменить только некоторые свойства времени, вместо этого используйте метод with().

Синтаксис

withPlainTime()
withPlainTime(plainTime)

Параметры

plainTime Необязательный

Строка, объект или экземпляр Temporal.PlainTime, представляющий новое время. Он преобразуется в объект Temporal.PlainTime с использованием того же алгоритма, что и Temporal.PlainTime.from(). Если не указано, часть времени устанавливается на начало дня (что обычно является 00:00:00, если оно не существует из-за переходов смещения). Разрешение неоднозначности всегда происходит в режиме "compatible"; если вы хотите использовать другой режим, вместо этого используйте метод with().

Возвращаемое значение

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

Примеры

Использование withPlainTime()

const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56[America/New_York]",
);

// You can pass a string
const newZDT = zdt.withPlainTime("13:45:00");
console.log(newZDT.toString()); // "2021-07-01T13:45:00-04:00[America/New_York]"

// You can only specify some time properties, and the rest default to 0;
// for the with() method, they would be copied from the original date-time
const newZDT2 = zdt.withPlainTime({ hour: 13 });
console.log(newZDT2.toString()); // "2021-07-01T13:00:00-04:00[America/New_York]"

// You can pass nothing to set the time to midnight
const newZDT3 = zdt.withPlainTime();
console.log(newZDT3.toString()); // "2021-07-01T00:00:00-04:00[America/New_York]"

// But, if midnight doesn't exist, it may be a different time
const zdt2 = Temporal.ZonedDateTime.from(
  "2015-10-18T12:00-02:00[America/Sao_Paulo]",
);
console.log(zdt2.withPlainTime().toString()); // "2015-10-18T01:00:00-02:00[America/Sao_Paulo]"

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

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

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.with()
• Temporal.ZonedDateTime.prototype.withCalendar()
• Temporal.ZonedDateTime.prototype.withTimeZone()
• Temporal.ZonedDateTime.prototype.toPlainTime()
• Temporal.ZonedDateTime.from()