(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::modify — Crea un nuevo objeto con la marca de tiempo modificada
$modifier): DateTimeImmutableCrea un nuevo objeto DateTimeImmutable con la marca de tiempo modificada. El objeto original no se modifica.
modifierUna cadena de fecha/hora. Los formatos válidos son explicados en la documentación sobre los formatos de Fecha y Hora.
Devuelve DateTimeImmutable en caso de éxito.
Estilo procedimental retorna false en caso de error.
Si se pasa una cadena de Fecha/Hora no válida, se lanza DateMalformedStringException. Antes de PHP 8.3, esto emitía una advertencia.
| Versión | Descripción |
|---|---|
| 8.4.0 | Ahora tiene un tipo de retorno tentativo de DateTimeImmutable. Anteriormente era DateTimeImmutable|false. |
| 8.3.0 |
DateTimeImmutable::modify() ahora lanzará
DateMalformedStringException si es pasada
una cadena no válida. Anteriormente, devolvía false,
y se emitía una advertencia.
|
Ejemplo #1 Ejemplo de DateTimeImmutable::modify()
Estilo orientado a objetos
<?php
$date = new DateTimeImmutable('2006-12-12');
$newDate = $date->modify('+1 day');
echo $newDate->format('Y-m-d');El ejemplo anterior mostrará:
2006-12-13
Ejemplo #2 Tenga cuidado al añadir o restar meses
<?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";El ejemplo anterior mostrará:
2001-01-31 2001-03-03