DateTime::modify

date_modify

(PHP 5 >= 5.2.0, PHP 7)

DateTime::modify -- date_modifyAltera la marca temporal

Descripción

Estilo orientado a objetos

public DateTime::modify ( string $modify ) : DateTime

Estilo por procedimientos

date_modify ( DateTime $object , string $modify ) : DateTime

Altera la marca temporal de un objeto DateTime aumentando o disminuyendo en un formato aceptado por strtotime().

Parámetros

object

Solamente para el estilo por procedimientos: Un objeto DateTime devuelto por date_create(). La función modifica este objeto.

modify

Una cadena de fecha/hora. Los formatos válidos se explican en Formatos de fecha y hora.

Valores devueltos

Devuelve el objeto DateTime para la cadena de métodos o FALSE en caso de error.

Historial de cambios

Versión Descripción
5.3.6 Las sentencias de fecha/hora absolutas ahora toman efecto. Anteriormente, sólo se utilizaban las partes relativas.
5.3.0Se ha cambiado el valor devuelto en caso de éxito de NULL a DateTime.

Ejemplos

Ejemplo #1 Ejemplo de DateTime::modify()

Estilo orientado a objetos

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

Estilo por procedimientos

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

El resultado de los ejemplos sería:

2006-12-13

Ejemplo #2 Cuidado al añadir o sustraer meses

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

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

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

El resultado del ejemplo sería:

2001-01-31
2001-03-03

Ver también