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