PHP | IntlCalendar setTimeZone() 函数

概述

IntlCalendar::setTimeZone() 函数用于设置国际化日历对象的时区。

本函数是PHP国际化扩展(Internationalization Extension)中 IntlCalendar 类的一个成员方法。

语法

public bool IntlCalendar::setTimeZone(mixed $timeZone)

参数

• $timeZone ：[可选] 设置的时区，可以是以下三种类型之一：
  • 字符串类型的时区名称，如 America/New_York
  • 时区偏移量的整型值，如 -18000
  • 时区的 DateTimeZone 对象

返回值

如果设置成功，函数返回 TRUE，否则返回 FALSE。

示例

下面是一个简单的使用示例：

$cal = IntlCalendar::createInstance();

// 设置时区为纽约
$cal->setTimeZone('America/New_York');

// 输出当前时间
echo $cal->getTime()->format('Y-m-d H:i:s');

在上面的示例中，我们创建了一个国际化日历对象，并使用 setTimeZone() 函数将其时区设置为纽约。

然后使用 getTime() 函数获取当前时间，并通过 format() 函数将其格式化成字符串输出。

输出结果如下：

2022-11-17 23:57:23

我们可以看到，输出的时间是在纽约时区下的。如果不调用 setTimeZone() 函数，则默认使用系统时区。

注意点

• PHP版本：本函数需要 PHP 5.5.0 及以上版本支持，并且需要同时安装国际化扩展(Internationalization Extension)。
• 时区的内容和格式请参考：时区列表。特别地，当使用时区偏移量的整型值作为参数时，偏移量的单位是秒数。

参考资料

• PHP官方文档：IntlCalendar::setTimeZone
• 时区列表：http://php.net/manual/en/timezones.php