Класс DateInterval

(PHP 5 >= 5.3.0, PHP 7)

Введение

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

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

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

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

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

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 __construct ( string $duration )

public static createFromDateString ( string $datetime ) : DateInterval|false

public format ( string $format ) : string

}

Свойства

y

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

m

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

d

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

h

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

i

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

s

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

f

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

invert

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

days

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

В версиях PHP до 5.4.20/5.5.4 при доступе к этому свойству вы будете получать -99999 вместо false.

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

Версия	Описание
7.1.0	Добавлено свойство `f`.

Содержание

DateInterval::__construct — Создает новый объект DateInterval
DateInterval::createFromDateString — Создает объект класса DateInterval из даты в относительном формате
DateInterval::format — Форматирует интервал