Programmer's Reference Guide
| Zend_Date API の概要 |
日付の作成
Zend_Date は、さまざまな方法で自分自身のインスタンスを作成できます。 本章では、そのなかでもより便利な方法を紹介します。
実際の日付の作成
日付オブジェクトを作成する最も簡単な方法は、実際の日付を作成することです。 new Zend_Date() か、あるいは便利な静的メソッド Zend_Date::now() を使用すれば、 作成時の日付情報を持つ Zend_Date のインスタンスが作成されます。 日付、時刻、タイムゾーンのすべてに値が設定されます。
例1 インスタンスによる作成
新しいインスタンスの作成によって日付を作成する場合は、パラメータは何もいりません。 もちろん後で説明するようにいくつかのパラメータは存在しますが、 通常は、何も指定せずに Zend_Date のインスタンスを作成すれば現在の日付情報が得られます。
- $date = new Zend_Date();
例2 静的メソッドによる作成
静的メソッドを使用したほうが簡単に日付を作成できるという場合もあるでしょう。 そんな場合は now() メソッドが使用できます。これは、new Zend_Date() とした時と同じ内容の Zend_Date オブジェクトを返します。 しかし、これは常にその時の日付情報を持つオブジェクトとなり、 オプションのパラメータで値を変更することはできません。
- $date = Zend_Date::now();
データベースからの日付の作成
データベースに日付データが格納されることもよくあります。 しかし、データベースの種類によって日付データの扱いかたが異なるので面倒です。 MsSQL は、MySQL などとくらべて大きく異なる日付出力を行います。 しかし、Zend_Date を使用すると、データベースの日付データからの日付の作成を非常にシンプルに行えます。
もちろん、データベースのほうで日付データを変換することもできるでしょう。 たとえば datetime 型の値から分の値だけを取得することもできます。 しかし、この処理には時間がかかります。 また、データベースのクエリを作成するときにはまた別の方法で日付データを扱う必要があります。
そこで、データベースの値から簡単に日付を作成するための方法を用意しました。
例3 データベースの日付データからの簡単な日付の作成
すべてのデータベースは、 可能な限りクエリを高速に処理するように作られています。 日付を扱うのに一番時間のかからない方法は、 データベースから Unix タイムスタンプを取り出すことです。 データベースの内部は、日付の値をタイムスタンプ (Unix タイムスタンプではありません) で管理しています。 つまり、クエリからタイムスタンプを作成するのにかかる時間は それを特定の書式に変換するのにかかる時間よるはるかに短くなります。
- // SELECT UNIX_TIMESTAMP(my_datetime_column) FROM my_table
- $date = new Zend_Date($unixtimestamp, Zend_Date::TIMESTAMP);
例4 データベースの日付データからの便利な日付作成法
データベースの日付出力は、 一見同じように見えてもそれぞれ異なっています。 しかし、どれも ISO 標準の一部です。 つまり、日付を作成するための最も簡単な方法は Zend_Date::ISO_8601 を使うということになります。 Zend_Date::ISO_8601 を使用できるデータベースには、 たとえば MySQL や MsSQL があります。 しかし、それ以外のデータベースでも日付カラムを ISO-8601 形式で返すことが可能です。 ISO-8601 の大きな利点は、人間が読める形式だということです。 一方、ISO-8601 の欠点は、 単純な Unix タイムスタンプに比べて計算に時間がかかるということです。 しかし、Unix タイムスタンプは 1970 年 1 月 1 日 以降の日付しかサポートしていないという点を考慮する必要があります。
- // SELECT datecolumn FROM my_table
- $date = new Zend_Date($datecolumn, Zend_Date::ISO_8601);
配列からの日付の作成
配列から日付を作成することもできます。 これはシンプルで簡単な方法となります。 使用する配列のキーは次のようになります。
-
day: 日
-
month: 月
-
year: 年
-
hour: 時
-
minute: 分
-
second: 秒
例5 配列による日付の作成
通常は、新しい日付インスタンスを作成する際には完全な形式の日付配列を渡します。 しかし、指定されていない項目があった場合は、 その項目の値はゼロとして処理されます。 つまり、たとえば hour を指定しなかった場合は 0 時として扱われるということです。
- 'month' => 4,
- 'day' => 18,
- 'hour' => 12,
- 'minute' => 3,
- 'second' => 10);
- $date = new Zend_Date($datearray)
- ;
- $date = new Zend_Date($datearray);
| Zend_Date API の概要 |

+ Add A Comment
Please do not report issues via comments; use the ZF Issue Tracker.
If you have a JIRA/Crowd account, we suggest you login first before commenting.