DateTimeImmutable::sub

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

DateTimeImmutable::sub — Віднімає передану кількість днів, місяців, років, годин, хвилин та секунд

Опис

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

Повертає новий об'єкт DateTimeImmutable, в якому зазначений об'єкт DateInterval віднімається із зазначеного об'єкта DateTimeImmutable.

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

object

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

interval

Об'єкт DateInterval

Значення, що повертаються

Повертає новий об'єкт DateTimeImmutable із модифікованими даними.

Помилки

При спробі виконати непідтримувану операцію, наприклад, якщо в об'єкті DateInterval містяться відносні характеристики часу (наприклад, next weekday), буде викинуто виняток.

список змін

Версия	Опис
8.3.0	Тепер при спробі виконати операцію, що не підтримується, замість попередження викидається виняток DateInvalidOperationException

Приклади

Приклад #1 Приклад використання DateTimeImmutable::sub()****

Об'єктно-орієнтований стиль

Loading...
▶

Результат виконання наведених прикладів:

2000-01-10

Приклад #2 Додатковий приклад DateTimeImmutable::sub()

Loading...
▶

Результат виконання наведеного прикладу:

2000-01-19 13:59:30
1992-08-15 19:56:58

Приклад #3 Будьте обережні при відніманні місяців

Loading...
▶

Результат виконання наведеного прикладу:

2001-03-30
2001-03-02

Дивіться також

• DateTimeImmutable::add() - Повертає новий об'єкт з доданою кількістю днів, місяців, років, годин, хвилин та секунд
• DateTimeImmutable::diff() - Повертає різницю між двома об'єктами DateTime
• DateTimeImmutable::modify() - Створює новий об'єкт із зміненою тимчасовою міткою