DateTimeZone::listIdentifiers improvements

php/doc-en@c018a4d

Author: mumumu

reference/datetime/datetimezone/listidentifiers.xml

@@ -1,8 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: takagi Status: ready -->
-<!-- Credits: mumumu -->
-
+<!-- EN-Revision:  c018a4d2c85ac429f238f78679eca46d86c63a31Maintainer: mumumu Status: ready -->
 <refentry xml:id="datetimezone.listidentifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateTimeZone::listIdentifiers</refname>
@@ -23,6 +21,20 @@
    <methodparam choice="opt"><type>int</type><parameter>timezoneGroup</parameter><initializer>DateTimeZone::ALL</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>countryCode</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
+  <simpara>
+   <link xlink:href="&url.wiki.tzdb.names;">IANA Time Zone identifiers</link> の一覧を返します。
+  </simpara>
+
+  <note>
+   <simpara>
+    <link xlink:href="&url.js.intl-datetimeformat;">Intl.DateTimeFormat</link>
+    や
+    <link xlink:href="&url.js.temporal-zoneddatetime;">Temporal.ZonedDateTime</link>
+    を使うと、
+    JavaScript でクライアント(ブラウザ) のタイムゾーンを検知することができます。
+   </simpara>
+  </note>
+
  </refsect1>
 
  <refsect1 role="parameters">
@@ -65,7 +77,7 @@
    <literal>DateTimeZone::ALL_WITH_BC</literal> を指定します。
   </para>
  </refsect1>
-
+ 
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -100,25 +112,28 @@
   &reftitle.examples;
   <para>
    <example>
-    <title><methodname>DateTimeZone::listIdentifiers</methodname> の例</title>
+    <title>地域のコメントを付けて、識別子の一覧を取得する</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-$timezone_identifiers = DateTimeZone::listIdentifiers();
-for ($i=0; $i < 5; $i++) {
-    echo "$timezone_identifiers[$i]\n";
+$identifiers = DateTimeZone::listIdentifiers(DateTimeZone::ALL);
+
+foreach ($identifiers as $tzid) {
+    $tz = new DateTimeZone($tzid);
+    $comments = $tz->getLocation()['comments'];
+    echo $tzid . " (" . ($comments ?: 'Whole region') . ")\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
     <screen>
 <![CDATA[
-Africa/Abidjan
-Africa/Accra
-Africa/Addis_Ababa
-Africa/Algiers
-Africa/Asmara
+America/Antigua (Whole region)
+America/Araguaina (Tocantins)
+America/Argentina/Buenos_Aires (Buenos Aires (BA, CF))
+America/Argentina/Catamarca (Catamarca (CT), Chubut (CH))
+America/Argentina/Cordoba (Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF))
+// (Output trimmed due to length)
 ]]>
     </screen>
    </example>
@@ -134,7 +149,6 @@ $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA );
 for ($i=0; $i < 5; $i++) {
     echo "$timezone_identifiers[$i]\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
@@ -158,7 +172,6 @@ Asia/Aqtau
 <?php
 $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA | DateTimeZone::PACIFIC );
 echo join( ', ', $timezone_identifiers );
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
@@ -205,7 +218,6 @@ $timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::PER_COUNTRY
 foreach( $timezone_identifiers as $identifier ) {
     echo "$identifier\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;