4.7. 时间/日期函数

4.7.1. EXTRACT，date_part

EXTRACT (field FROM source)

extract 函数从日期/时间数值里抽取 子域，比如年或者小时等．source 是一个值表达式，可以计算出类型 timestamp 或者 interval．(类型为 date 或者 time 的表达式将转换为 timestamp 然后再处理．)field 是一个标识符 或者字串，它指定从源数据中抽取的数域．extract 函数返回类型为double precision 的数值． 下列数值是有效数值∶

世纪

年份域除以100

SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 20

请注意，世纪数据域只是简单的年份域除以100，而不是传统的那样把 大多数19xx年放到二十世纪．

日期

(月分)里的日期域(1-31)

SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 16

年代

年份域除以10

SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 200

星期几(dow)

每周的星期号(0 - 6；星期天是 0) (仅用于 timestamp)

SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 5

年日(doy)

一年的第几天(1 -365/366) (仅用于 timestamp)

SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 47

纪元(epoch)

对于 date 和 timestamp 数值而言， 是自 1970-01-01 00:00:00 以来的秒数(结果可能是负数．)； 对于 interval 数值而言，它是时间间隔的总秒数．

SELECT EXTRACT(EPOCH FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 982352320

SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours');
Result: 442800

小时(hour)

小时域 (0 - 23)

SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 20

微秒(microseconds)

秒域，包括小数部分，乘以 1,000,000．请注意它包括全部的秒．

SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5');
Result: 28500000

千年(millennium)

年域除以 1000

SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 2

请注意千年域只是简单的用 1000 除年域，而不是传统那样定义的 19xx 年是第二个千年．

毫秒(milliseconds)

秒域，包括小数部分，乘以 1000．请注意它包括完整的秒．

SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5');
Result: 28500

分钟(minute)

分钟域 (0 - 59)

SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 38

月份(month)

对于 timestamp 数值，它是一年里的月份数(1 - 12)； 对于 interval 数值，它是月的数目，然后对 12 取模(0 - 11)

SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 2

SELECT EXTRACT(MONTH FROM INTERVAL '2 years 3 months');
Result: 3

SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months');
Result: 1

季度(quarter)

该天所在的该年的季度(1 - 4)(仅用于 timestamp)

SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 1

秒(second)

秒域，包括小数部分 (0 - 59 [1])

SELECT EXTRACT(SECOND FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 40

SELECT EXTRACT(SECOND FROM TIME '17:12:28.5');
Result: 28.5

周(week)

从一个 timestamp 数值里计算该天在所在的年份里 是第几周．根据定义 (ISO 8601)，一年的 第一周包含该年的一月四日．(ISO 的周从星期一开始．) 换句话说，一年的第一个星期四在第一周．

SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 7

年(year)

年份域

SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40');
Result: 2001

extract 函数主要的用途是做运算用． 对于用于显示的日期/时间数值格式化，参阅 Section 4.6．

date_part 函数是在传统的 Ingres 函数的基础上制作的(该 函数等效于 SQL 函数 extract)∶

date_part('field', source)

SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
Result: 16

SELECT date_part('hour', INTERVAL '4 hours 3 minutes')
Result: 4

4.7.2. date_trunc

date_trunc 函数在概念上和用于 数字的 trunc 函数类似．

date_trunc('field', source)

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

4.7.3. 当前日期/时间

我们可以使用下面的函数获取当前的日期和/或时间∶

CURRENT_TIME
CURRENT_DATE
CURRENT_TIMESTAMP

SELECT CURRENT_TIME;
19:07:32

SELECT CURRENT_DATE;
2001-02-17

SELECT CURRENT_TIMESTAMP;
2001-02-17 19:07:32-05

函数 now() 是传统的 Postgres 和 CURRENT_TIMESTAMP 的等效物．

还有一个 timeofday() 函数，它返回比 CURRENT_TIMESTAMP 族函数更高精度的当前时间∶

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

timeofday() 使用操作系统调用 gettimeofday(2)，它可能有高达 微秒的分辩率(具体情况取决于你的平台)；其它依赖 time(2) 的函数的分辩率将局限于 一秒．由于历史原因，timeofday() 返回的结果是文本字串，而不是一个 timestamp 数值．

还有一件事提醒大家，那就是 CURRENT_TIMESTAMP 和相关的函数都把时间当做当前事务的开始返回；在事务运行的时候， 它们的数值并不增加．但 timeofday() 返回当前的实际时间．

所有日期/时间类型还接受特殊的文本值 now， 用于声明当前的日期和时间．因此，下面三个都返回相同的结果∶

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