DateTime::modify

date_modify

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

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

Descripción

Estilo orientado a objetos

Estilo procedimental

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

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

2006年12月13日

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

2006年12月13日

<?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";

2001年01月31日
2001年03月03日

<?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";

2023年07月01日 00:00
2023年07月03日 00:00
2023年07月03日 17:30

Véase también

• strtotime() - Transforma un texto inglés en timestamp
• DateTimeImmutable::modify() - Crea un nuevo objeto con la marca de tiempo modificada
• DateTime::add() - Modifica un objeto DateTime, añadiendo una cantidad de días, meses, años, horas, minutos y segundos
• DateTime::sub() - Sustrae una cantidad de días, meses, años, horas, minutos y segundos de un objeto DateTime
• DateTime::setDate() - Establece la fecha
• DateTime::setISODate() - Establece la fecha ISO
• DateTime::setTime() - Establece la hora
• DateTime::setTimestamp() - Establece la fecha y la hora basándose en una marca temporal de Unix