DateTime::modify
date_modify
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTime::modify -- date_modify - Зміна тимчасової мітки
Опис
Об'єктно-орієнтований стиль
public DateTime::modify(string $modifier): DateTime|false
Процедурний стиль
date_modify(DateTime $object, string $modifier): DateTime|false
Змінює мітку часу об'єкта DateTime шляхом додавання або віднімання часу у форматі, прийнятому для функції DateTimeImmutable::__construct()
Список параметрів
object
Тільки для процедурного стилю: об'єкт DateTime, що повертається date_create(). Функція змінює цей об'єкт.
modifier
Рядок дати/часу. Пояснення коректних форматів наведено в розділі Формати дати та часу
Значення, що повертаються
Повертає модифікований об'єкт DateTimeдля применения в цепи методов или**false**в случае возникновения ошибки.
Помилки
Тільки для об'єктно-орієнтованого API: Якщо передано рядок з неприпустимою датою/часом, буде викинуто виняток DateMalformedStringException
список змін
| Версия | Опис |
|---|---|
| 8.3.0 | Тепер замість попередження у методі DateTime::modify() викидається виняток DateMalformedStringException, якщо передано неприпустимий рядок. Функція date_modify() не було змінено. |
Приклади
Приклад #1 Приклад використання DateTime::modify()****
Об'єктно-орієнтований стиль
Процедурний стиль
Результат виконання наведених прикладів:
2006-12-13
Приклад #2 Будьте обережні при додаванні та відніманні місяців
Результат виконання наведеного прикладу:
2001-01-31
2001-03-03
Приклад #3 Підтримуються всі формати дати та часу
Результат виконання наведеного прикладу:
2023-07-01 00:00
2023-07-03 00:00
2023-07-03 17:30
Дивіться також
- strtotime() - Перетворює текстове подання дати англійською мовою на мітку часу Unix
- DateTimeImmutable::modify() - Створює новий об'єкт із зміненою тимчасовою міткою
- DateTime::add() - Змінює об'єкт DateTime, додаючи кількість днів, місяців, років, годин, хвилин та секунд
- DateTime::sub() - Віднімає дні, місяці, роки, години, хвилини та секунди з об'єкта DateTime
- DateTime::setDate() - Встановлює дату
- DateTime::setISODate() - Встановлює дату у форматі ISO
- DateTime::setTime() - Встановлює час
- DateTime::setTimestamp() - Встановлює дату та час на основі мітки часу Unix