PHPのtimezone_open()関数とは？使い方とサンプルコードを解説

timezone_open()関数は、指定したタイムゾーン識別子から新しいDateTimeZoneオブジェクトを返すPHPの組み込み関数です。日付や時刻を特定のタイムゾーンで扱いたい場合に、このオブジェクトを作成するための基本となる関数です。

構文

timezone_open(timezone)

パラメータ

• timezone − タイムゾーン識別子を指定します。完全な名称（例：Europe/Prague）または省略形（例：CET）のどちらでも指定可能です。

戻り値

timezone_open()関数は、処理が成功した場合にはDateTimeZoneオブジェクトを返し、失敗した場合にはFALSEを返します。

使用例1

以下は、timezone_open()関数を使ってタイムゾーンを設定・取得するサンプルコードです。

<?php
   $dateSrc = '2017-06-25 1:50 GMT';
   $dateTime = date_create($dateSrc);

   // timezone_open()でDateTimeZoneオブジェクトを作成
   $DateTimeZone = timezone_open('Europe/Paris');
   date_timezone_set($dateTime, $DateTimeZone);
   $NewDateTimeZone = date_timezone_get($dateTime);

   echo 'New timeZone is '. timezone_name_get($NewDateTimeZone);
echo "\n";

   // DateTimeクラスを使った別の方法
   $dateTime = new DateTime($dateSrc);
   $DateTimeZone = new DateTimeZone('Europe/Paris');

   $dateTime->setTimezone($DateTimeZone);
   $NewDateTimeZone = $dateTime->getTimezone();

   echo 'New timeZone is '. timezone_name_get($NewDateTimeZone);
?>

出力結果

上記コードの実行結果は以下の通りです。

New timeZone is Europe/Paris
New timeZone is Europe/Paris

使用例2

次に、もう少しシンプルな例を見てみましょう。タイムゾーン「America/Chicago」を指定してオブジェクトを作成しています。

<?php
   $res = timezone_open("America/Chicago");
   echo timezone_name_get($res);
?>

出力結果

上記コードの実行結果は以下の通りです。

America/Chicago

まとめ

timezone_open()関数は、タイムゾーン識別子からDateTimeZoneオブジェクトを簡単に生成できる便利な関数です。new DateTimeZone()と同様の働きをするため、手続き型（関数型）のコードスタイルを好む場合に活用するとよいでしょう。無効なタイムゾーンを指定した場合はFALSEが返される点にも注意してください。