Doc #69499 [Ver]: DateTime::createFromFormat() documentation doesn't mention that '+' (and '|') mo
| From: | cmb@php.net | Date: | Thu, 03 Sep 2015 23:54:46 +0000 |
| Subject: | Doc #69499 [Ver]: DateTime::createFromFormat() documentation doesn't mention that '+' (and '|') mo | ||
| References: | 1 | Groups: | php.doc.bugs |
| Request: | Send a blank email to doc-bugs+get-12719@lists.php.net to get a copy of this message | ||
Edit report at https://bugs.php.net/bug.php?id=69499&edit=1
ID: 69499
Updated by: cmb@php.net
Reported by: antrik at users dot sf dot net
Summary: DateTime::createFromFormat() documentation doesn't
mention that '+' (and '|') mo
Status: Verified
Type: Documentation Problem
Package: Date/time related
PHP Version: Irrelevant
-Assigned To:
+Assigned To: cmb
Block user comment: N
Private report: N
New Comment:
I have to correct myself. The + modifier is available as of PHP
5.3.9 indeed, what has to be documented. However, the | modifier
is available as of PHP 5.3.0, but due to a bug didn't work
correctly in a trailing position until PHP 5.3.7. Usually we don't
document behavior caused by bugs in the manual proper, but
respective information is available via the changelog.
Previous Comments:
------------------------------------------------------------------------
[2015-04-22 12:19:57] cmb@php.net
Thank you for your bug report. Indeed, the | format character is
available as of PHP 5.3.7[1], and the + format character is
available as of PHP 5.3.9[2].
[1] <http://3v4l.org/8hIvc>
[2] <http://3v4l.org/B16M6>
------------------------------------------------------------------------
[2015-04-21 20:19:23] antrik at users dot sf dot net
Description:
------------
---
From manual page: http://www.php.net/datetime.createfromformat
---
The manual page doesn't mention anywhere that the '+' and '|' modifiers are
not
available in older PHP versions, including at least 5.3.3. (There is a
user-contributed note mentioning that '|' works starting with 5.3.7 -- might be
same for '+'?.) This should be mentioned in the descriptions of these
modifiers, and/or in the changelog. It cost us several hours figuring out why
our code fails mysteriously for one of our users...
------------------------------------------------------------------------
--
Edit this bug report at https://bugs.php.net/bug.php?id=69499&edit=1