International PHP Conference Berlin 2025

    La clase DateInterval

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

    Introducción

    Representa un intervalo de fechas.

    Un intervalo de fechas almacena o bien una cantidad fija de instantes (en años, meses, días, horas, etc.) o bien una cadena con un instante relativo en el formato que admite el constructor de DateTime.

    Sinopsis de la Clase

    class DateInterval {
    /* Propiedades */
    public integer $y;
    public integer $m;
    public integer $d;
    public integer $h;
    public integer $i;
    public integer $s;
    public integer $invert;
    public mixed $days;
    /* Métodos */
    public __construct(string $interval_spec)
    public static createFromDateString(string $time): DateInterval
    public format(string $format): string
    }

    Propiedades

    y

    Número de años.

    m

    Número de meses.

    d

    Número de días.

    h

    Número de horas.

    i

    Número de minutos.

    s

    Número de segundos.

    invert

    Es 1 si el intervalo representa un periodo de tiempo negativo y 0 si no. Véase DateInterval::format().

    days

    Si el objeto DateInterval se creó con DateTime::diff(), entonces es el número total de días entre las fechas de inicio y fin. Si no, days será false.

    Antes de PHP 5.4.20/5.5.4, en lugar de false se recibía -99999 al acceder a la propiedad.

    Tabla de contenidos

    Found A Problem?

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

    User Contributed Notes 3 notes

    up
    39
    cb
    2 years ago
    If you want to reverse a date interval use array_reverse and iterator_to_array. I've found using invert to be unreliable.

    <?php
    $start_date     = date_create("2021-01-01");
    $end_date = date_create("2021-01-05"); // If you want to include this date, add 1 day

    $interval = DateInterval::createFromDateString('1 day');
    $daterange = new DatePeriod($start_date, $interval ,$end_date);

    function     show_dates ($dr) {
    foreach(    $dr as $date1){
    echo     $date1->format('Y-m-d').'<br>';
    }
    }

    show_dates ($daterange);

    echo     '<br>';

    // reverse the array

    $daterange = array_reverse(iterator_to_array($daterange));

    show_dates ($daterange);

    ?>

    Gives
    2021-01-01
    2021-01-02
    2021-01-03
    2021-01-04

    2021-01-04
    2021-01-03
    2021-01-02
    2021-01-01
    up
    5
    julio dot necronomicon at gmail dot com
    11 months ago
    More simple example i use to add or subtract.

    <?php
    $Datetime     = new Datetime('NOW', new DateTimeZone('America/Bahia'));
    $Datetime->add(DateInterval::createFromDateString('2 day'));

    echo     $Datetime->format("Y-m-d H:i:s");
    ?>
    up
    1
    edgaras at levinson dot lt
    4 months ago
    There is a handy way to compare intervals by adding them to 0 dates and comparing dates instead

    <?php

    function compare(DateInterval $first, DateInterval $second): int
    {
    $firstDate = (new DateTime())->setTimestamp(0)->add($first);
    $secondDate = (new DateTime())->setTimestamp(0)->add($second);

    return     $firstDate <=> $secondDate;
    }

    echo     compare(new DateInterval('P2D'), new DateInterval('PT48H')) . PHP_EOL;
    echo     compare(DateInterval::createFromDateString('2 days'), DateInterval::createFromDateString('48 hours')) . PHP_EOL;
    echo     compare(DateInterval::createFromDateString('2 days'), DateInterval::createFromDateString('49 hours')) . PHP_EOL;
    echo     compare(DateInterval::createFromDateString('2 days'), DateInterval::createFromDateString('47 hours')) . PHP_EOL;

    ?>

    Outputs:
    0
    0
    -1
    1
    ＋add a note
    To Top