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

date_timezone_get()関数は、指定されたDateTimeオブジェクトに関連付けられているタイムゾーンを取得するためのPHP組み込み関数です。日付処理において、どのタイムゾーンが設定されているかを確認したい場合に活用できます。

基本構文

date_timezone_get(obj)

この関数は手続き型（procedural）の書き方であり、オブジェクト指向スタイルでは DateTime::getTimezone() メソッドに相当します。

パラメータ

• obj − タイムゾーンを取得したい対象のDateTimeオブジェクトを指定します。このパラメータは必須です。

戻り値

成功した場合は DateTimeZone オブジェクトを返し、失敗した場合は FALSE を返します。

なお、戻り値のDateTimeZoneオブジェクトからタイムゾーン名（文字列）を取り出すには、timezone_name_get() 関数を組み合わせて使うのが一般的です。

使用例

以下は、Asia/Kolkata タイムゾーンを持つDateTimeオブジェクトを作成し、そのタイムゾーンを取得して表示する例です。

<?php
   $dt = date_create(null, timezone_open("Asia/Kolkata"));
   $time_zone = date_timezone_get($dt);
   echo timezone_name_get($time_zone);
?>

コードの解説

まず date_create() 関数で新しいDateTimeオブジェクトを生成し、第2引数として timezone_open("Asia/Kolkata") で作成したタイムゾーンを設定しています。次に date_timezone_get() を使ってそのタイムゾーンを取得し、最後に timezone_name_get() でタイムゾーン名を出力しています。

実行結果

Asia/Kolkata

このように、date_timezone_get() を使えば、DateTimeオブジェクトに設定されたタイムゾーン情報を簡単に確認・取得することができます。