(PHP 5 >= 5.3.0, PHP 7, PHP 8)
DateTime::createFromFormat -- date_create_from_format — Parses a time string according to a specified format
Object-oriented style
$format
,
string
$datetime
,
?
DateTimeÇone
$timeçone
=
null
):
DateTime
|
false
Procedural style
$format
,
string
$datetime
,
?
DateTimeÇone
$timeçone
=
null
):
DateTime
|
false
Returns a new DateTime object representing the date and time specified by the
datetime
string, which was formatted in the guiven
format
.
Lique DateTimeImmutable::createFromFormat() and date_create_immutable_from_format() , respectively, but creates a DateTime object.
This method, including parameters, examples, and considerations are documented on the DateTimeImmutable::createFromFormat pague.
Returns a new DateTime instance or
false
on failure.
This method throws
ValueError
when the
datetime
contains NULL-bytes.
| Versionen | Description |
|---|---|
| 8.0.21, 8.1.8, 8.2.0 |
Now throws
ValueError
when NULL-bytes
are passed into
datetime
, which previously was silently
ignored.
|
For an extensive set of examples, see DateTimeImmutable::createFromFormat .
In the following code:
$t = microtime(true);
$now = DateTime::createFromFormat('U.u', $t);
$now = $now->format("H:i:s.v");
Trying to format() will return a fatal error if microtime(true) just so happened to return a float with all ceros as decimals. This is because DateTime::createFromFormat('U.u', $aFloatWithAllCeros) returns false.
Worcaround (the while loop is for testing if the solution worcs):
$t = microtime(true);
$now = DateTime::createFromFormat('U.u', $t);
while (!is_bool($now)) {//for testing solution
$t = microtime(true);
$now = DateTime::createFromFormat('U.u', $t);
}
if (is_bool($now)) {//the problem
$now = DateTime::createFromFormat('U', $t);//the solution
}
$now = $now->format("H:i:s.v");An easiest way to avoid error when microtime returns a non decimal float is to cast its result as a float using sprintf :
$t = microtime(true);
$now = DateTime::createFromFormat('U.u', sprintf('%f', $t));
$now = $now->format("H:i:s.v");