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

9.8.1. EXTRACT，date_part

EXTRACT (field from source)

extract 函數從日期/時間數值裡抽取 子域，比如年或者小時等．source 是一個值表達式，可以計算出類型 timestamp 或者 interval．(類型為 date 或者 time 的表達式將轉換為 timestamp 然後再處理．)field 是一個標識符 或者字串，它指定從源數據中抽取的數域．extract 函數返回類型為double precision 的數值． 下列數值是有效數據域的名字︰

extract 函數主要的用途是做運算用． 對于用于顯示的日期/時間數值格式化，參閱 Section 9.7．

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.8.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.8.3. AT TIME ZONE

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

在這些表達式裡，我們需要的 zone 可以聲明為 文本串（比如，'PST'）或者一個時間間隔 （比如，INTERVAL '-08:00'）。

例子（假設本地時區是 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.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;
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';