ConFoo 2025

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() - Вычитает переданное количество дней, месяцев, лет, часов, минут и секунд
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top