DateTimeImmutable::modify

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

DateTimeImmutable::modify — Створює новий об'єкт із зміненою тимчасовою міткою

Опис

public DateTimeImmutable::modify(string $modifier): DateTimeImmutable|false

Створює новий об'єкт DateTimeImmutable зі зміненою тимчасовою міткою. Початковий об'єкт не змінюється.

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

modifier

Рядок дати/часу. Пояснення коректних форматів наведено в розділі Формати дати та часу

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

Повертає новий модифікований об'єкт DateTimeImmutable або **false**в случае возникновения ошибки.

Помилки

Якщо передано рядок з неприпустимою датою/часом, викидається виняток DateMalformedStringExceptionДо PHP 8.3 появлялось предупреждение.

список змін

Версия	Опис
8.3.0	Тепер замість попередження викидається виняток DateMalformedStringException, якщо передано неприпустимий рядок.

Приклади

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

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

Loading...
▶

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

2006-12-13

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

Loading...
▶

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

2001-01-31
2001-03-03

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

• DateTimeImmutable::add() - Повертає новий об'єкт з доданою кількістю днів, місяців, років, годин, хвилин та секунд
• DateTimeImmutable::sub() - Віднімає передану кількість днів, місяців, років, годин, хвилин та секунд
• DateTimeImmutable::setDate() - Встановлює дату
• DateTimeImmutable::setISODate() - Встановлює дату у форматі ISO
• DateTimeImmutable::setTime() - Встановлює час
• DateTimeImmutable::setTimestamp() - Встановлює дату та час на основі мітки часу Unix