DateTimeImmutable::modify

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

DateTimeImmutable::modify — Создаёт новый объект с изменённой временной меткой

Описание

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

Создаёт новый объект DateTimeImmutable с изменённой временной меткой. Первоначальный объект не изменяется.

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

modifier

Строка даты/времени. Объяснение корректных форматов дано в разделе Форматы даты и времени.

Возвращаемые значения

Возвращает новый модифицированный объект DateTimeImmutable или false в случае возникновения ошибки.

Примеры

Пример #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

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