Temporal.PlainTime.prototype.subtract()

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

Если вы хотите вычесть два времени и получить продолжительность, используйте since() или until() вместо этого.

Синтаксис

subtract(duration)

Параметры

duration

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

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

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

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

Примеры

Вычитание продолжительности

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

Дополнительные примеры см. в add().

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

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

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

• Temporal.PlainTime
• Temporal.Duration
• Temporal.PlainTime.prototype.add()
• Temporal.PlainTime.prototype.since()
• Temporal.PlainTime.prototype.until()