9.9. 时间/日期函数和操作符

Table 9-27显示了 PostgreSQL 里可以用于处理日期/时间数值的函数, 随后一节里描述了细节。表Table 9-26演示了基本算术操作符的行为。(+*, 等)。而与格式化相关的函数,可以参考Section 9.8。 你应该很熟悉Section 8.5的日期/时间数据类型的背景知识。

所有下述函数和操作符接收的timetimestamp输入实际上都来自两种可能: 一种是接收time with time zoneortimestamp with time zone, 另外一种是接收time without time zonetimestamp without time zone。 出于简化考虑,这些变种没有独立显示出来。还有,+*操作符都是以可交换的操作符对(比如, date + integer 和 integer + date);我们只显示了这样的交换操作符对中的一个。

Table 9-26. 日期/时间操作符

操作符示例结果
+date '2001-09-28' + integer '7'date '2001-10-05'
+date '2001-09-28' + interval '1 hour'timestamp '2001-09-28 01:00:00'
+date '2001-09-28' + time '03:00'timestamp '2001-09-28 03:00:00'
+interval '1 day' + interval '1 hour'interval '1 day 01:00:00'
+timestamp '2001-09-28 01:00' + interval '23 hours'timestamp '2001-09-29 00:00:00'
+time '01:00' + interval '3 hours'time '04:00:00'
-- interval '23 hours'interval '-23:00:00'
-date '2001-10-01' - date '2001-09-28'integer '3'(days)
-date '2001-10-01' - integer '7'date '2001-09-24'
-date '2001-09-28' - interval '1 hour'timestamp '2001-09-27 23:00:00'
-time '05:00' - time '03:00'interval '02:00:00'
-time '05:00' - interval '2 hours'time '03:00:00'
-timestamp '2001-09-28 23:00' - interval '23 hours'timestamp '2001-09-28 00:00:00'
-interval '1 day' - interval '1 hour'interval '1 day -01:00:00'
-timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00'interval '1 day 15:00:00'
*900 * interval '1 second'interval '00:15:00'
*21 * interval '1 day'interval '21 days'
*double precision '3.5' * interval '1 hour'interval '03:30:00'
/interval '1 hour' / double precision '1.5'interval '00:40:00'

Table 9-27. 日期/时间函数

函数返回类型描述示例结果
age(timestamptimestamp)interval参数相减, 返回一个使用年数和月份数的"符号"表示的结果age(timestamp '2001-04-10', timestamp '1957-06-13')43 years 9 mons 27 days
age(timestamp)intervalcurrent_date(午夜)减去参数后的结果age(timestamp '1957-06-13')43 years 8 mons 3 days
clock_timestamp()timestamp with time zone 实时时钟的当前时间戳(在语句执行中值会改变);见Section 9.9.4  
current_datedate 当前日期;见Section 9.9.4   
current_timetime with time zone 当前时间;见Section 9.9.4   
current_timestamptimestamp with time zone 当前事务开始时的时间戳;见Section 9.9.4   
date_part(texttimestamp)double precision 获取子域(等效于extract);见Section 9.9.1 date_part('hour', timestamp '2001-02-16 20:38:40')20
date_part(textinterval)double precision 获取子域(等效于extract);见Section 9.9.1 date_part('month', interval '2 years 3 months')3
date_trunc(texttimestamp)timestamp 截断成指定的精度;见Section 9.9.2 date_trunc('hour', timestamp '2001-02-16 20:38:40')2001-02-16 20:00:00
extract(fieldfrom timestamp)double precision获取子域;见Section 9.9.1 extract(hour from timestamp '2001-02-16 20:38:40')20
extract(fieldfrom interval)double precision 获取子域;又见 seeSection 9.9.1 extract(month from interval '2 years 3 months')3
isfinite(date)boolean测试是否为有穷日期isfinite(date '2001-02-16')true
isfinite(timestamp)boolean测试是否为有穷时间戳isfinite(timestamp '2001-02-16 21:28:30')true
isfinite(interval)boolean测试是否为有穷时间间隔isfinite(interval '4 hours')true
justify_days(interval)interval按照每月 30 天计算时间间隔justify_days(interval '35 days')1 mon 5 days
justify_hours(interval)interval按照每天 24 小时计算时间间隔justify_hours(interval '27 hours')1 day 03:00:00
justify_interval(interval)intervaljustify_daysjustify_hours计算时间间隔的,加上相应的正负号。 justify_interval(interval '1 mon -1 hour')29 days 23:00:00
localtimetime 当前时间;见Section 9.9.4   
localtimestamptimestamp 当前事务开始时的时间戳;见Section 9.9.4   
now()timestamp with time zone 当前事务开始时的时间戳;见Section 9.9.4   
statement_timestamp()timestamp with time zone 当前语句开始的时间戳;见Section 9.9.4   
timeofday()text 当前日期时间,与clock_timestamp相同,但结果是一个text字符串;见Section 9.9.4  
transaction_timestamp()timestamp with time zone 当前事务开始时的时间戳;见Section 9.9.4   

除了这些函数以外,还支持 SQL 的 OVERLAPS 操作符:

(start1end1) OVERLAPS (start2end2)
(start1length1) OVERLAPS (start2length2)

这个表达式在两个时间域(用它们的终点定义)重叠的时候生成真值,否则为假。 终点可以用一对日期、时间、时间戳来声明;或者是一个后面跟着时间间隔的日期、时间、时间戳。 当提供一对值,不管先写开始还是结束;OVERLAPS自动将这对值较早的作为开始。 每段时间取值为半开区间开始<=时间<结束, 除非开始和结束相等,表示单一的时刻。这意味着两个时间段只有一个共同的端点没有重叠。

SELECT (DATE '2001-02-16', DATE '2001-12-21') OVERLAPS
       (DATE '2001-10-30', DATE '2002-10-30');
Result:true
SELECT (DATE '2001-02-16', INTERVAL '100 days') OVERLAPS
       (DATE '2001-10-30', DATE '2002-10-30');
Result:false
SELECT (DATE '2001-10-29', DATE '2001-10-30') OVERLAPS
       (DATE '2001-10-30', DATE '2001-10-31');
Result:false
SELECT (DATE '2001-10-30', DATE '2001-10-30') OVERLAPS
       (DATE '2001-10-30', DATE '2001-10-31');
Result:true

当把interval值添加到timestamp with time zone上(或从中减去)的时候, days 部分会按照指定的天数增加(或减少)timestamp with time zone的日期。 对于横跨夏令时的变化(会话的时区设置被识别为夏时制),interval '1 day'并 不一定等于interval '24 hours'。例如,当会话的时区设置为CST7CDT的时候, timestamp with time zone '2005-04-02 12:00-07' + interval '1 day' 的结果 是 timestamp with time zone '2005-04-03 12:00-06' ,而 将interval '24 hours'增加到相同的timestamp with time zone之上的结果 则是timestamp with time zone '2005-04-03 12:00-06', 因为CST7CDT时区在2005-04-03 02:00的时候有一个夏令时变更。

注意age返回的月数可能有歧义,因为不同的月份有不同的天数。 PostgreSQL的方法是当计算部分月数时,采用两个日期较早的月。例如:age('2004-06-01', '2004-04-30') 使用4月份产生1 mon 1 day,当用5月分时产生1 mon 2 days,因为5月有31天,而4月只有30天。

9.9.1. EXTRACTdate_part

EXTRACT(fieldFROMsource)

extract函数从日期/时间数值里抽取子域,比如年、小时等。 source必须是一个 typetimestamptimeinterval类型的值 表达式(类型为date的表达式将转换为timestamp,因此也可以用)。 field是一个标识符或者字符串,它指定从源数据中抽取的域。 extract函数返回类型为 double precision 的数值。下列数值是有效数据域的名字:

century

世纪

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

第一个世纪从 0001-01-01 00:00:00 AD 开始,尽管那时候人们还不知道 这是第一个世纪。这个定义适用于所有使用阳历的国家。没有 0 世纪, 我们直接从公元前 1 世纪到公元 1 世纪。 如果你认为这个不合理,那么请把抱怨发给:梵蒂冈,罗马圣彼得教堂,教皇收

PostgreSQL8.0 以前版本里并不遵循世纪的习惯编号,只是把年份除以 100 。

day

(月份)里的天(1-31)

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

年份除以 10

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

周中天的索引(0-6 ;星期天是 0)

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

请注意,extract的周中天编号和to_char(..., 'D')函数不同。

doy

一年的第几天(1-365/366)

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

对于datetimestamp值而言,是自 1970-01-01 00:00:00-00 以来的秒数 (结果可能是负数);对于interval值而言,它是时间间隔的总秒数。

SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08');
结果:982384720.12

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

下面是把 epoch 值转换回时间戳的方法:

SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second';

(Theto_timestampfunction encapsulates the above conversion.)

hour

The hour field (0 - 23)小时域(0-23)

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

周中的第几天 [1-7] 星期一:1) 星期天:(7)。

SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40');
结果:7

dow除了星期天外,都相同。这与ISO8601标准周中的第几天编码相匹配。 matches theISO8601 day of the week numbering.

isoyear

日期中的ISO8601标准年(不适用于间隔)。

SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01');
结果:2005
SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02');
结果:2006

每个带有星期一开始的周中包含1月4日的ISO年, 所以在年初的1月或12月下旬的ISO年可能会不同与阳历的年。 见week获取更多信息。

这个域不能用于 PostgreSQL 8.3之前的版本。

microseconds

秒域(包括小数部分)乘以 1,000,000 。请注意它包括全部的秒。

SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5');
结果:28500000
millennium

千年

SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40');
结果:3

20 世纪(19xx 年)里面的年份在第二个千年里。第三个千年从 2001 年 1 月 1 日零时开始。

PostgreSQL8.0 之前的版本并不遵循千年编号的习惯,只是返回年份除以 1000 。

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

Fortimestampvalues, the number of the month within the year (1 - 12) ; forintervalvalues the number of months, modulo 12 (0 - 11) 对于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
timezone

与UTC的时区偏移量,以秒记。正数对应 UTC 东边的时区,负数对应 UTC 西边的时区

timezone_hour

时区偏移量的小时部分。

timezone_minute

时区偏移量的分钟部分。

week

该天在所在的年份里是第几周。 (ISO8601)定义一年的第一周包含该年的一月四日(ISO-8601 的周从星期一开始)。 换句话说,一年的第一个星期四在第一周。(只用于 timestamp 值)

因此,一月的头几天可能是前一年的第 52 或者第 53 周。 比如,2005-01-01是 2004 年的第 53 周,而2006-01-01是 2005 年的第 52 周

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

年份域。要记住这里没有0 AD,所以从AD年里抽取BC年应该小心些

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

extract函数主要的用途是运算。对于用于显示的日期/时间数值格式化,见Section 9.8

date_part函数是仿照在传统的Ingres函数。等效于 SQL 标准函数extract

date_part('field',source)

Note that here thefieldparameter needs to be a string value, not a name. The valid field names for date_partare the same as for extract. 请注意这里的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)

sourcetimestampinterval类型的值表达式 (datetime类型的值都分别自动转换成timestampinterval)。 用field选择对该时间戳值用什么样的精度进行截断。返回的数值 是timestampinterval类型, 所有小于选定的精度的域都设置为零(日期和月份域则为 1)。

field的有效数值是:

microseconds
milliseconds
second
minute
hour
day
week
month
quarter
year
decade
century
millennium

例如:

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构造允许把时间戳转换成不同的时区。表Table 9-28显示了其变体。

Table 9-28. AT TIME ZONE变体

表达式返回类型描述
timestamp without time zoneAT TIME ZONEzone timestamp with time zone 将不带时区without time zone的时间戳转换成给定时区的时间戳
timestamp with time zoneAT TIME ZONEzone timestamp without time zone 将带时区with time zone的时间戳转换为不带时区的时间。
time with time zoneAT TIME ZONEzone time with time zone 将带时区with time zone的时间转换成给定时区的时间

在这些表达式里,zone可以声明为文本串(比如'PST')或者一个 时间间隔(比如INTERVAL '-08:00')。 在文本的情况下,可用的时区名字在Section 8.5.3有详细描述

Examples (assuming the local time zone isPST8PDT): 例子(假设本地时区是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(zonetimestamp) 函数等效于 SQL 兼容的构造timestampAT TIME ZONEzone

9.9.4. 当前日期/时间

PostgreSQL提供许多返回当前日期和时间的函数。 这些符合 SQL 标准的函数全部都按照当前事务的开始时刻返回结果:

CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_TIME(precision)
CURRENT_TIMESTAMP(precision)
LOCALTIME
LOCALTIMESTAMP
LOCALTIME(precision)
LOCALTIMESTAMP(precision)

CURRENT_TIMECURRENT_TIMESTAMP返回带有时区的值; LOCALTIMELOCALTIMESTAMP返回不带时区的值

CURRENT_TIMECURRENT_TIMESTAMPLOCALTIMELOCALTIMESTAMP 可以有选择地给予一个精度参数,该精度导致结果的秒数域四舍五入到指定小数位。 如果没有精度参数,将给予所能得到的全部精度。

一些示例:

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

因为这些函数全部都按照当前事务的开始时刻返回结果,所以它们的值在事务运行的整个期间内都不改变。 我们认为这是一个特性:目的是为了允许一个事务在"当前时间"上有连贯的概念, 这样在同一个事务里的多个修改可以保持同样的时间戳。

Note: 许多其它数据库系统更频繁地更新这些数值

PostgreSQL同样也提供了返回实时时间值的函数, 它们的返回值会在事务中随时间的前进而变化。 这些不附合 SQL 标准的函数列表如下:

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

transaction_timestamp()等效于CURRENT_TIMESTAMP,不过其命名准确的表明了其 含义。statement_timestamp()返回当前事务开始时刻的时间戳(更准确的说是收到 客户端最后一条命令的时间)。statement_timestamp()transaction_timestamp() 在一个事务的第一条命令里返回值相同,但是在随后的命令中却不一定相同。 clock_timestamp()返回实时时钟的当前时间戳,因此它的值甚至在同一条 SQL 命令中都会变化。timeofday()相当于clock_timestamp(),也返回实时 时钟的当前时间戳,由于历史原因, 它返回一个text字符串,而不是timestamp with time zone值。 now()PostgreSQL的一个传统的等效于transaction_timestamp()

所有日期/时间类型还接受特殊的文本值now,用于声明当前的日期和时间(重申:当前事务的开始时刻)。 因此,下面三个都返回相同的结果

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

Tip: 在创建表的时候你不应该用第三种形式声明一个DEFAULT值。 系统将在分析这个常量的时候把now转换为一个timestamp, 因此这个缺省值就会变成创建表的时间!而前两种形式要到实际使用缺省值的时候才计算, 因为它们是函数调用。因此它们可以给出每次插入行的时刻。

9.9.5. 延时执行

下面的这个函数可以用于让服务器进程延时执行:

pg_sleep(seconds)

pg_sleep让当前的会话进程休眠seconds秒以后再执行。 seconds是一个double precision类型的值,所以可以指定带小数的秒数。 例如:

SELECT pg_sleep(1.5);

Note: 有效的休眠时间间隔精度是平台相关的,通常 0.01 秒是通用的。休眠的时间将至少等于指定的时间, 也有可能由于服务器荷载较重等原因而比指定的时间长。

Warning

请确保调用pg_sleep的会话没有持有不必要的锁。否则其它会话可能必须等待这个休眠的会话释放所持有的锁,从而减慢系统速度。

Notes

[1]

60 ,如果闰秒由操作系统实现。