DateTime::setTimezone
date_timezone_set
(PHP 5 >= 5.2.0, PHP 7)
DateTime::setTimezone -- date_timezone_set — DateTime オブジェクトのタイムゾーンを設定する
パラメータ
-
object -
手続き型のみ: date_create() が返す DateTime オブジェクト。 この関数は、このオブジェクトを変更します。
-
timezone -
指定したいタイムゾーンを表す DateTimeZone オブジェクト。
返り値
メソッドチェインに使う DateTime オブジェクトを返します。失敗した場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.3.0 | 成功した場合の返り値が
NULL から 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";
?>
手続き型
<?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
参考
- DateTime::getTimezone() - 指定した DateTime に関連するタイムゾーンを返す
- DateTimeZone::__construct() - 新しい DateTimeZone オブジェクトを作成する
忘却曲線を使ってこの知識を確実に記憶に残す
