Создает новый объект DateInterval


(PHP 5 >= 5.3.0)

DateInterval::__constructСоздает новый объект DateInterval

Описание

public DateInterval::__construct ( string $interval_spec )

Создает новый объект DateInterval.

Список параметров

interval_spec

Описание интервала.

Формат начинается с буквы P, за "период". Длина каждого периода описывается целым значением и следующим за ним указателем периода. Если длина периода содержит время, то его описанию должна предшествовать буква T.

interval_spec Указатели периода
Указатель периода Описание
Y года
M месяцы
D дни
W недели. Преобразуется в дни, поэтому не может быть использован совместно с D.
H часы
M минуты
S секунды

Вот несколько простых примеров. Два дня - P2D. Две секунды - PT2S. Шесть лет и пять минут - P6YT5M.

Замечание:

Указатели должны записываться от большей величины (слева) к меньшей величине (направо). То есть года должны быть до месяцев, месяцы до дней, дни до минут и так далее. Таким образом, один год и четыре дня должны быть представлены как P1Y4D, но не P4D1Y.

Задать период также можно в виде даты и времени. Пример одного года и четырех дней может описываться как P0001-00-04T00:00:00. Но значения в этом формате не должны выходить за рамки допустимых значений даты и времени (т.е., 25 часов недопустимо)

Эти форматы основаны на » спецификации ISO 8601.

Ошибки

Бросает Exception, если interval_spec не может быть разпознан в качестве интервала.

Примеры

Пример #1 Пример использования DateInterval

<?php

$interval 
= new DateInterval('P2Y4DT6H8M');
var_dump($interval);

?>

Результат выполнения данного примера:

 object(DateInterval)#1 (8) {   ["y"]=>   int(2)   ["m"]=>   int(0)   ["d"]=>   int(4)   ["h"]=>   int(6)   ["i"]=>   int(8)   ["s"]=>   int(0)   ["invert"]=>   int(0)   ["days"]=>   bool(false) } 

Смотрите также

  • DateInterval::format() - Форматирует интервал
  • DateTime::add() - Добавляет заданное количество дней, месяцев, лет, часов, минут и секунд к объекту DateTime
  • DateTime::sub() - Вычитает заданное количество дней, месяцев, лет, часов, минут и секунд из времени объекта DateTime
  • DateTime::diff() - Возвращает разницу между двумя DateTime объектами