(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::modify — Crea un nuevo objeto con la marca de tiempo modificada
Crea 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 se explican en Formatos de fecha y hora.
Devuelve DateTimeImmutable en caso de éxito.
Estilo por procedimientos devuelve 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.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 resultado de los ejemplos sería:
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 resultado del ejemplo sería:
2001-01-31 2001-03-03