9.9. 時間/日期函數和操作符

9.9.1. EXTRACT，date_part

EXTRACT (field from source)

extract 函數從日期/時間數值裡抽取 子域，比如年或者小時等。source 必須是一個類型 timestamp，time，或者 interval 的值資料表達式。 （類型為 date 的資料表達式將轉換為 timestamp，因此也可以用。） field 是一個標識符 或者字串，它指定從源資料中抽取的數域。extract 函數返回類型為double precision 的數值。 下列數值是有效資料域的名字︰

extract 函數主要的用途是做運算用。 對於用於顯示的日期/時間數值格式化，參閱 Section 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 的值資料表達式(類型 date 和 time 的數值都分別自動轉換成timestamp或者interval)。 用 field 選擇對該時間戳數值 選用什麼樣的精度進行截斷)。 返回的數值是 timestamp 類型或者interval，所有小於選定的 精度的域都設置為零(或者一，如果是日期和月份域的話)。

field 的有效數值是︰

例子：

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

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

9.9.3. AT TIME ZONE

AT TIME ZONE 構造允許把時間戳轉換成不同的 時區。Table 9-27 顯示了其變體。

在這些資料表達式裡，我們需要的 zone 可以聲明為 文本串（比如，'PST'）或者一個時間間隔 （比如，INTERVAL '-08:00'）。 在文本的情況下，可用的時區名字在 Table B-4 裡顯示。 （可能支援更通用的 Table 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 時間戳，然後這個時間轉換為 PST（UTC-8）來顯示。 第二個例子接受一個聲明為 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() 是傳統的 PostgreSQL 和 CURRENT_TIMESTAMP 的等效物。

還有一個 timeofday() 函數，由於歷史原因， 它返回一個字串，而不是 timestamp 值︰

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

還有一件事提醒大家，那就是 CURRENT_TIMESTAMP 和相關的函數把時間當做目前交易的開始返回；在交易執行的時候， 它們的數值並不改變。 我們認為這是一個特性：目的是為了允許一個交易在"目前" 時間上有連貫的概念，這樣在同一個交易離得多個修改可以有同樣的時間戳。 但 timeofday() 返回目前的實際時間，並且隨著交易的處理會前進。

所有日期/時間類型還接受特殊的文本值 now， 用於聲明目前的日期和時間。因此，下面三個都返回相同的結果︰

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