Temporal.PlainDateTime.prototype.withPlainTime()

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

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

Синтаксис

withPlainTime()
withPlainTime(plainTime)

Параметры

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

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

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

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

Примеры

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

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");

// You can pass a string
const newDT = dt.withPlainTime("13:45:00");
console.log(newDT.toString()); // "2021-07-01T13:45:00"

// 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 newDT2 = dt.withPlainTime({ hour: 13 });
console.log(newDT2.toString()); // "2021-07-01T13:00:00"

// You can pass nothing to set the time to midnight
const newDT3 = dt.withPlainTime();
console.log(newDT3.toString()); // "2021-07-01T00:00:00"

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

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

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

• Temporal.PlainDateTime
• Temporal.PlainDateTime.prototype.with()
• Temporal.PlainDateTime.prototype.withCalendar()
• Temporal.PlainDateTime.prototype.toPlainTime()
• Temporal.PlainDateTime.from()