[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] [doc-en] master: Fixed bug #66510: Clarify the return values of DateTimeZone::listAbbrevia
From:       Derick Rethans <noreply () php ! net>
Date:       2022-05-13 14:20:43
Message-ID: G2etF5co2msgNb8DufUEpd8j2KKSNyOzYNrz0ZhBEs () main ! php ! net
[Download RAW message or body]

Author: Derick Rethans (derickr)
Date: 2022-05-13T15:15:43+01:00

Commit: https://github.com/php/doc-en/commit/fd8fcbcd6f1e2482e32bb544bbc23b8dc154bb91
Raw diff: https://github.com/php/doc-en/commit/fd8fcbcd6f1e2482e32bb544bbc23b8dc154bb91.diff


Fixed bug #66510: Clarify the return values of DateTimeZone::listAbbreviations

Changed paths:
  M  reference/datetime/datetimezone/listabbreviations.xml


Diff:

diff --git a/reference/datetime/datetimezone/listabbreviations.xml \
b/reference/datetime/datetimezone/listabbreviations.xml index \
                4b55ad143d4..85f071048b8 100644
--- a/reference/datetime/datetimezone/listabbreviations.xml
+++ b/reference/datetime/datetimezone/listabbreviations.xml
@@ -18,6 +18,16 @@
    <type>array</type><methodname>timezone_abbreviations_list</methodname>
    <void/>
   </methodsynopsis>
+  <para>
+   The returned list of abbreviations includes all historical use of
+   abbreviations, which can lead to correct, but confusing entries such as .
+   There are also conflicts, as "pst" is used both in the US and in the
+   Philippines.
+  </para>
+  <para>
+   The list that this function returns is therefore not suitable for building
+   an array with options to present a choice of timezone to users.
+  </para>
   <note>
    <para>
     The data for this function are precompiled for performance reasons, and are not \
updated

-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


[prev in list] [next in list] [prev in thread] [next in thread]