PHP - Manual: DateTimeZone::listIdentifiers

2024-12-21

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位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 adodb手册 ADORecordSet对象 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 mysql面试题纯php实现DES以及TripleDES加密算法 php 修改图片大小两千行PHP学习笔记支持php7的性能采集扩展 [原创]诡异的php-fpm超时问题 Packagist / Composer 中国全量镜像

略微加速

PHP官方手册 - 互联网笔记

DateTimeZone::listIdentifiers

timezone_identifiers_list

说明

参数

返回值

更新日志

范例

参见

User Contributed Notes 3 notes