(PHP 5 >= 5.5.0, PHP 7, PHP 8)
DateTimeImmutable::modify — Crea un nuevo objeto con la marca de tiempo modificada
$modifier): DateTimeImmutable 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.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日