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 来只列出亚洲地区的时区标识符。