【PHP8.x】getTransitionsメソッドの使い方

getTransitionsメソッドは、DateTimeZoneクラスに属し、特定のタイムゾーンにおける時間移行情報を取得するメソッドです。時間移行とは、夏時間（サマータイム）の開始や終了のように、タイムゾーンのオフセット（世界協定時との差）が変更される時点を指します。

このメソッドは、指定されたDateTimeZoneオブジェクトが表すタイムゾーンが、いつ、どのように時間を調整したか、あるいは将来調整する予定であるかという詳細な情報を提供します。具体的には、タイムゾーンの変更が起こるタイムスタンプ、その時点のオフセット、夏時間かどうかを示すフラグなどの情報が配列形式で返されます。

オプションとして、情報の取得期間を限定するための開始タイムスタンプと終了タイムスタンプを指定することができます。これにより、特定の期間内でのみ発生する時間移行情報をフィルタリングして取得することが可能です。

例えば、過去の特定の時点での正確なタイムゾーンのオフセットを計算したり、夏時間に対応したスケジュール機能を実装したりする際に非常に有用です。タイムゾーンの複雑な時間変更ルールを正確に処理する必要がある場合に、このメソッドは開発者が正確な時間計算を行うための重要なデータを提供します。

Copy
1<?php
2$timeZone = new DateTimeZone('America/New_York');
3$startDate = strtotime('2024-01-01');
4$endDate = strtotime('2025-01-01');
5$transitions = $timeZone->getTransitions($startDate, $endDate);
6print_r($transitions);
7?>

int $timestamp_begin = PHP_INT_MIN, int $timestamp_end = PHP_INT_MAX

• int $timestamp_begin = PHP_INT_MIN: タイムゾーンの遷移情報を取得する開始時刻をUNIXタイムスタンプで指定します。デフォルトはPHP_INT_MIN（最小値）。
• int $timestamp_end = PHP_INT_MAX: タイムゾーンの遷移情報を取得する終了時刻をUNIXタイムスタンプで指定します。デフォルトはPHP_INT_MAX（最大値）。

array

このメソッドは、タイムゾーンの切り替わり（サマータイムの開始・終了など）に関する情報を格納した配列を返します。配列の各要素は、切り替わりが発生した日時と、その時点でのタイムゾーンオフセットを表します。