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

6.8.1. EXTRACT, date_part

EXTRACT (field FROM source)

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

extract 関数はもともと計算処理の目的でした。日付/時刻の値を表示する目的でのフォーマティングに付いては Section 6.7 を参照してください。

date_part 関数は、以下のように SQL 標準での関数 extract と同等の、伝統的な Ingres をモデルにしています。

date_part('field', source)

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

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

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

6.8.2. date_trunc

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

date_trunc('field', source)

source は、データ型 timestamp の評価式です (データ型 date と time は自動的にキャストされます)。 field は、タイムスタンプの値をどの精度で切捨てるかを選択します。返り値の値は選択されたものより小さいすべてのフィールドがゼロ(日と月の場合は 1)に設定されます。

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

6.8.3. AT TIME ZONE

AT TIME ZONE 構文を使用することにより、タイムスタンプを異なる時間帯に変換することができます。

上記の式では、設定する時間の zone は、('PST' のような) テキスト文字列、または (INTERVAL '-08:00' のような) 時間間隔で指定することができます。

以下に例を示します (TimeZone を PST8PDT に設定しています)。

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

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

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

関数 timezone(zone, timestamp) は、SQL 準拠の構文 timestamp AT TIME ZONE zone と同じ機能を果たします。

6.8.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;
14:39:53.662522-05

SELECT CURRENT_DATE;
2001-12-23

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

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

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

now() 関数は CURRENT_TIMESTAMP 互換の PostgreSQL に於ける因習です。

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

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

CURRENT_TIMESTAMP と、それに関連する関数は、すべて現在のトランザクションが開始された時間を返すことを理解してください。この値は、トランザクションが実行されている間は変化しません。 timeofday() は、壁時計時刻を返し、トランザクションが実行されている間にも増加します。

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

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