DateTime::add

date_add

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

DateTime::add -- date_add — Añade una cantidad de días, meses, años, horas, minutos y segundos a un objeto DateTime

Descripción

Estilo orientado a objetos

public DateTime::add(DateInterval $interval): DateTime

Estilo por procedimientos

date_add(DateTime $object, DateInterval $interval): DateTime

Añade el objeto DateInterval especificado al objeto DateTime especificado.

Parámetros

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

Valores devueltos

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

Ejemplos

Ejemplo #1 Ejemplo de DateTime::add()

Estilo orientado a objetos

<?php
$fecha = new DateTime('2000-01-01');
$fecha->add(new DateInterval('P10D'));
echo $fecha->format('Y-m-d') . "\n";
?>

Estilo por procedimientos

<?php
$fecha = date_create('2000-01-01');
date_add($fecha, date_interval_create_from_date_string('10 days'));
echo date_format($fecha, 'Y-m-d');
?>

El resultado de los ejemplos sería:

2000-01-11

Ejemplo #2 Más ejemplos de DateTime::add()

<?php
$fecha= new DateTime('2000-01-01');
$fecha->add(new DateInterval('PT10H30S'));
echo $date->format('Y-m-d H:i:s') . "\n";

$fecha = new DateTime('2000-01-01');
$fecha->add(new DateInterval('P7Y5M4DT4H3M2S'));
echo $fecha->format('Y-m-d H:i:s') . "\n";
?>

El resultado del ejemplo sería:

2000-01-01 10:00:30
2007-06-05 04:03:02

Ejemplo #3 Cuidado al añadir meses

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

$fecha->add($intervalo);
echo $fecha->format('Y-m-d') . "\n";

$fecha->add($intervalo);
echo $fecha->format('Y-m-d') . "\n";
?>

El resultado del ejemplo sería:

2001-01-31
2001-03-03

Notas

DateTime::modify() es una alternativa cuando se utiliza PHP 5.2.

Ver también

DateTime::sub() - Sustrae una cantidad de días, meses, años, horas, minutos y segundos de un objeto DateTime
DateTime::diff() - Devuelve la diferencia entre dos objetos DateTime
DateTime::modify() - Altera la marca temporal

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

tatarynowicz at gmail dot com ¶

2 days ago

Depending on what your use case is, adding months might or might not give you the correct result.

// Prints "2024-03-02" instead of "2024-02-29"
print Date::fromString('2024-01-31T10:00:00')
  ->add(new DateInterval('P1M0D')
  ->format('Y-m-d');

＋add a note