php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #47899 DateTimeZone::listIdentifiers() documentation is ambigious
Submitted: 2009-04-05 12:15 UTC Modified: 2009-06-21 20:42 UTC
Votes:1
Avg. Score:3.0 ± 0.0
Reproduced:1 of 1 (100.0%)
Same Version:1 (100.0%)
Same OS:0 (0.0%)
From: hackwar at freenet dot de Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: Windows
Private report: No CVE-ID: None
View Developer Edit
 [2009-04-05 12:15 UTC] hackwar at freenet dot de 
Description:
------------
In the documentation, this function is marked as being available from 5.3.0 upwards, but it already works in my 5.2.8 shipped with the WAMP stack from XAMPP: http://us2.php.net/manual/de/datetimezone.listidentifiers.php

Since I want to use this function for a larger open source project which needs to be compatible from 5.2.0 onwards, I need to know if this is a glitch in my PHP 5.2.8 or if the documentation is broken, in which case I need to find another way to solve my issue. :-)

Thanks for your help.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2009-04-14 22:19 UTC] bj at treelinegroup dot com 
In addition to the comment above, the whole DateTime OO section of the documentation is very poorly written and confusing. For example, DateTimeZone::listIdentifiers() is identified as only PHP >= 5.3.0, however the function itself works in 5.2.8. However, the function prototype listed on the detail page for this class apparently does not work, and since there is no BC information on these pages, there is no way to know what the function prototype actually is prior to 5.3.0. It also lists class constants that are available here, but they do not work in 5.2.8 which is problematic when trying to use the documentation.
 [2009-06-21 20:42 UTC] bjori@php.net 
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved. 		Last updated: Tue Oct 06 08:00:02 2026 UTC