DateInterval::createFromDateString
(PHP 5 >= 5.3.0)
DateInterval::createFromDateString — Создает объект класса DateInterval, используя данные из переданной строки
Описание
Разбирает строку содержащую временной интервал в обычном (удобочитаемом) виде и создает на его основе объект класса DateInterval.
Список параметров
-
time -
Дата состоящая из относительных временных фрагментов. Точнее из частей записанных в относительном формате, который поддерживается анализатором функций strtotime() и DateTime и с помощью которого создаются объекты DateInterval.
Примеры
Пример #1 Анализ и разбор временных интервалов
<?php
// Интервалы в каждом примере эквивалентны.
$i = new DateInterval('P1D');
$i = DateInterval::createFromDateString('1 day');
$i = new DateInterval('P2W');
$i = DateInterval::createFromDateString('2 weeks');
$i = new DateInterval('P3M');
$i = DateInterval::createFromDateString('3 months');
$i = new DateInterval('P4Y');
$i = DateInterval::createFromDateString('4 years');
$i = new DateInterval('P1Y1D');
$i = DateInterval::createFromDateString('1 year + 1 day');
$i = new DateInterval('P1DT12H');
$i = DateInterval::createFromDateString('1 day + 12 hours');
$i = new DateInterval('PT3600S');
$i = DateInterval::createFromDateString('3600 seconds');
?>
Возвращаемые значения
Возвращает новый объект класса DateInterval.
Коментарии
DateInterval::createFromDateString ( string $time )
When the manual says "Uses the normal date parsers" it means that this function cannot take $time = ISO8601 strings like "P7D". If you want to use those, you must use the constructor.
Unlike the DateInterval constructor, this method will accept negative values, so this works:
$di = DateInterval::createFromDateString('1 year - 10 days');
/* Stored as 1 year, -10 days */
Weeks are always converted to days and added to any days specified. As far as I can tell, this is the only calculation done by the method. Somewhat surprisingly, this works (though obviously it would be a poor coding practice):
$di = DateInterval::createFromDateString('62 weeks + 1 day + 2 weeks + 2 hours + 70 minutes');
/* Stored as 0 years, 449 days, 2 hours, 70 minutes */