forked from cakephp/docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request cakephp#577 from yuxxxx/ja-time-helper
Translation 'time helper' in Japanese
- Loading branch information
Showing
1 changed file
with
45 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
Timeヘルパー | ||
########## | ||
|
||
.. php:class:: TimeHelper(View $view, array $settings = array()) | ||
Time ヘルパーはメッキをかぶせることであなたの時間を節約します。 | ||
Time ヘルパーには時間に関する情報を手早く処理するための2つの役割があります。 | ||
|
||
#. 時間を形式にそって文字列にすることができます。 | ||
#. 時間を調べることができます。ただし時間を変えることはできません。 | ||
|
||
.. versionchanged:: 2.1 | ||
``TimeHelper`` は :php:class:`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` クラスのインスタンスを渡すことができます。 | ||
|
||
.. include:: ../../core-utility-libraries/time.rst | ||
:start-after: start-caketime | ||
:end-before: end-caketime | ||
|
||
.. meta:: | ||
:title lang=en: TimeHelper | ||
:description lang=en: The Time Helper will help you format time and test time. | ||
:keywords lang=en: time helper,format time,timezone,unix epoch,time strings,time zone offset,utc,gmt |