...

...

@@ -9,15 +9,25 @@

9

9

<refsect1 role="description">

10

10

&reftitle.description;

11

11

<para>&style.oop;</para>

12

-

<methodsynopsis role="oop">

12

+

<methodsynopsis role="DateTimeZone">

13

13

<modifier>public</modifier> <modifier>static</modifier> <type>array</type><methodname>DateTimeZone::listAbbreviations</methodname>

14

14

<void/>

15

15

</methodsynopsis>

16

16

<para>&style.procedural;</para>

17

-

<methodsynopsis role="procedural">

17

+

<methodsynopsis>

18

18

<type>array</type><methodname>timezone_abbreviations_list</methodname>

19

19

<void/>

20

20

</methodsynopsis>

21

+

<para>

22

+

The returned list of abbreviations includes all historical use of

23

+

abbreviations, which can lead to correct, but confusing entries.

24

+

There are also conflicts, as <literal>PST</literal> is used both in the US

25

+

and in the Philippines.

26

+

</para>

27

+

<para>

28

+

The list that this function returns is therefore not suitable for building

29

+

an array with options to present a choice of timezone to users.

30

+

</para>

21

31

<note>

22

32

<para>

23

33

The data for this function are precompiled for performance reasons, and are not updated

24

34