Temporal.PlainDateTime.prototype.add()

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

Синтаксис

add(duration)
add(duration, options)

Параметры

duration

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

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

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

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

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

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

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

"reject"

Генерируется исключение RangeError, если компонент даты выходит за пределы диапазона.

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

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

Исключения

RangeError

Генерируется, если результат не входит в представимый диапазон, который составляет ±(10⁸ + 1) дней, или около ±273 972,6 лет, от эпохи Unix.

Описание

О том, как добавляются календарные продолжительности, см. Temporal.PlainDate.prototype.add().

Добавление продолжительности эквивалентно вычитанию ее отрицания.

Примеры

Добавление продолжительности

const start = Temporal.PlainDateTime.from("2021-01-01T12:34:56");
const end = start.add({
  years: 1,
  months: 2,
  weeks: 3,
  days: 4,
  hours: 5,
  minutes: 6,
  seconds: 7,
  milliseconds: 8,
});
console.log(end.toString()); // 2022-03-26T17:41:03.008

Дополнительные примеры, особенно того, как различные календари и опция overflow взаимодействуют с календарными продолжительностями, см. Temporal.PlainDate.prototype.add().

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

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

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

• Temporal.PlainDateTime
• Temporal.Duration
• Temporal.PlainDateTime.prototype.subtract()