Temporal.PlainTime.prototype.with()

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

Синтаксис

with(info)
with(info, options)

Параметры

info

Объект, содержащий по крайней мере одно из свойств, распознаваемых Temporal.PlainTime.from(): hour, microsecond, millisecond, minute, nanosecond, second. Неуказанные свойства используют значения из исходного времени.

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

Объект, содержащий следующее свойство:

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

Строка, определяющая поведение, когда компонент времени выходит за допустимый диапазон. Возможные значения:

"constrain" (по умолчанию)

Компонент времени привязывается к допустимому диапазону.

"reject"

Выбрасывается RangeError, если компонент времени выходит за допустимый диапазон.

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

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

Исключения

TypeError

Выбрасывается в одном из следующих случаев:

• info не является объектом с по крайней мере одним распознанным свойством или строкой.
• options не является объектом или undefined.

RangeError

Выбрасывается, если предоставленные числовые свойства выходят за допустимый диапазон, и options.overflow установлено в "reject".

Примеры

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

const time = Temporal.PlainTime.from("12:34:56.123456789");
const newTime = time.with({ hour: 23 });
console.log(newTime.toString()); // '23:34:56.123456789'

Для получения дополнительных примеров см. документацию по отдельным свойствам, которые могут быть установлены с помощью with().

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

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

См. также

• Temporal.PlainTime
• Temporal.PlainTime.from()
• Temporal.PlainTime.prototype.add()
• Temporal.PlainTime.prototype.subtract()