システム内部の時差とフォーマットの時差を自動で調整するためのフォーマットです.

「閲覧しているユーザーのタイムゾーンに合わせて表示する時刻を調整したい」 といったケースで, 既存の Format オブジェクトを上書きする形で利用します.

サンプルとして, 日本語のサイトがニューヨークのサーバーで管理されているというシナリオを考えます. サーバー側ではタイムゾーンを America/New_York (UTC-5) として時間の管理をしているが, ブラウザに出力する際は Asia/Tokyo (UTC+9) のタイムゾーンで表示させたいとします.

1.  // php.ini で timezone = America/New_York が設定されているものとする
2.  
3.  // 表示用の時刻を UTC+9 とする (-540 分のオフセットを指定する)
4.  $f = new Peach_DT_ShiftFormat(new Peach_DT_SimpleFormat("Y/m/d H:i:s"), -540);
5.  
6.  // 日本のユーザーが入力した時刻をサーバー内部の時刻に変換する
7.  $d = Peach_DT_Timestamp::parse("2012/05/21 07:30:45", $f);
8.  echo $d; // "2012-05-20 17:30:45" (UTC+9 から UTC-5 に変換)
9.  
10.  // サーバで管理されている時刻を日本のユーザー向けに変換する
11.  $d = new Peach_DT_Timestamp(2012, 1, 1, 0, 0, 0);
12.  echo $d->format($f); // "2012/01/01 14:00:00" (UTC-5 から UTC+9 に変換)

このクラスの parseDate と formatDate は時差の変換を行いません. オリジナルの実行結果をそのまま返します.

ちなみに Peach_DT_W3cDatetimeFormat と Peach_DT_HttpDateFormat に関しては, 自身でタイムゾーンの変換機能をサポートしているため, このクラスを使う必要はありません.