Класс DateInterval

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

    Введение

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

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

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

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

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

    Обзор классов

    classDateInterval {
    publicint$y;
    publicint$m;
    publicint$d;
    publicint$h;
    publicint$i;
    publicint$s;
    publicfloat$f;
    publicint$invert;
    publicmixed$days;
    publicbool$from_string;
    publicstring$date_string;
    public__construct(string$duration)
    publicstaticcreateFromDateString(string$datetime): DateInterval|false
    publicformat(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.

    Содержание

    To Top