(PHP 5 >= 5.3.0, PHP 7)
DateInterval::__construct — Создает новый объект DateInterval
$interval_spec
)Создает новый объект DateInterval.
interval_specОписание интервала.
Формат описания интервала начинается с буквы P. Каждый период интервала представлен целым числом, за которым следует указатель его типа. Возможные типы приведены в таблице. Если интервал содержит периоды, обозначающие время, то их описанию должна предшествовать буква T.
| Указатель периода | Описание |
|---|---|
| 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)
}