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() - Віднімає передану кількість днів, місяців, років, годин, хвилин та секунд