函数名称:IntlTimeZone::createTimeZone()
适用版本:PHP 5 >= 5.5.0, PHP 7, PHP 8
用法:IntlTimeZone::createTimeZone() 函数用于创建一个新的 IntlTimeZone 对象,该对象表示给定的时区标识符。
语法:public static IntlTimeZone::createTimeZone(string $timezoneId) : IntlTimeZone|false
参数:
- $timezoneId:要创建的时区的标识符,例如 "Asia/Shanghai"。
返回值:
- 如果时区标识符有效,则返回一个新的 IntlTimeZone 对象。
- 如果时区标识符无效,则返回 false。
示例:
// 创建一个表示 "Asia/Shanghai" 的 IntlTimeZone 对象
$timezone = IntlTimeZone::createTimeZone("Asia/Shanghai");
if ($timezone) {
echo $timezone->getDisplayName() . "\n";
echo $timezone->getID() . "\n";
echo $timezone->getRawOffset() . "\n";
} else {
echo "无效的时区标识符\n";
}
输出:
China Standard Time
Asia/Shanghai
28800
上述示例中,我们使用 "Asia/Shanghai" 作为参数调用了 IntlTimeZone::createTimeZone() 函数来创建一个表示上海时区的 IntlTimeZone 对象。然后,我们使用该对象的一些方法来获取时区的显示名称、时区标识符和原始偏移量。如果时区标识符无效,函数将返回 false,并输出相应的错误消息。