DateInterval::createFromDateString
(PHP 5 >= 5.3.0)
DateInterval::createFromDateString — Sets up a DateInterval from the relative parts of the string
Description
Uses the normal date parsers and sets up a DateInterval from the relative parts of the parsed string.
Parameters
-
time -
A date with relative parts. Specifically, the relative formats supported by the parser used for strtotime() and DateTime will be used to construct the DateInterval.
Examples
Example #1 Parsing valid date intervals
<?php
// Each set of intervals is equal.
$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');
?>
Return Values
Returns a new DateInterval instance.
Коментарии
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 */