DateTime オブジェクトのタイムゾーンを設定する

# DateTime::setTimezone

# date_timezone_set

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

DateTime::setTimezone -- date_timezone_set — DateTime オブジェクトのタイムゾーンを設定する

### 説明

オブジェクト指向型

public function DateTime::setTimezone(DateTimeZone `$timezone`): DateTime

手続き型

function date_timezone_set(DateTime `$object`, DateTimeZone `$timezone`): DateTime

新しいタイムゾーンを DateTime オブジェクトに設定します。

DateTimeImmutable::setTimezone() に似ていますが、 DateTime を使って動作します。

手続き型のバージョンは、 DateTime オブジェクトを最初の引数に取ります。

### パラメータ

`object`
  手続き型のみ: date_create() が返す DateTime オブジェクト。 この関数は、このオブジェクトを変更します。
`timezone`

  指定したいタイムゾーンを表す DateTimeZone オブジェクト。

### 戻り値

メソッドをチェインできるようにするため、 DateTime オブジェクトを返します。 このメソッドをコールした際に指していた時刻は変わりません。

### 例

例1 DateTime::setTimeZone() の例

オブジェクト指向型

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

    $date->setTimezone(new DateTimeZone('Pacific/Chatham'));
    echo $date->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
    $date = date_create('2000-01-01', timezone_open('Pacific/Nauru'));
    echo date_format($date, 'Y-m-d H:i:sP') . "\n";

    date_timezone_set($date, timezone_open('Pacific/Chatham'));
    echo date_format($date, 'Y-m-d H:i:sP') . "\n";

上の例の出力は以下となります。

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

### 参考

- DateTimeImmutable::setTimezone() - タイムゾーンを設定する
- DateTime::getTimezone() - 指定した DateTime に関連するタイムゾーンを返す
- DateTimeZone::__construct() - 新しい DateTimeZone オブジェクトを作成する

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