©
이 문서에서는 PHP 중국어 웹사이트 매뉴얼 풀어 주다
Table 9-27显示了 PostgreSQL 里可以用于处理日期/时间数值的函数， 随后一节里描述了细节。表Table 9-26演示了基本算术操作符的行为。(+， *， 等)。而与格式化相关的函数，可以参考Section 9.8。 你应该很熟悉Section 8.5的日期/时间数据类型的背景知识。
所有下述函数和操作符接收的time或timestamp输入实际上都来自两种可能： 一种是接收time with time zoneortimestamp 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 years 9 mons 27 days |
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(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) |
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自动将这对值较早的作为开始。 每段时间取值为半开区间开始<=时间<结束， 除非开始和结束相等，表示单一的时刻。这意味着两个时间段只有一个共同的端点没有重叠。
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天。
EXTRACT，date_part
EXTRACT(fieldFROMsource)
extract函数从日期/时间数值里抽取子域，比如年、小时等。
source必须是一个 typetimestamp，time，interval类型的值
表达式(类型为date的表达式将转换为timestamp，因此也可以用)。
field是一个标识符或者字符串，它指定从源数据中抽取的域。
extract函数返回类型为 double precision 的数值。下列数值是有效数据域的名字：
世纪
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 。
(月份)里的天(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
周中天的索引(0-6 ；星期天是 0)
SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40'); Result:5
请注意，extract的周中天编号和to_char(...， 'D')函数不同。
一年的第几天(1-365/366)
SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40'); Result:47
对于date和timestamp值而言，是自 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.)
The hour field (0 - 23)小时域(0-23)
SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40'); 结果:20
周中的第几天 [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.
日期中的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之前的版本。
秒域(包括小数部分)乘以 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
20 世纪(19xx 年)里面的年份在第二个千年里。第三个千年从 2001 年 1 月 1 日零时开始。
PostgreSQL8.0 之前的版本并不遵循千年编号的习惯，只是返回年份除以 1000 。
秒域(包括小数部分)乘以 1000 。请注意它包括完整的秒。
SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5'); Result:28500
分钟域(0-59)
SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40'); Result:38
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
日期中年所在季度(1-4)(仅用于 timestamp 值)
SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40'); Result:1
秒域，包括小数部分(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
与UTC的时区偏移量，以秒记。正数对应 UTC 东边的时区，负数对应 UTC 西边的时区
时区偏移量的小时部分。
时区偏移量的分钟部分。
该天在所在的年份里是第几周。 (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
年份域。要记住这里没有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
date_trunc
.
date_trunc函数在概念上和用于数字的trunc函数类似。
date_trunc('field'，source)
source是timestamp或interval类型的值表达式 (date和time类型的值都分别自动转换成timestamp或interval)。 用field选择对该时间戳值用什么样的精度进行截断。返回的数值 是timestamp或interval类型， 所有小于选定的精度的域都设置为零(日期和月份域则为 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
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(zone，timestamp)
函数等效于 SQL 兼容的构造timestampAT TIME ZONEzone
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
因为这些函数全部都按照当前事务的开始时刻返回结果，所以它们的值在事务运行的整个期间内都不改变。 我们认为这是一个特性：目的是为了允许一个事务在"当前时间"上有连贯的概念， 这样在同一个事务里的多个修改可以保持同样的时间戳。
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， 因此这个缺省值就会变成创建表的时间！而前两种形式要到实际使用缺省值的时候才计算， 因为它们是函数调用。因此它们可以给出每次插入行的时刻。
下面的这个函数可以用于让服务器进程延时执行：
pg_sleep(seconds)
pg_sleep让当前的会话进程休眠seconds秒以后再执行。
seconds是一个double precision类型的值，所以可以指定带小数的秒数。
例如：
SELECT pg_sleep(1.5);
Note: 有效的休眠时间间隔精度是平台相关的，通常 0.01 秒是通用的。休眠的时间将至少等于指定的时间， 也有可能由于服务器荷载较重等原因而比指定的时间长。
| Warning |
请确保调用 |
| [1] | 60 ，如果闰秒由操作系统实现。 |