Устанавливает часовой пояс

# DateTimeImmutable::setTimezone

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

DateTimeImmutable::setTimezone — Устанавливает часовой пояс

### Описание

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

Метод клонирует текущий объект даты и времени DateTimeImmutable, устанавливает в копии часовой пояс и возвращает изменённую копию объекта DateTimeImmutable.

### Список параметров

`timezone`

  Объект DateTimeZone, который представляет часовой пояс.

### Возвращаемые значения

Метод возвращает новый модифицированный объект DateTimeImmutable для цепочки методов. При вызове метода исходный объект, который представляет момент времени, не изменяется.

### Примеры

Пример #1 Пример установки часового пояса методом DateTimeImmutable::setTimeZone()

Объектно-ориентированный стиль

    <?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() - Возвращает часовой пояс объекта даты и времени
- DateTimeZone::__construct() - Создаёт новый объект DateTimeZone

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