DateTimeZone::listIdentifiers
timezone_identifiers_list
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTimeZone::listIdentifiers -- timezone_identifiers_list — Liefert ein numerisch indiziertes Array, das alle definierten Bezeichner der Zeitzonen enthält
Beschreibung
Objektorientierter Stil
$timezoneGroup
= DateTimeZone::ALL, ?string $countryCode
= null
): arrayProzeduraler Stil
$timezoneGroup
= DateTimeZone::ALL, ?string $countryCode
= null
): arrayParameter-Liste
-
timezoneGroup
-
Eine der DateTimeZone-Klassenkonstanten (oder eine Kombination).
-
countryCode
-
Ein Ländercode aus zwei Großbuchstaben, der mit ISO 3166-1 kompatibel ist.
Hinweis: Diese Option wird nur verwendet, wenn
timezoneGroup
aufDateTimeZone::PER_COUNTRY
gesetzt ist.
Rückgabewerte
Gibt ein Array von Zeitzonenbezeichnern zurück. Es werden nur nicht
veraltete Elemente zurückgegeben. Um alle, auch veraltete
Zeitzonenbezeichner zu erhalten, muss
DateTimeZone::ALL_WITH_BC
als Wert für
countryCode
verwendet werden.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
Vor dieser Version wurde bei einem Fehler false zurückgegeben.
|
7.1.0 |
countryCode ist nun nullable (akzeptiert den
null -Wert).
|
Beispiele
Beispiel #1 DateTimeZone::listIdentifiers()-Beispiel
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers();
for ($i=0; $i < 5; $i++) {
echo "$timezone_identifiers[$i]\n";
}
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmara
Beispiel #2 Auflisten der Bezeichner für eine bestimmte Region
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA );
for ($i=0; $i < 5; $i++) {
echo "$timezone_identifiers[$i]\n";
}
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Asia/Aden Asia/Almaty Asia/Amman Asia/Anadyr Asia/Aqtau
Beispiel #3 Auflisten der Bezeichner für mehrere Regionen
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::ASIA | DateTimeZone::PACIFIC );
echo join( ', ', $timezone_identifiers );
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Asia/Aden, Asia/Almaty, Asia/Amman, Asia/Anadyr, Asia/Aqtau, Asia/Aqtobe, Asia/Ashgabat, Asia/Atyrau, Asia/Baghdad, Asia/Bahrain, Asia/Baku, Asia/Bangkok, Asia/Barnaul, Asia/Beirut, Asia/Bishkek, Asia/Brunei, Asia/Chita, Asia/Choibalsan, Asia/Colombo, Asia/Damascus, Asia/Dhaka, Asia/Dili, Asia/Dubai, Asia/Dushanbe, Asia/Famagusta, Asia/Gaza, Asia/Hebron, Asia/Ho_Chi_Minh, Asia/Hong_Kong, Asia/Hovd, Asia/Irkutsk, Asia/Jakarta, Asia/Jayapura, Asia/Jerusalem, Asia/Kabul, Asia/Kamchatka, Asia/Karachi, Asia/Kathmandu, Asia/Khandyga, Asia/Kolkata, Asia/Krasnoyarsk, Asia/Kuala_Lumpur, Asia/Kuching, Asia/Kuwait, Asia/Macau, Asia/Magadan, Asia/Makassar, Asia/Manila, Asia/Muscat, Asia/Nicosia, Asia/Novokuznetsk, Asia/Novosibirsk, Asia/Omsk, Asia/Oral, Asia/Phnom_Penh, Asia/Pontianak, Asia/Pyongyang, Asia/Qatar, Asia/Qostanay, Asia/Qyzylorda, Asia/Riyadh, Asia/Sakhalin, Asia/Samarkand, Asia/Seoul, Asia/Shanghai, Asia/Singapore, Asia/Srednekolymsk, Asia/Taipei, Asia/Tashkent, Asia/Tbilisi, Asia/Tehran, Asia/Thimphu, Asia/Tokyo, Asia/Tomsk, Asia/Ulaanbaatar, Asia/Urumqi, Asia/Ust-Nera, Asia/Vientiane, Asia/Vladivostok, Asia/Yakutsk, Asia/Yangon, Asia/Yekaterinburg, Asia/Yerevan, Pacific/Apia, Pacific/Auckland, Pacific/Bougainville, Pacific/Chatham, Pacific/Chuuk, Pacific/Easter, Pacific/Efate, Pacific/Fakaofo, Pacific/Fiji, Pacific/Funafuti, Pacific/Galapagos, Pacific/Gambier, Pacific/Guadalcanal, Pacific/Guam, Pacific/Honolulu, Pacific/Kanton, Pacific/Kiritimati, Pacific/Kosrae, Pacific/Kwajalein, Pacific/Majuro, Pacific/Marquesas, Pacific/Midway, Pacific/Nauru, Pacific/Niue, Pacific/Norfolk, Pacific/Noumea, Pacific/Pago_Pago, Pacific/Palau, Pacific/Pitcairn, Pacific/Pohnpei, Pacific/Port_Moresby, Pacific/Rarotonga, Pacific/Saipan, Pacific/Tahiti, Pacific/Tarawa, Pacific/Tongatapu, Pacific/Wake, Pacific/Wallis
Beispiel #4 Auflisten der Bezeichner für ein einzelnes Land
<?php
$timezone_identifiers = DateTimeZone::listIdentifiers( DateTimeZone::PER_COUNTRY, "UA" );
foreach( $timezone_identifiers as $identifier ) {
echo "$identifier\n";
}
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Europe/Kyiv Europe/Simferopol Europe/Uzhgorod Europe/Zaporozhye