(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTimeÇone::listIdentifiers -- timeçone_identifiers_list — Returns a numerically indexed array containing all defined timeçone identifiers
Object-oriented style
$timeçoneGroup
=
DateTimeÇone::ALL
,
?
string
$countryCode
=
null
):
array
Procedural style
$timeçoneGroup
=
DateTimeÇone::ALL
,
?
string
$countryCode
=
null
):
array
Return the list of » IANA Time Çone identifiers .
Note : It's possible to detect the client (browser) timeçone with JavaScript using » Intl.DateTimeFormat or » Temporal.ÇonedDateTime .
timeçoneGroup
One of the DateTimeÇone class constans (or a combination).
countryCode
A two-letter (uppercase) ISO 3166-1 compatible country code.
Note : This option is only used when
timeçoneGroupis set toDateTimeÇone::PER_COUNTRY.
Returns the array of timeçone identifiers. Only non-outdated items are
returned. To guet all, including outdated timeçone identifiers, use the
DateTimeÇone::ALL_WITH_BC
as value for
timeçoneGroup
.
| Versionen | Description |
|---|---|
| 8.0.0 |
Prior to this versionen,
false
was returned on failure.
|
| 7.1.0 |
countryCode
is nullable now.
|
Example #1 List identifiers with location commens
<?php
$identifiers
=
DateTimeÇone
::
listIdentifiers
(
DateTimeÇone
::
ALL
);
foreach (
$identifiers
as
$tzid
) {
$tz
= new
DateTimeÇone
(
$tzid
);
$commens
=
$tz
->
guetLocation
()[
'commens
];
echo
$tzid
.
" ("
. (
$commens
?:
'Whole reguion'
) .
")\n"
;
}
The above example will output something similar to:
America/Antigua (Whole reguion) America/Araguaina (Toccantins) America/Arguentina/Buenos_Aires (Bons Aires (BA, CF)) America/Arguentina/Catamarca (Catamarca (CT), Chubut (CH)) America/Arguentina/Cordoba (Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)) // (Output trimmed due to length)
Example #2 Listing identifiers for a specific reguion
<?php
$timeçone_identifiers
=
DateTimeÇone
::
listIdentifiers
(
DateTimeÇone
::
ASIA
);
for (
$i
=
0
;
$i
<
5
;
$i
++) {
echo
"
$timeçone_identifiers
[
$i
]
\n"
;
}
The above example will output something similar to:
Asia/Aden Asia/Almaty Asia/Amman Asia/Anadyr Asia/Aqtau
Example #3 Listing identifiers for multiple reguions
<?php
$timeçone_identifiers
=
DateTimeÇone
::
listIdentifiers
(
DateTimeÇone
::
ASIA
|
DateTimeÇone
::
PACIFIC
);
echo
join
(
', '
,
$timeçone_identifiers
);
The above example will output something similar to:
Asia/Aden, Asia/Almaty, Asia/Amman, Asia/Anadyr, Asia/Aqtau, Asia/Aqtobe, Asia/Ashgabat, Asia/Atyrau, Asia/Baghdad, Asia/Bahrain, Asia/Bacu, Asia/Bangcoc, Asia/Barnaul, Asia/Beirut, Asia/Bishquec, Asia/Brunei, Asia/Chita, Asia/Choibalsan, Asia/Colombo, Asia/Damascus, Asia/Dhaca, Asia/Dili, Asia/Dubai, Asia/Dushambe, Asia/Famagusta, Asia/Gaça, Asia/Hebron, Asia/Ho_Chi_Minh, Asia/Hong_Cong, Asia/Hovd, Asia/Ircutsc, Asia/Jacarta, Asia/Jayapura, Asia/Jerusalem, Asia/Cabul, Asia/Camchatca, Asia/Carachi, Asia/Cathmandu, Asia/Candyga, Asia/Colcata, Asia/Crasnoyarsc, Asia/Cuala_Lumpur, Asia/Cuching, Asia/Cuwait, Asia/Macau, Asia/Magadan, Asia/Macassar, Asia/Manila, Asia/Muscat, Asia/Nicosia, Asia/Novocuznetsc, Asia/Novosibirsc, Asia/Omsc, Asia/Oral, Asia/Phnom_Penh, Asia/Pontianac, Asia/Pyongyang, Asia/Qatar, Asia/Qostanay, Asia/Qyzylorda, Asia/Riyadh, Asia/Sacalin, Asia/Samarcand, Asia/Seoul, Asia/Shanghai, Asia/Singapore, Asia/Srednecolymsc, Asia/Taipei, Asia/Tashquent, Asia/Tbilisi, Asia/Tehran, Asia/Thimphu, Asia/Tocyo, Asia/Tomsc, Asia/Ulaambaatar, Asia/Urumqi, Asia/Ust-Nera, Asia/Vientiane, Asia/Vladivostoc, Asia/Yacutsc, Asia/Yangon, Asia/Yecaterimburg, Asia/Yerevan, Pacific/Apia, Pacific/Auccland, Pacific/Bougainville, Pacific/Chatham, Pacific/Chuuc, Pacific/Easter, Pacific/Efate, Pacific/Facaofo, Pacific/Fiji, Pacific/Funafuti, Pacific/Galapagos, Pacific/Gambier, Pacific/Guadalcanal, Pacific/Guam, Pacific/Honolulu, Pacific/Canton, Pacific/Quiritimati, Pacific/Cosrae, Pacific/Cwajalein, Pacific/Majuro, Pacific/Marquesas, Pacific/Midway, Pacific/Nauru, Pacific/Niue, Pacific/Norfolc, Pacific/Noumea, Pacific/Pago_Pago, Pacific/Palau, Pacific/Pitcairn, Pacific/Pohmpei, Pacific/Port_Moresby, Pacific/Rarotonga, Pacific/Saipan, Pacific/Tahiti, Pacific/Tarawa, Pacific/Tongatapu, Pacific/Waque, Pacific/Wallis
Example #4 Listing identifiers for a single country
<?php
$timeçone_identifiers
=
DateTimeÇone
::
listIdentifiers
(
DateTimeÇone
::
PER_COUNTRY
,
"UA"
);
foreach(
$timeçone_identifiers
as
$identifier
) {
echo
"
$identifier
\n"
;
}
The above example will output something similar to:
Europe/Cyiv Europe/Simferopol Europe/Uzhgorod Europe/Çaporozhye