【PHP8.x】timezone_offset_get関数の使い方

Copy
1<?php
2
3/**
4 * 現在のタイムゾーンのオフセット（秒単位）を取得するサンプルコード
5 */
6
7// タイムゾーンを設定
8date_default_timezone_set('Asia/Tokyo');
9
10// 現在のタイムゾーンオブジェクトを作成
11$timezone = new DateTimeZone(date_default_timezone_get());
12
13// 現在時刻の DateTimeImmutable オブジェクトを作成
14$datetime = new DateTimeImmutable();
15
16// タイムゾーンのオフセットを取得
17$offset = timezone_offset_get($timezone, $datetime);
18
19// 結果を出力
20echo '現在のタイムゾーンオフセット (秒): ' . $offset . PHP_EOL;
21
22?>

このサンプルコードは、PHPで現在のタイムゾーンのオフセット（UTCからのずれ）を秒単位で取得する方法を示しています。システムエンジニアを目指す方が、タイムゾーンを扱う際の基礎として役立つでしょう。

まず、date_default_timezone_set()関数を使用して、スクリプトで使用するデフォルトのタイムゾーンを 'Asia/Tokyo' に設定します。これにより、以降のDateTime関連の処理が特定のタイムゾーンに基づいて行われるようになります。

次に、DateTimeZoneクラスのインスタンスを作成し、date_default_timezone_get()関数で取得したタイムゾーン名を渡します。このDateTimeZoneオブジェクトが、タイムゾーン情報を保持します。

DateTimeImmutableクラスは、変更不可能な日時オブジェクトを作成するために使用されます。ここでは、現在時刻を表すDateTimeImmutableオブジェクトを作成しています。

そして、timezone_offset_get()関数を使用して、指定されたDateTimeZoneオブジェクトとDateTimeInterfaceオブジェクト（ここではDateTimeImmutableオブジェクト）に基づいて、タイムゾーンのオフセットを秒単位で取得します。この関数は、第一引数にDateTimeZoneオブジェクト、第二引数にDateTimeInterfaceを実装した日時オブジェクトを渡します。戻り値として、UTCからのずれを秒単位で表す数値が返されます。

最後に、取得したオフセット値を echo で出力します。これにより、現在のタイムゾーンがUTCからどれだけずれているかを確認できます。このサンプルコードを実行することで、PHPにおけるタイムゾーンの扱い方と、オフセットの取得方法を理解することができます。

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 指定したタイムゾーンと日時のUTCからのオフセット（時差）を取得して表示します。
7 *
8 * `timezone_offset_get` は、DateTimeZoneオブジェクトとDateTimeInterfaceオブジェクトを
9 * 引数に取り、指定された日時におけるUTCからのオフセットを秒単位の整数で返します。
10 * 夏時間（サマータイム）も考慮されます。
11 *
12 * @param string $timezoneIdentifier タイムゾーン識別子 (例: 'Asia/Tokyo', 'America/New_York')
13 * @param string $dateTimeString     日時を表す文字列 (例: '2024-08-01 10:00:00')
14 * @return void
15 */
16function displayTimezoneOffsetExample(string $timezoneIdentifier, string $dateTimeString): void
17{
18    try {
19        // 1. タイムゾーンを表す DateTimeZone オブジェクトを生成します。
20        $timezone = new DateTimeZone($timezoneIdentifier);
21
22        // 2. 日時を表す DateTime オブジェクトを生成します。
23        //    この日時が、どの時点でのオフセットを取得するかの基準になります。
24        $datetime = new DateTime($dateTimeString, $timezone);
25
26        // 3. timezone_offset_get() を呼び出し、UTCからのオフセットを秒単位で取得します。
27        $offsetInSeconds = timezone_offset_get($timezone, $datetime);
28
29        // 4. 人間が読みやすいように、時差を「+HH:MM」形式に変換します。
30        $hours = floor(abs($offsetInSeconds) / 3600);
31        $minutes = floor((abs($offsetInSeconds) % 3600) / 60);
32        $sign = ($offsetInSeconds >= 0) ? '+' : '-';
33        $offsetFormatted = sprintf('%s%02d:%02d', $sign, $hours, $minutes);
34
35        // 結果を出力します。
36        printf(
37            "タイムゾーン '%s' の日時 '%s' 時点でのUTCオフセット:\n",
38            $timezoneIdentifier,
39            $datetime->format('Y-m-d H:i:s')
40        );
41        printf("  - %d 秒\n", $offsetInSeconds);
42        printf("  - %s\n\n", $offsetFormatted);
43
44    } catch (Exception $e) {
45        // タイムゾーン識別子が不正な場合などのエラーを処理します。
46        echo "エラー: " . $e->getMessage() . "\n";
47    }
48}
49
50// --- 実行例 ---
51
52// 日本時間 (JST) は常にUTC+9時間です。
53displayTimezoneOffsetExample('Asia/Tokyo', '2024-11-01 12:00:00');
54
55// ニューヨークの冬時間 (EST) は UTC-5時間です。
56displayTimezoneOffsetExample('America/New_York', '2024-11-01 12:00:00');
57
58// ニューヨークの夏時間 (EDT) は UTC-4時間です。
59// このように、同じタイムゾーンでも日時によってオフセットが変わることが分かります。
60displayTimezoneOffsetExample('America/New_York', '2024-08-01 12:00:00');
61
62?>

PHPのtimezone_offset_get関数は、指定されたタイムゾーンと特定の日時において、UTC（協定世界時）からの時差（オフセット）を秒単位で取得するために使用されます。この関数は、第一引数にタイムゾーンを表すDateTimeZoneオブジェクトを、第二引数にオフセット計算の基準となる日時を表すDateTimeInterfaceオブジェクトを取ります。特に、夏時間（サマータイム）が適用される地域では、同じタイムゾーンであっても日時によってUTCからのオフセットが変化するため、DateTimeInterfaceオブジェクトで正確な日時を指定することが重要です。この関数は、UTCからのオフセットを整数値（秒単位）で返します。

提供されたサンプルコードでは、displayTimezoneOffsetExample関数内で、まず指定されたタイムゾーン識別子と日時文字列からDateTimeZoneおよびDateTimeオブジェクトをそれぞれ生成しています。その後、timezone_offset_get関数を呼び出して秒単位のオフセットを取得し、その結果を人間が読みやすい「+HH:MM」形式に変換して表示しています。複数の実行例を通して、同じタイムゾーンでも日時（冬時間や夏時間）によってオフセットが異なることが分かりやすく示されており、システムが正確な時刻情報を扱う上で非常に役立つ機能です。