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.

### 示例

示例 #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

### 参见

- DateTimeImmutable::getTimezone() - 返回相对于指定 DateTime 的时区
- DateTimeZone::__construct() - 创建新的DateTimeZone对象

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open