Temporal.PlainTime.prototype.add()

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

Синтаксис

add(duration)

Параметры

duration

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

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

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

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

Примеры

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

const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 1, minutes: 30 });
console.log(end.toString()); // 14:04:56

const end2 = start.add({ hours: -1, minutes: -30 });
console.log(end2.toString()); // 11:04:56

const distance = Temporal.PlainTime.from("00:00:00").until("01:23:45"); // 1h 23m 45s
const end3 = start.add(distance);
console.log(end3.toString()); // 13:58:41

Перенос времени

Если время переходит через полночь, оно переносится на следующий день:

const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 12 });
console.log(end.toString()); // 00:34:56

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

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

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

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