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-6もしくは表B-4に示したゾーン名を利用することができます。

以下に例を示します（ローカルな時間帯を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-7）に置き換えられます。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における因習です。

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

同時に、トランザクション過程で壁掛け時計の時刻を戻すtimeofday()関数があって、時刻を進めます。歴史的な理由で、timeofday()はtimestampの値でなく、text文字列を返します。

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

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

SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';  -- DEFAULTと一緒に使用してはいけません