(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 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.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');
?>Los ejemplos anteriores mostrarán :
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