DateTimeZone::listIdentifiers()函式—用法及示例

PHP函式：DateTimeZone::listIdentifiers()

適用版本：PHP 5 >= 5.2.0, PHP 7

說明：DateTimeZone::listIdentifiers() 函式用於返回已知的時區識別符號的陣列。這些時區識別符號可以用於 DateTime 或 DateTimeZone 類中。

用法：

DateTimeZone::listIdentifiers( int $what = DateTimeZone::ALL, string $country = null ): array

引數：

• $what（可選）：指定所返回的時區識別符號的型別，可以是下列常量之一：
  • DateTimeZone::ALL（預設）：返回所有時區識別符號。
  • DateTimeZone::AFRICA：返回非洲地區的時區識別符號。
  • DateTimeZone::AMERICA：返回美洲地區的時區識別符號。
  • DateTimeZone::ANTARCTICA：返回南極洲地區的時區識別符號。
  • DateTimeZone::ASIA：返回亞洲地區的時區識別符號。
  • DateTimeZone::ATLANTIC：返回大西洋地區的時區識別符號。
  • DateTimeZone::AUSTRALIA：返回澳大利亞地區的時區識別符號。
  • DateTimeZone::EUROPE：返回歐洲地區的時區識別符號。
  • DateTimeZone::INDIAN：返回印度洋地區的時區識別符號。
  • DateTimeZone::PACIFIC：返回太平洋地區的時區識別符號。
  • DateTimeZone::UTC：返回協調世界時（UTC）的時區識別符號。
  • DateTimeZone::ALL_WITH_BC：返回所有時區識別符號，包括那些在過去曾經使用的識別符號（如UTC+8:00 Asia/Taipei）。
• $country（可選）：指定時區的國家/地區程式碼。可用於進一步縮小結果集。

返回值：返回一個包含時區識別符號的陣列，排序順序按名稱排序。

示例：

$timezones = DateTimeZone::listIdentifiers();

foreach ($timezones as $timezone) {
    echo $timezone . PHP_EOL;
}

輸出：

Africa/Abidjan
Africa/Accra
Africa/Addis_Ababa
...

上述示例將列出所有已知的時區識別符號。你也可以透過設定 $what 引數為 DateTimeZone::ASIA 來只列出亞洲地區的時區識別符號。