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);