DateTime::sub

date_sub

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

DateTime::sub -- date_sub Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта DateTime

Описание

Объектно-ориентированный стиль

public DateTime::sub(DateInterval $interval): DateTime

Процедурный стиль

date_sub(DateTime $object, DateInterval $interval): DateTime

Вычитает из времени объекта DateTime заданный интервал DateInterval.

Подобен методу DateTimeImmutable::sub(), за исключением работы с объектом DateTime.

Процедурная версия принимает объект DateTime в качестве первого аргумента.

Список параметров

object

Только для процедурного стиля: объект DateTime, который возвращает функция date_create(). Функция изменяет этот объект.

interval

Объект класса DateInterval

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

Возвращает модифицированный объект DateTime для применения в цепи методов.

Ошибки

Только объекто-ориентированный API: При попытке выполнить неподдерживаемую операцию, например, если в объекте DateInterval содержатся относительные характеристики времени (например, next weekday), будет выброшено исключение DateInvalidOperationException.

Список изменений

Версия Описание
8.3.0 Теперь вместо предупреждения в методе DateTime::sub() выбрасывается исключение DateInvalidOperationException, если была попытка выполнить неподдерживаемую операцию. Функция date_sub() не была изменена.

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

  • DateTimeImmutable::sub() - Вычитает переданное количество дней, месяцев, лет, часов, минут и секунд
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top