(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::sub -- date_sub — Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта 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() не была изменена. |