9.9. 日付/時刻関数と演算子

9.9.1. EXTRACT, date_part

EXTRACT (field FROM source)

extract関数は、日付/時刻の値から年や時などの部分フィールドを抽出します。 sourceはtimestamp型、time型、またはinterval型の評価式でなければなりません。 (date型の式はtimestamp型にキャストされますので、同様に使用可能です。) fieldはsourceの値からどのフィールドを抽出するかを選択する識別子もしくは文字列です。 extract関数はdouble precision型の値を返します。 以下に有効なフィールド名を示します。

extract関数はもともと計算処理の目的でした。 日付/時刻の値を表示する目的での書式については項9.8を参照してください。

date_part関数は伝統的なIngres上で設計されたもので、標準SQLのextract関数と等価です。

date_part('field', source)

ここでfieldパラメータが名前ではなく文字列値である必要があることに注意してください。 date_partで有効なフィールド名はextractと同じです。

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

SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
Result: 4

9.9.2. date_trunc

date_trunc関数は概念的に数値に対するtrunc関数と類似しています。

date_trunc('field', source)

sourceは、データ型timestampもしくはintervalの評価式です(データ型dateとtimeはそれぞれ自動的にtimestampもしくはintervalにキャストされます)。 fieldは、入力値の値をどの精度で切捨てるかを選択します。 戻り値の値は、選択されたもの以下をゼロに設定(日と月の場合は1に設定)した、全てのフィールドを持つtimestampもしくはinterval型です。

field の有効値には次のものがあります。

例：

SELECT date_trunc('hour', TIMESTAMP '2001-02-16 20:38:40');
Result: 2001-02-16 20:00:00

SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40');
Result: 2001-01-01 00:00:00

9.9.3. AT TIME ZONE

AT TIME ZONE構文を使用することにより、タイムスタンプを異なる時間帯に変換することができます。 表9-27にその種類を示します。

上記の式では、設定する時間帯zoneは、('PST'のような)テキスト文字列、または(INTERVAL '-08:00'のような)時間間隔で指定することができます。 テキストの場合、表B-4に示したゾーン名を利用することができます。 （表B-6内の一般的な名前を使用できればもっと便利でしょうが、これはまだ実装されていません。）

以下に例を示します(ローカルな時間帯をPST8PDTに設定しています)。

SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST';
Result: 2001-02-16 19:38:40-08

SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST';
Result: 2001-02-16 18:38:40

最初の例では、時間帯に関係のないタイムスタンプが使用され、それがMST時間(UTC-7)として解釈され、UTCタイムスタンプを生成します。 それから、UTCタイムスタンプが、表示上PST(UTC-8)に置き換えられます。 2番目の例では、EST(UTC-5)に指定されたタイムスタンプが使用され、それがMST(UTC-7)でのローカル時間に変換されています。

関数timezone(zone, timestamp)は、SQL準拠の構文timestamp AT TIME ZONE zoneと等価です。

9.9.4. 現在の日付/時刻

以下の関数は、現在の日付および/または時間を取得するための関数です。

CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_TIME ( precision )
CURRENT_TIMESTAMP ( precision )
LOCALTIME
LOCALTIMESTAMP
LOCALTIME ( precision )
LOCALTIMESTAMP ( precision )

CURRENT_TIMEおよびCURRENT_TIMESTAMP関数では、時間帯を伴う値を扱います。 一方、LOCALTIMEおよびLOCALTIMESTAMP関数では、時間帯を伴わない値を扱います。

CURRENT_TIME、CURRENT_TIMESTAMP、LOCALTIME、およびLOCALTIMESTAMP関数では、精度のパラメータをオプションで与えることができ、それに合わせて秒フィールドの端数桁を丸める結果をもたらします。 精度のパラメータがない場合、結果は使用可能な最大精度で出力されます。

以下にいくつか例を示します。

SELECT CURRENT_TIME;
Result: 14:39:53.662522-05

SELECT CURRENT_DATE;
Result: 2001-12-23

SELECT CURRENT_TIMESTAMP;
Result: 2001-12-23 14:39:53.662522-05

SELECT CURRENT_TIMESTAMP(2);
Result: 2001-12-23 14:39:53.66-05

SELECT LOCALTIMESTAMP;
Result: 2001-12-23 14:39:53.662522

now()関数はCURRENT_TIMESTAMPと等価のPostgreSQLに於ける因習です。

同時にtimeofday()関数があって、歴史的理由によりtimestampの値ではなくtext型の文字列を返します。

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

CURRENT_TIMESTAMPと、それに関連する関数は、全て現在のトランザクションが開始された時間を返すことを理解することは重要です。 この値は、トランザクションが実行されている間は変化しません。 これは、次の機能を検討した結果です。 単一トランザクションで、"current"時間を一貫性を持った表現を行なうことができるようにすることを目的とし、このため、同一トランザクションで何回変更を行なっても同一のタイムスタンプを生成します。 timeofday()は、壁時計時刻を返し、トランザクションが実行されている間にも増加します。

全ての日付/時刻データ型は同時にnowという現在の日付と時刻を特定する特殊なリテラル値を受け付けます。 従って、下記の3つの実行結果は全て同じものとなります。

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