DateTime::modify

date_modify

(PHP 5 >= 5.2.0)

DateTime::modify -- date_modify — Altera la marca temporal

Descripción

Estilo orientado a objetos

public DateTime DateTime::modify ( string $modify )

Estilo por procedimientos

DateTime date_modify ( DateTime $object , string $modify )

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ían:

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