Timeヘルパー¶

class TimeHelper(View $view, array $settings = array())¶

Time ヘルパーはメッキをかぶせることであなたの時間を節約します。 Time ヘルパーには時間に関する情報を手早く処理するための2つの役割があります。

時間を形式にそって文字列にすることができます。
時間を調べることができます。ただし時間を変えることはできません。

バージョン 2.1 で変更: TimeHelper は CakeTime クラスに含まれるようにリファクタリングされました。これにより、ビューの外からでもより簡単に使えるようになりました。ビューで使う際は TimeHelper クラスからこれらのメソッドを使うことができます。また、通常のヘルパーメソッドのように $this->Time->method($args); と呼び出すこともできます。

ヘルパーの使い方¶

Time ヘルパーの基本的な使い道は、ユーザーのタイムゾーンにあった日時に時刻を調整することです。それでは掲示板を例にとりましょう。あなたの掲示板は世界各地からいろんな時間帯にたくさんのユーザーがメッセージを投稿します。時刻をGMT+0またはUTCで保存すると、投稿時刻を簡単に管理できるでしょう。あなたのアプリケーションで扱うタイムゾーンを確実にGMT+0へするために、 app/Config/core.php の date_default_timezone_set('UTC'); という記述のコメントアウトを解除します。

次にタイムゾーンのフィールドをユーザーのテーブルに追加して、ユーザーがタイムゾーンを設定できるように必要な修正を加えます。これでログインしているユーザーのタイムゾーンが分かるようになり、 Time ヘルパーを使って投稿時刻を補正することができるようになりました。:

echo $this->Time->format('F jS, Y h:i A', $post['Post']['created'], null, $user['User']['time_zone']);
// GMT+0 での時刻が August 22nd, 2011 11:53 PMの場合、
// タイムゾーンが GMT-8 の場合は August 22nd, 2011 03:53 PM、
// GMT+10 の場合は August 23rd, 2011 09:53 AM が表示されます。

Timeヘルパーのメソッドは多くが $timezone パラメーターを持っています。このパラメーターはタイムゾーンを表す文字列か、 DateTimeZone クラスのインスタンスを渡すことができます。