CakeFest 2024: The Official CakePHP Conference

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()

Объектно-ориентированный стиль

<?php
$date
= new DateTimeImmutable('2006-12-12');
$newDate = $date->modify('+1 day');
echo
$newDate->format('Y-m-d');
?>

Результат выполнения приведённых примеров:

2006-12-13

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

<?php
$date
= new DateTimeImmutable('2000-12-31');

$newDate1 = $date->modify('+1 month');
echo
$newDate1->format('Y-m-d') . "\n";

$newDate2 = $newDate1->modify('+1 month');
echo
$newDate2->format('Y-m-d') . "\n";
?>

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

2001-01-31
2001-03-03

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top