PHP 8.4.2 Released!

    Класс DateInterval

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

    Введение

    Представляет интервалы дат.

    Интервал дат хранит либо определённое фиксированное время (в годах, месяцах, днях, часах и т.д.) или относительную строку времени в формате, поддерживаемом конструктором DateTimeImmutable и DateTime.

    Более конкретно, информация в объекте класса DateInterval является инструкцией для перехода от одной даты/времени к другой дате/времени. Этот процесс не всегда обратим.

    Распространённым способом создания объекта DateInterval является вычисление разницы между двумя объектами даты/времени с помощью DateTimeInterface::diff().

    Поскольку не существует чётко определённого способа сравнения интервалов дат, экземпляры DateInterval являются несравнимыми.

    Обзор класса

    class DateInterval {
    /* Свойства */
    public int $y;
    public int $m;
    public int $d;
    public int $h;
    public int $i;
    public int $s;
    public float $f;
    public int $invert;
    public mixed $days;
    public bool $from_string;
    public string $date_string;
    /* Методы */
    public __construct(string $duration)
    public static createFromDateString(string $datetime): DateInterval
    public format(string $format): string
    }

    Свойства

    Внимание

    Доступные свойства, перечисленные ниже, зависят от версии PHP и должны рассматриваться как доступные только для чтения.

    y

    Количество лет.

    m

    Количество месяцев.

    d

    Количество дней.

    h

    Количество часов.

    i

    Количество минут.

    s

    Количество секунд.

    f

    Количество микросекунд в виде долей секунды.

    invert

    Принимает 1, если интервал представляет отрицательный период времени и 0 в противном случае. Смотрите DateInterval::format().

    days

    Если объект DateInterval создан методом DateTimeImmutable::diff() или DateTime::diff(), то это общее количество полных дней между начальной и конечной датами В противном случае days примет значение false.

    from_string

    Если объект DateInterval был создан методом DateInterval::createFromDateString(), то значение свойства будет true и свойство date_string будет заполнено. В противном случае значение свойства будет false и свойства от y до f, invert и days будут заполнены.

    date_string

    Строка, используемая в качестве аргумента метода DateInterval::createFromDateString().

    Список изменений

    Версия Описание
    8.2.0 Добавлены свойства from_string и date_string для экземпляров DateInterval, которые были созданы с помощью метода DateInterval::createFromDateString().
    8.2.0 Будут видны только значения от y до f, invert и days.
    7.4.0 Экземпляры DateInterval теперь несравнимы; ранее все экземпляры DateInterval считались равными.
    7.1.0 Добавлено свойство f.

    Содержание

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 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
    ＋Добавить
    To Top