PHP - Manual: DateTimeZone::listIdentifiers

2024-04-27

DateInterval »

« DateTimeZone::listAbbreviations

DateTimeZone::listIdentifiers

timezone_identifiers_list

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

DateTimeZone::listIdentifiers -- timezone_identifiers_list — 返回一个包含了所有时区标示符的索引数组。

说明

面向对象风格

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

过程化风格

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

参数

what: DateTimeZone 类中的常量之一。
country: 由两个字母组成，ISO 3166-1 兼容的国家代码。

注意: 只有当 what 被设置为DateTimeZone::PER_COUNTRY时,该选项才会被使用。

返回值

成功，返回数组，失败则返回false.

更新日志

版本	说明
5.3.0	添加可选的 `what` 和 `country` 参数。

范例

示例 #1 timezone_identifiers_list() 函数的范例：


<?php
$timezone_identifiers = DateTimeZone::listIdentifiers();
for ($i=0; $i < 5; $i++) {
    echo "$timezone_identifiers[$i]\n";
}
?>

以上例程的输出类似于：

Africa/Abidjan
Africa/Accra
Africa/Addis_Ababa
Africa/Algiers
Africa/Asmara

参见

timezone_abbreviations_list() - 别名 DateTimeZone::listAbbreviations

add a note

User Contributed Notes 3 notes

down

kalle at example dot com ¶

6 years ago


Even though the manual currently says that the first parameter has to be "One of DateTimeZone class constants", you may actually combine these constants:

<?php
  $a = DateTimeZone::listIdentifiers(DateTimeZone::AFRICA); //gives africa time zones
  $b = DateTimeZone::listIdentifiers(DateTimeZone::AMERICA); //gives american time zones
  $c = DateTimeZone::listIdentifiers(DateTimeZone::AFRICA | DateTimeZone::AMERICA); //gives both african and american time zones
?>

Be sure to use |, not ||.

down

repohelga at example dot com ¶

2 years ago


Beware that the ISO 3166-1 country code passed to second parameter $country has to be in capital letters (eg. 'US', 'DE', ...).
Passing the country code in lower case like 'us' or 'de' will not return the failure-value false but just an empty array.

down

PHP Guru ¶

2 years ago


In tests that I have done, not all time zones are returned by this function. For example the following aliases Asia/Katmandu and Asia/Calcutta are not returned, but these time zones are supported in tests that I have done such as the following:

<?php
echo date_default_timezone_set('Asia/Calcutta');
?>

result:

Fri, 19 Jun 2020 03:26:52 +0530

UTC+05:30 is the correct time zone for Calcutta.

Asia/Katmandu and Asia/Calcutta are aliases for Asia/Kathmandu and Asia/Kolkata respectively (which can be found in the list)

Hopefully this helps some people because without these time zones appearing in the list one might not know that they are supported or even exist.

add a note

官方地址：https://www.php.net/manual/en/datetimezone.listidentifiers.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 科技开发编程 Elasticsearch HTML/CSS/XML 网络 JAVA NoSQL C/C++ 面试 Golang 数据库 Git 算法正则表达式操作系统 Redis 互联网 MySql JavaScript 运维软件架构设计 Mac OS TCP/IP 国际 Excel Vim Windows Socket Oracle VR MongoDB 运营 Python MemCache 商业硬件电子设计 nginx 娱乐摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 [PHP] inet_pton/inet_ntop IP地址转换函数 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 PHPMailer设置utf8 PHPMailer字符集CharSet 如何在Composer中为GitLab实例设置访问令牌 array_multisort() 多字段排序 laravel框架查看sql语句方式 [原创]诡异的php-fpm超时问题 PHP获取指定函数定义在哪个文件中及行号利用php soap实现web service php设置cookie为httponly防止xss攻击 PHP5 扩展SOAP 调用 webservice PHP-FPM进程数的设定 PHP7添加redis扩展 PHPstorm 里面Terminal 不能使用 esc键吗退出编辑模式吗纯php实现DES以及TripleDES加密算法 adodb手册利用PHP SOAP实现WEB SERVICE ADOConnection 公用函数

略微加速

PHP官方手册 - 互联网笔记

DateTimeZone::listIdentifiers

timezone_identifiers_list

说明

参数

返回值

更新日志

范例

参见

User Contributed Notes 3 notes