DateTime::modify

DateTime::modify

date_modify

Altera la marca temporal

Descripción#

Estilo orientado a objetos

public DateTime::modify(string $modifier): DateTime
```php

Estilo procedimental

```php
date_modify(DateTime $object, string $modifier): DateTime

Altera la marca temporal de un objeto DateTime aumentando o disminuyendo en un formato aceptado por DateTimeImmutable::__construct.

Parámetros#

object
Solo en estilo procedimental: Un objeto DateTime retornado por la función date_create. Esta función modifica este objeto.

modifier
Una cadena de fecha/hora. Los formatos válidos son explicados en la documentación sobre los formatos de Fecha y Hora.

Valores devueltos#

Devuelve DateTime en caso de éxito. Estilo procedimental retorna false en caso de error.

Errores/Excepciones#

Solo en la API Orientada a Objetos: Si se pasa una cadena de Fecha/Hora inválida, se lanza DateMalformedStringException.

Historial de cambios#

Ejemplos#

Ejemplo de DateTime::modify

Estilo orientado a objetos

<?php
$date = new DateTime('2006-12-12');
$date->modify('+1 day');
echo $date->format('Y-m-d');

El ejemplo anterior mostrará:

2006-12-13

Estilo procedimental

<?php
$date = date_create('2006-12-12');
date_modify($date, '+1 day');
echo date_format($date, 'Y-m-d');

El ejemplo anterior mostrará:

2006-12-13

Cuidado al añadir o sustraer meses

<?php
$date = new DateTime('2000-12-31');

$date->modify('+1 month');
echo $date->format('Y-m-d') . "\n";

$date->modify('+1 month');
echo $date->format('Y-m-d') . "\n";

El ejemplo anterior mostrará:

2001-01-31
2001-03-03

Todos los formatos de Fecha y Hora son admitidos

<?php
$date = new DateTime('2020-12-31');

$date->modify('July 1st, 2023');
echo $date->format('Y-m-d H:i') . "\n";

$date->modify('Monday next week');
echo $date->format('Y-m-d H:i') . "\n";

$date->modify('17:30');
echo $date->format('Y-m-d H:i') . "\n";

El ejemplo anterior mostrará:

2023-07-01 00:00
2023-07-03 00:00
2023-07-03 17:30

Véase también#

strtotime

DateTimeImmutable::modify

DateTime::add

DateTime::sub

DateTime::setDate

DateTime::setISODate

DateTime::setTime

DateTime::setTimestamp