date_default_timezone_set

関数の概要

date_default_timezone_set は、PHPのスクリプト全体で使用するデフォルトのタイムゾーンを設定する関数です。これを設定することで、日付や時刻を扱う関数の出力や内部処理が指定したタイムゾーン基準となり、タイムゾーンに依存したズレを防げます。特にサーバーの設定が異なる場合や複数タイムゾーンを扱う際に便利です。

パラメータの説明

戻り値

タイムゾーンの設定が成功した場合は true を返します。無効なタイムゾーン名が指定された場合は false を返します。

使用例

基本的な使い方

<?php
// タイムゾーンを東京に設定
date_default_timezone_set('Asia/Tokyo');

// 現在の日時を表示
echo date('Y-m-d H:i:s'); // 例: 2024-06-10 15:30:45
?>

この例では、タイムゾーンを「Asia/Tokyo」に設定してから現在時刻を取得しています。結果は東京時間で表示されます。

異なるタイムゾーンを切り替えて表示

<?php
// タイムゾーンをニューヨークに設定
date_default_timezone_set('America/New_York');
echo 'ニューヨークの時間: ' . date('Y-m-d H:i:s') . "<br>";

// タイムゾーンをロンドンに変更
date_default_timezone_set('Europe/London');
echo 'ロンドンの時間: ' . date('Y-m-d H:i:s');
?>

タイムゾーンを動的に切り替えて異なる地域の日時を取得することができます。グローバル対応のシステムでよく使われる方法です。

無効なタイムゾーン名のエラーハンドリング

<?php
$timezone = 'Invalid/Timezone';
if (date_default_timezone_set($timezone)) {
    echo 'タイムゾーンは ' . $timezone . ' に設定されました。';
} else {
    echo '無効なタイムゾーンが指定されました。';
}
?>

無効なタイムゾーン文字列を設定しようとした場合は false が返るため、条件分岐でエラー処理が可能です。

関連する関数

  • date_default_timezone_get: 現在設定されているデフォルトのタイムゾーンを取得します。
  • date: 日付や時刻のフォーマットを取得します。タイムゾーン設定の影響を受けます。
  • timezone_identifiers_list: 利用可能なタイムゾーン識別子の一覧を取得します。

まとめ

date_default_timezone_set はPHPの日時処理の基準となるタイムゾーンを簡単に変更できる便利な関数です。正しいタイムゾーンを設定することで、日付や時刻のズレを防ぎ安定したシステムを構築できます。特に複数の国や地域で動作するWebアプリケーションでは必須と言えるでしょう。必ず有効なタイムゾーン名を使うよう注意し、必要に応じてエラーチェックを行うことをおすすめします。

スポンサーリンク