大网数据广告活动
PHP 语言与运行手册

DateTimeImmutable::setTimezone · Sets the time zone

· 52CE 我爱测

DateTimeImmutable::setTimezone — Sets the time zone

DateTimeImmutable::setTimezone

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

DateTimeImmutable::setTimezone — Sets the time zone

说明

#[\NoDiscard(message: "as DateTimeImmutable::setTimezone() does not modify the object itself")]
public function DateTimeImmutable::setTimezone(DateTimeZone $timezone): DateTimeImmutable

Returns a new DateTimeImmutable object with a new timezone set.

参数

timezone

A DateTimeZone object representing the desired time zone.

返回值

Returns a new modified DateTimeImmutable object for method chaining. The underlying point-in-time is not changed when calling this method.

错误/异常

Throws a DateObjectError if the object has not been correctly initialized, for example when the constructor of a child class does not call the parent constructor.

更新日志

版本 说明
8.3.0 A DateObjectError is now thrown if the object has not been correctly initialized; previously, an Error was thrown.

示例

示例 #1 DateTimeImmutable::setTimeZone() example

面向对象风格

<?php
$date = new DateTimeImmutable('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";

$newDate = $date->setTimezone(new DateTimeZone('Pacific/Chatham'));
echo $newDate->format('Y-m-d H:i:sP') . "\n";
?>

以上示例会输出:

2000-01-01 00:00:00+12:00
2000-01-01 01:45:00+13:45

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。