PostgreSQL 9.3.4 文档 | ||||
---|---|---|---|---|
Prev | Up | Chapter 9. 函数和操作符 | Next |
Table 9-27展示了可用于处理日期/时间值的函数,其细节在随后的小节中描述。Table 9-26演示了基本算术操作符 (+、*等)的行为。 而与格式化相关的函数,可以参考Section 9.8。你应该很熟悉Section 8.5中的日期/时间数据类型的背景知识。
所有下文描述的接受time或timestamp输入的函数和操作符实际上都有两种变体: 一种接收time with time zone或timestamp with time zone, 另外一种接受time without time zone或者 timestamp 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(timestamp, timestamp)
| interval | 减去参数,生成一个使用年、月的"符号化"的结果 | age(timestamp '2001-04-10', timestamp '1957-06-13') | 43 年 9 月 27 日 |
age(timestamp) | interval | 从current_date (在午夜)减去 | age(timestamp '1957-06-13') | 43 years 8 mons 3 days |
clock_timestamp()
| timestamp with time zone | 当前日期和时间(在语句执行期间变化);见Section 9.9.4 | ||
current_date
| date | 当前日期;见Section 9.9.4 | ||
current_time
| time with time zone | 当前时间(一天中的时间);见Section 9.9.4 | ||
current_timestamp
| timestamp with time zone | 当前日期和时间(当前事务开始时);见Section 9.9.4 | ||
date_part(text, timestamp)
| double precision | 获得子域(等价于extract );见Section 9.9.1
| date_part('hour', timestamp '2001-02-16 20:38:40') | 20 |
date_part(text, interval) | double precision | 获得子域(等价于extract );见Section 9.9.1
| date_part('month', interval '2 years 3 months') | 3 |
date_trunc(text, timestamp)
| timestamp | 截断到指定精度;另见Section 9.9.2 | date_trunc('hour', timestamp '2001-02-16 20:38:40') | 2001-02-16 20:00:00 |
extract (field from
timestamp)
| double precision | 获得子域;见Section 9.9.1 | extract(hour from timestamp '2001-02-16 20:38:40') | 20 |
extract (field from
interval) | double precision | 获得子域;见Section 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)
| interval | 使用justify_days 和justify_hours 调整间隔,使用额外的符号调整 | justify_interval(interval '1 mon -1 hour') | 29 days 23:00:00 |
localtime
| time | 当前时间(一天中的时间);见Section 9.9.4 | ||
localtimestamp
| timestamp | 当前日期和时间(当前事务的开始);见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:
(start1, end1) OVERLAPS (start2, end2) (start1, length1) OVERLAPS (start2, length2)
这个表达式在两个时间域(用它们的端点定义)重叠的时候得到真,当它们不重叠时得到假。端点可以用一对日期、时间或者时间戳来指定;或者是用一个后面跟着一个间隔的日期、时间或时间戳来指定。当一对值被提供时,起点或终点都可以被写在前面,OVERLAPS会自动地把较早的值作为起点。每一个时间段被认为是表示半开的间隔start <= time < end,除非start和end相等,这种情况下它表示单个时间实例。例如这表示两个只有一个共同端点的时间段不重叠。
SELECT (DATE '2001-02-16', DATE '2001-12-21') OVERLAPS (DATE '2001-10-30', DATE '2002-10-30'); 结果:true SELECT (DATE '2001-02-16', INTERVAL '100 days') OVERLAPS (DATE '2001-10-30', DATE '2002-10-30'); 结果:false SELECT (DATE '2001-10-29', DATE '2001-10-30') OVERLAPS (DATE '2001-10-30', DATE '2001-10-31'); 结果:false SELECT (DATE '2001-10-30', DATE '2001-10-30') OVERLAPS (DATE '2001-10-30', DATE '2001-10-31'); 结果:true
当把一个interval值添加到timestamp with time zone上(或从中减去)时, days 部分会按照指定的天数增加(或减少)timestamp with time zone的日期。 对于横跨夏令时的变化(会话的时区被设置为可识别DST的时区),这意味着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 13: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天。
EXTRACT
, date_part
EXTRACT(field FROM source)
extract
函数从日期/时间值中抽取子域,例如年或者小时等。source必须是一个类型 timestamp、time或interval的值表达式(类型为date的表达式将被造型为 timestamp,并且因此也可以被同样使用)。field是一个标识符或者字符串,它指定从源值中抽取的域。extract
函数返回类型为double precision的值。 下列值是有效的域名字∶
世纪
SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13'); 结果:20 SELECT EXTRACT(CENTURY FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:21
第一个世纪从 0001-01-01 00:00:00 AD 开始, 尽管那时候人们还不知道这是第一个世纪。这个定义适用于所有使用格里高利历法的国家。其中没有 0 世纪,我们直接从公元前 1 世纪到公元 1 世纪。 如果你认为这个不合理,那么请把抱怨发给:罗马圣彼得教堂,梵蒂冈,教皇收。
PostgreSQL 8.0 以前的版本中并不遵循习惯的世纪编号,只是把年份除以100。
对于timestamp值,是(月份)里的日域(1-31);对于interval值,是日数
SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:16 SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute'); 结果:40
年份域除以10
SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:200
一周中的日,从周日(0)到周六(6)
SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:5
请注意,extract
的一周中的日和to_char(..., 'D')
函数不同。
一年的第几天(1 -365/366)
SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:47
对于timestamp with time zone值, 是自 1970-01-01 00:00:00 UTC 以来的秒数(结果可能是负数); 对于date and timestamp值,是自本地时间 1970-01-01 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
下面是把纪元值转换回时间戳的方法:
SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second';
(to_timestamp
函数封装了上述转换)。
小时域(0 - 23)
SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:20
一周中的日,从周一(1)到周日(7)
SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40'); 结果:7
除了周日,这和dow相同。这符合ISO 8601 中一周中的日的编号。
日期所落在的ISO 8601 年(不适用于间隔)
SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01'); 结果:2005 SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); 结果:2006
每一个ISO年都开始于包含1月4日的那一周的周一,在早的1月或迟的12月中ISO年可能和格里高利年不同。更多信息见week域。
这个域不能用于 PostgreSQL 8.3之前的版本。
秒域,包括小数部分,乘以 1,000,000。请注意它包括全部的秒
SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5'); 结果:28500000
千年
SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:3
19xx的年份在第二个千年里。第三个千年从 2001 年 1 月 1 日开始。
PostgreSQL 8.0 之前的版本并不遵循千年编号的习惯,只是返回年份除以 1000。
秒域,包括小数部分,乘以 1000。请注意它包括完整的秒。
SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); 结果:28500
分钟域(0 - 59)
SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:38
对于timestamp值,它是一年里的月份数(1 - 12); 对于interval值,它是月的数目,然后对 12 取模(0 - 11)
SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:2 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 3 months'); 结果:3 SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months'); 结果:1
该天所在的该年的季度(1 - 4)
SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:1
秒域,包括小数部分(0 - 59[1])
SELECT EXTRACT(SECOND FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:40 SELECT EXTRACT(SECOND FROM TIME '17:12:28.5'); 结果:28.5
与 UTC 的时区偏移,以秒记。正数对应 UTC 东边的时区,负数对应 UTC 西边的时区(从技术上来看,PostgreSQL使用UT1,因为闰秒没有被处理)。
时区偏移的小时部分。
时区偏移的分钟部分。
该天在所在的年份里是第几周。根据定义(ISO 8601), 一年的第一周包含该年的 1月 4 日(ISO-8601的周从星期一开始)。换句话说,一年的第一个星期四在第一周。
在 ISO 定义中,早的 1 月的日期可能位于前一年的第五十二或者第五十三周,而迟的 12 月的日期可能位于下一年的第一周。例如, 2005-01-01位于 2004 年的第五十三周,并且2006-01-01位于 2005 年的第五十二周,而2012-12-31位于 2013 年的第一周。我们推荐把isoyear域和week一起使用来得到一致的结果。
SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:7
年份域。要记住这里没有0 AD,所以从AD年里抽取BC年应该小心处理。
SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:2001
extract
函数主要的用途是做计算性处理。对于用于显示的日期/时间值格式化,参阅Section 9.8。
在传统的Ingres上建模的date_part
函数等价于SQL标准函数extract
:
date_part('field', source)
请注意这里的field参数必须是一个串值,而不是一个名字。有效的date_part
域名 和extract
相同。
SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); 结果:16 SELECT date_part('hour', INTERVAL '4 hours 3 minutes'); 结果:4
date_trunc
date_trunc
函数在概念上和用于数字的trunc
函数类似。
date_trunc('field', source)
source是类型timestamp或interval的值表达式(类型date和 time的值都分别被自动转换成timestamp或者interval)。field选择对输入值选用什么样的精度进行截断。返回的值是timestamp类型或者所有小于选定的 精度的域都设置为零(或者一,对于日期和月份)的interval。
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'); 结果:2001-02-16 20:00:00 SELECT date_trunc('year', TIMESTAMP '2001-02-16 20:38:40'); 结果:2001-01-01 00:00:00
AT TIME ZONE结构允许把时间戳转换成不同的时区。Table 9-28展示了其变体。
Table 9-28. AT TIME ZONE Variants
表达式 | 返回类型 | 描述 |
---|---|---|
timestamp without time zone AT TIME ZONE zone | timestamp with time zone | 把给定的不带时区的时间戳当作位于指定时区的时间对待 |
timestamp with time zone AT TIME ZONE zone | timestamp without time zone | 把给定的带时区的时间戳转换到新的时区,不带时区指定 |
time with time zone AT TIME ZONE zone | time with time zone | 把给定的带时区的时间转换到新时区 |
在这些表达式里,我们需要的时区zone可以指定为文本串(例如,'PST')或者一个间隔 (例如,INTERVAL '-08:00')。 在文本情况下,可用的时区名字可以用Section 8.5.3中描述的任何方式指定。
例子(假设本地时区是PST8PDT):
SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'MST'; 结果:2001-02-16 19:38:40-08 SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'MST'; 结果:2001-02-16 18:38:40
第一个例子接受一个无时区的时间戳然后把它解释成 MST 时间(UTC-7),然后这个时间转换为 PST(UTC-8)来显示。 第二个例子接受一个指定为 EST(UTC-5)的时间戳,然后把它 转换成 MST(UTC-7)的当地时间。
函数timezone
(zone, timestamp)等效于 SQL 兼容的结构timestamp AT TIME ZONE zone。
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; 结果:14:39:53.662522-05 SELECT CURRENT_DATE; 结果:2001-12-23 SELECT CURRENT_TIMESTAMP; 结果:2001-12-23 14:39:53.662522-05 SELECT CURRENT_TIMESTAMP(2); 结果:2001-12-23 14:39:53.66-05 SELECT LOCALTIMESTAMP; 结果: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()
是一个有历史原因的PostgreSQL函数。和clock_timestamp()
相似,timeofday()
也返回真实的当前时间,但是它的结果是一个格式化的text串,而不是timestamp with time zone值。now()
是PostgreSQL的一个传统,等效于transaction_timestamp()
。
所有日期/时间类型还接受特殊的文字值now,用于指定当前的日期和时间(重申,被解释为当前事务的开始时刻)。 因此,下面三个都返回相同的结果:
SELECT CURRENT_TIMESTAMP; SELECT now(); SELECT TIMESTAMP 'now'; -- 对于和 DEFAULT 一起使用是不正确的
Tip: 在创建表期间指定一个DEFAULT子句时,你不会希望使用第三种形式。系统将在分析这个常量的时候把now转换为一个timestamp, 这样需要默认值时就会得到创建表的时间!而前两种形式要到实际使用缺省值的时候才被计算, 因为它们是函数调用。因此它们可以给出每次插入行的时刻。
下面的这个函数可以用于让服务器进程延时执行:
pg_sleep(seconds)
pg_sleep
让当前的会话进程休眠seconds秒以后再执行。seconds是一个double precision类型的值,所以可以指定带小数的秒数。例如:
SELECT pg_sleep(1.5);
Note: 有效的休眠时间间隔精度是平台相关的,通常 0.01 秒是通用值。休眠延迟将至少持续指定的时长, 也有可能由于服务器负荷而比指定的时间长。
Warning |
请确保在调用 |
[1] | 如果操作系统实现了闰秒,则为60 |