Класс DateInterval

&reftitle.intro; Представляет интервалы дат. Интервал дат хранит либо определённое фиксированное время (в годах, месяцах, днях, часах и т.д.) или относительную строку времени в формате, поддерживаемом конструктором DateTimeImmutable и DateTime. Более конкретно, информация в объекте класса DateInterval является инструкцией для перехода от одной даты/времени к другой дате/времени. Этот процесс не всегда обратим. Распространённым способом создания объекта DateInterval является вычисление разницы между двумя объектами даты/времени с помощью DateTimeInterface::diff. Поскольку не существует чётко определённого способа сравнения интервалов дат, экземпляры DateInterval являются несравнимыми.

&reftitle.classsynopsis; DateInterval &Properties; 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 &Methods;

&reftitle.properties; Доступные свойства, перечисленные ниже, зависят от версии 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.

&reftitle.changelog; &Version; &Description; 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.