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

9.9.1. EXTRACT, date_part

EXTRACT(field FROM source)

extract 函數從日期/時間數值裡抽取子域，比如年、小時等。source 必須是一個 timestamp, time, interval 類型的值表達式(類型為 date 的表達式將轉換為 timestamp ，因此也可以用)。field 是一個標識符或者字符串，它指定從源數據中抽取的域。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 選擇對該時間戳值用什麼樣的精度進行截斷。返回的數值是 timestamp 或 interval 類型，所有小於選定的精度的域都設置為零(日期和月份域則為 1)。

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')。在文本的情況下，可用的時區名字在節8.5.3有詳細描述。

例子(假設本地時區是 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. 當前日期/時間

PostgreSQL 提供許多返回當前日期和時間的函數。這些符合 SQL 標準的函數全部都按照當前事務的開始時刻返回結果：

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

因為這些函數全部都按照當前事務的開始時刻返回結果，所以它們的值在事務運行的整個期間內都不改變。我們認為這是一個特性：目的是為了允許一個事務在"當前時間"上有連貫的概念，這樣在同一個事務裡的多個修改可以保持同樣的時間戳。

PostgreSQL 同樣也提供了返回實時時間值的函數，它們的返回值會在事務中隨時間的前進而變化。這些不附合 SQL 標準的函數列表如下：

now()
transaction_timestamp()
statement_timestamp()
clock_timestamp()
timeofday()

now() 是傳統的 PostgreSQL 和 CURRENT_TIMESTAMP 等效的函數。transaction_timestamp() 等效於 CURRENT_TIMESTAMP ，不過其命名準確的表明了其含義。statement_timestamp() 返回當前事務開始時刻的時間戳(更準確的說是收到客戶端最後一條命令的時間)。statement_timestamp() 和 transaction_timestamp() 在一個事務的第一條命令裡返回值相同，但是在隨後的命令中卻不一定相同。clock_timestamp() 返回實時時鐘的當前時間戳，因此它的值甚至在同一條 SQL 命令中都會變化。timeofday() 相當於 clock_timestamp() ，也返回實時時鐘的當前時間戳，由於曆史原因，它返回一個 text 字符串，而不是 timestamp with time zone 值。

所有日期/時間類型還接受特殊的文本值 now ，用於聲明當前的日期和時間(重申：當前事務的開始時刻)。因此，下麵三個都返回相同的結果：

SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP 'now';  -- incorrect for use with DEFAULT

9.9.5. 延時執行

下麵的這個函數可以用於讓服務器進程延時執行：

pg_sleep(seconds)

pg_sleep 讓當前的會話進程休眠 seconds 秒以後再執行。seconds 是一個 double precision 類型的值，所以可以指定帶小數的秒數。例如：

SELECT pg_sleep(1.5);