4.7. Date/Time 関数

4.7.1. EXTRACT, date_part

EXTRACT (field FROM source)

extract関数は、date/time値から年や時間などの サブフィールドを抽出します。sourceとは timestamp型やinterval型に評価する値式です。 (date型、またはtime型の表現は timestamp型にキャストされるのでこれらも使用できます。) fieldは識別子(文字列ではありません。)で、 source値(source value)からどのフィールドを抽出するかを選択します。 extract関数の返り値は double precisionです。 下記は有効な値です。

extract関数はコンピュータ使用のためのものでした。 日付/時間の値をディスプレーのためにフォーマットするには Section 4.6をご覧下さい。

date_part関数は、Postgres 伝来のもので、SQL関数のextractと 同義です。

date_part('field', source)

SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
結果： 16

SELECT date_part('hour', INTERVAL '4 hours 3 minutes')
結果： 4

4.7.2. date_trunc

date_trunc関数は、数のtrunc 関数と概念的には似ているものです。

date_trunc('field', source)

有効なfieldの値は下記の通りです。

SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40');
結果： 2001-02-16 20:00:00+00

SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
結果： 2001-01-01 00:00:00+00

4.7.3. 現在の 日付/時間

下記の関数は現在の日付、または時間を取得するための関数です。

CURRENT_TIME
CURRENT_DATE
CURRENT_TIMESTAMP

SELECT CURRENT_TIME;
19:07:32

SELECT CURRENT_DATE;
2001-02-17

SELECT CURRENT_TIMESTAMP;
2001-02-17 19:07:32-05

now()関数はPostgres 伝来のものです。CURRENT_TIMESTAMPと同義です。

timeofday()関数は、現在の時間を CURRENT_TIMESTAMP関数群よりも高い精度で返します。

SELECT timeofday();
 Sat Feb 17 19:07:32.000126 2001 EST

timeofday()関数は、オペレーティングシステムの呼び出し、 gettimeofday(2)を使用し、プラットフォームに よりますが、マイクロセカンドまでの結果を取り出すことができます。 その他の関数はtime(2)に依存し、秒単位の 結果を返します。歴史的背景により、timeofday() 関数はtimestamp型の値ではなく、文字列で結果を返します。

CURRENT_TIMESTAMPと、その他の関連する関数すべては、 現在のトランザクションが開始された時間を返すことに注意して下さい。 また、それらの値はトランザクションが実行されている間に増加しません。 しかし、timeofday()は実際の現在時間を返します。

すべての日付/時間データ型はnowという、現在の日付と時間を 特定する、特殊な定数を認識します。したがって、下記のプログラムの 実行結果はすべて同じものとなります。

SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';