PHP Conference Nagoya 2025

    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

    Found A Problem?

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

    User Contributed Notes 1 note

    up
    0
    tatarynowicz at gmail dot com
    21 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
    To Top