array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'datetime.sub.php', 1 => 'DateTime::sub', 2 => 'Вычитает дни, месяцы, годы, часы, минуты и секунды из объекта DateTime', ), 'up' => array ( 0 => 'class.datetime.php', 1 => 'DateTime', ), 'prev' => array ( 0 => 'datetime.settimezone.php', 1 => 'DateTime::setTimezone', ), 'next' => array ( 0 => 'class.datetimeimmutable.php', 1 => 'DateTimeImmutable', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/datetime/sub.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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() не изменилась.

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