Skip to content

Commit

Permalink
Merge pull request cakephp#577 from yuxxxx/ja-time-helper
Browse files Browse the repository at this point in the history
Translation 'time helper' in Japanese
  • Loading branch information
shama committed May 24, 2013
2 parents d9e7503 + d4b6906 commit 871270b
Showing 1 changed file with 45 additions and 0 deletions.
45 changes: 45 additions & 0 deletions ja/core-libraries/helpers/time.rst
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

0 comments on commit 871270b

Please sign in to comment.