添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
8.5.1. 日期/时间输入
8.5.2. 日期/时间输出
8.5.3. 时区
8.5.4. 间隔输入
8.5.5. 间隔输出

PostgreSQL 支持 SQL 中所有的日期和时间类型,如表 8.9所示。这些数据类型上可用的操作如 第 9.9 节 所述。日期根据公历来计算,即使对于该历法被引入之前的年份也一样(见 第 B.6 节 )。

表 8.9. 日期/时间类型

名字 存储尺寸 描述 最小值 最大值 解析度
timestamp [ ( p ) ] [ without time zone ] 8字节 包括日期和时间(无时区) 4713 BC 294276 AD 1微秒
timestamp [ ( p ) ] with time zone 8字节 包括日期和时间,有时区 4713 BC 294276 AD 1微秒
date 4字节 日期(没有一天中的时间) 4713 BC 5874897 AD 1日
time [ ( p ) ] [ without time zone ] 8字节 一天中的时间(无日期) 00:00:00 24:00:00 1微秒
time [ ( p ) ] with time zone 12字节 仅仅是一天中的时间(没有日期),带有时区 00:00:00+1459 24:00:00-1459 1微秒
interval [ fields ] [ ( p ) ] 16字节 时间间隔 -178000000年 178000000年 1微秒

注意

SQL要求只写 timestamp 等效于 timestamp without time zone ,并且 PostgreSQL 鼓励这种行为。 timestamptz 被接受为 timestamp with time zone 的一种简写,这是一种 PostgreSQL 的扩展。 time timestamp interval 接受一个可选的精度值 p ,这个精度值声明在秒域中小数点之后保留的位数。缺省情况下,在精度上没有明确的边界。 p 允许的范围是从 0 到 6。 interval 类型有一个附加选项,它可以通过写下面之一的短语来限制存储的fields的集合: MONTH MINUTE SECOND YEAR TO MONTH DAY TO HOUR DAY TO MINUTE DAY TO SECOND HOUR TO MINUTE HOUR TO SECOND MINUTE TO SECOND 注意如果 fields p 被指定, fields 必须包括 SECOND ,因为精度只应用于秒。 类型 time with time zone 是 SQL 标准定义的,但是该定义显示出了一些会影响可用性的性质。在大多数情况下, date time timestamp without time zone timestamp with time zone 的组合就应该能提供任何应用所需的全范围的日期/时间功能。

8.5.1.  日期/时间输入

日期和时间的输入可以接受几乎任何合理的格式,包括 ISO 8601、 SQL -兼容的、传统 POSTGRES 的和其他的形式。 对于一些格式,日期输入里的日、月和年的顺序会让人混淆, 并且支持指定所预期的这些域的顺序。把 DateStyle 参数设置为 MDY ,就是选择“月-日-年”的解释,设置为 DMY 就是 “日-月-年”,而 YMD 是 “年-月-日”。 PostgreSQL 在处理日期/时间输入上比 SQL 标准要求的更灵活。 参阅 附录 B 获取关于日期/时间输入的准确的分析规则和可识别文本域,包括月份、星期几和时区。 请记住任何日期或者时间的文字输入需要由单引号包围,就象一个文本字符串一样。参考 第 4.1.2.7 节 获取更多信息。 SQL 要求下面的语法

type [ (p) ] 'value'
     其中p是一个可选的精度声明,它给出了在秒域中的小数位数目。精度可以被指定给timetimestampinterval类型,并且可以取从0到6的值。这允许前文所述的值。如果在一个常数声明中没有指定任何精度,它将默认取文字值的精度(但不能超过6位)。
    

8.5.1.3. 时间戳

时间戳类型的有效输入由一个日期和时间的串接组成,后面跟着一个可选的时区,一个可选的AD或者BC(另外,AD/BC可以出现在时区前面,但这个顺序并非最佳)。 因此:

1999-01-08 04:05:06

1999-01-08 04:05:06 -8:00
      都是有效的值,它遵循ISO 8601 标准。另外,使用广泛的格式:

January 8 04:05:06 1999 PST
      也被支持。
      SQL标准通过+或者-符号的存在以及时间后面的时区偏移来区分timestamp without time zonetimestamp with time zone文字。因此,根据标准,

TIMESTAMP '2004-10-19 10:23:54'
      是一个timestamp without time zone, 而

TIMESTAMP '2004-10-19 10:23:54+02'
      是一个timestamp with time zonePostgreSQL从来不会在确定文字串的类型之前检查其内容,因此会把上面两个都看做是 timestamp without time zone。
      因此要保证把上面的文字当作timestamp with time zone看待, 就要给它正确的显式类型:

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'
      如果一个文字已被确定是timestamp without time zonePostgreSQL将不声不响忽略任何其中指出的时区。 
      即,结果值是从输入值的日期/时间域衍生出来的,并且没有就时区进行调整。
      对于timestamp with time zone,内部存储的值总是 UTC (全球统一时间,以前也叫格林威治时间GMT)。如果一个输入值有明确的时区声明, 那么它将用该时区合适的偏移量转换成 UTC。如果在输入串里没有时区声明, 那么它就被假设是在系统的TimeZone参数里的那个时区,然后使用这个 timezone时区的偏移转换成 UTC。
      如果一个timestamp with time zone值被输出,那么它总是从 UTC 转换成当前的timezone时区,并且显示为该时区的本地时间。要看其它时区的时间,要么修改timezone,要么使用AT TIME ZONE构造(参阅第 9.9.3 节)。
      在timestamp without time zonetimestamp with time zone之间的转换通常假设timestamp without time zone值应该以timezone本地时间的形式接受或者写出。为该转换指定一个不同的可以用AT TIME ZONE

8.5.1.4. 特殊值

为了方便,PostgreSQL支持一些特殊日期/时间输入值,如表 8.13所示。这些值中infinity-infinity被在系统内部以特殊方式表示并且将被原封不动地显示。但是其他的仅仅只是概念上的速写,当被读到的时候会被转换为正常的日期/时间值(特殊地,now及相关串在被读到时立刻被转换到一个指定的时间值)。在作为常量在SQL命令中使用时,所有这些值需要被包括在单引号内。

表 8.13. 特殊日期/时间输入

输入串合法类型描述
epochdate, timestamp1970-01-01 00:00:00+00(Unix系统时间0)
infinitydate, timestamp比任何其他时间戳都晚
-infinitydate, timestamp比任何其他时间戳都早
nowdate, time, timestamp当前事务的开始时间
todaydate, timestamp今日午夜 (00:00)
tomorrowdate, timestamp明日午夜 (00:00)
yesterdaydate, timestamp昨日午夜 (00:00)
allballstime00:00:00.00 UTC

下列SQL-兼容的函数可以被用来为相应的数据类型获得当前时间值: CURRENT_DATECURRENT_TIMECURRENT_TIMESTAMPLOCALTIMELOCALTIMESTAMP。(参见第 9.9.4 节)。 注意这些是SQL函数并且在数据输入串中被识别。 虽然输入字符串 nowtodaytomorrowyesterday都可以在交互式 SQL 命令中使用,但当命令被保存以待稍后执行时,它们可能会有令人惊讶的行为,例如在准备的语句、视图和函数定义中。 字符串可以被转换为特定的时间值,该值在变得过时后长时间继续使用。 在这种上下文中使用某一种SQL函数代替。例如, CURRENT_DATE + 1'tomorrow'::date更安全。

8.5.2. 日期/时间输出

时间/日期类型的输出格式可以设成四种风格之一: ISO 8601、 SQL (Ingres)、传统的 POSTGRES (Unix的 date 格式)或 German 。缺省是 ISO 格式( ISO 标准要求使用 ISO 8601 格式。 ISO 输出格式的名字是历史偶然)。表 8.14显示了每种输出风格的例子。 date time 类型的 输出通常只有日期或时间部分和例子中一致。不过, POSTGRES 风格输出的是 ISO 格式的只有日期的值。

表 8.14. 日期/时间输出风格

风格声明 描述 例子
ISO ISO 8601, SQL标准 1997-12-17 07:37:16-08
SQL 传统风格 12/17/1997 07:37:16.00 PST
Postgres 原始风格 Wed Dec 17 07:37:16 1997 PST
German 地区风格 17.12.1997 07:37:16.00 PST

注意

ISO 8601指定使用大写字母 T 来分隔日期和时间。 PostgreSQL 在输入上接受这种格式,但是在输出时它采用一个空格而不是 T ,如上所示。和一些其他数据库系统一样,这是为了可读性以及与RFC 3339的一致性。 SQL 和POSTGRES风格中,如果DMY域顺序被指定,“日”将出现在“月”之前,否则“月”出现在“日”之前(有关该设置如何影响输入值的解释,请参考 第 8.5.1 节 )。表 8.15给出了例子。

表 8.15. 日期顺序习惯

datestyle 设置 输入顺序 例子输出
SQL, DMY / / 17/12/1997 15:37:16.00 CET
SQL, MDY / / 12/17/1997 07:37:16.00 PST
Postgres, DMY / / Wed 17 Dec 07:37:16 1997 PST

日期/时间风格可以由用户使用 SET datestyle 命令选取,在 postgresql.conf 配置文件里的参数 DateStyle 设置或者在服务器或客户端的 PGDATESTYLE 环境变量里设置。 格式化函数 to_char (见第 9.8 节)也可以作为一个更灵活的方式来格式化日期/时间输出。

8.5.3.  时区

时区和时区习惯不仅仅受地球几何形状的影响,还受到政治决定的影响。 到了19世纪,全球的时区变得稍微标准化了些,但是还是易于遭受随意的修改,部分是因为夏时制规 则。 PostgreSQL 使用广泛使用的 IANA (Olson) 时区数据库来得到有关历史时区规则的信息。对于未来的时间,我们假设关于一个给定时区的最新已知 规则将会一直持续到无穷远的未来。 PostgreSQL 努力在典型使用中与 SQL 标准的定义相兼容。但 SQL 标准在日期和时间类型和功能上有一些奇怪的混淆。两个显而易见的问题是: 尽管 date 类型与时区没有联系,而 time 类型却可以有。 然而,现实世界的时区只有在与时间和日期都关联时才有意义, 因为偏移(时差)可能因为实行类似夏时制这样的制度而在一年里有所变化。 缺省的时区会指定一个到 UTC 的数字常量偏移(时差)。因此,当跨 DST 边界做日期/时间算术时, 我们根本不可能适应于夏时制时间。 为了克服这些困难,我们建议在使用时区的时候,使用那些同时包含日期和时间的日期/时间类型。我们 建议使用类型 time with time zone (尽管 PostgreSQL 出于遗留应用以及与 SQL 标准兼容性的考虑支持这个类型)。 PostgreSQL 假设你用于任何类型的本地时区都只包含日期或时间。 在系统内部,所有时区相关的日期和时间都用 UTC 存储。它们在被显示给客户端之前会被转换成由 TimeZone 配置参数指定的本地时间。 PostgreSQL 允许你使用三种不同形式指定时区: 一个完整的时区名字,例如 America/New_York 。能被识别的时区名字被列在 pg_timezone_names 视图中(参见 第 51.92 节 )。 PostgreSQL 用广泛使用的 IANA 时区数据来实现该目的,因此相同的时区名字也可以在其他软件中被识别。 一个时区缩写,例如 PST 。这样一种声明仅仅定义了到UTC的一个特定偏移,而不像完整时区名那样指出整套夏令时转换规则。 能被识别的缩写被列在 pg_timezone_abbrevs 视图中(参见 第 51.91 节 )。 你不能将配置参数 TimeZone log_timezone 设置成一个时区缩写,但是你可以在日期/时间输入值和 AT TIME ZONE 操作符中使用时区缩写。 除了时区名和缩写, PostgreSQL 将接受POSIX-风格的时区规范,如同 第 B.5 节 所描述的。 这个选项通常不优先用于指定时区,但是,如果没有合适的IANA时区条目,这可能是必要的。 简而言之,在缩写和全称之间是有不同的:缩写表示从UTC开始的一个特定偏移量, 而很多全称表示一个本地夏令时规则并且因此具有两种可能的UTC偏移量。例如, 2014-06-04 12:00 America/New_York 表示纽约本地时间的中午, 这个特殊的日期是东部夏令时间(UTC-4)。因此 2014-06-04 12:00 EDT 指定的是同一个时间点。但是 2014-06-04 12:00 EST 指定东部标准时间的 中午(UTC-5),不管在那个日期夏令时是否生效。 更要命的是,某些行政区已经使用相同的时区缩写在不同的时间表示不同的 UTC 偏移量。例如, 在莫斯科 MSK 在某些年份表示 UTC+3 而在另一些年份表示 UTC+4。 PostgreSQL 会根据在指定的日期它们到底表示什么(或者最近表示什么) 来解释这种缩写。但是,正如上面的 EST 例子所示,这并不是必须和那一天的本地 标准时间相同。 在所有情况下,时区名及其缩写都是大小写不敏感的(这是对 PostgreSQL 8.2之前版本的一个修改,在这些版本中某些环境下时区名是大小写敏感的而在另外一些环境中却是大小写不敏感的)。 时区名和缩写都不是硬写在服务器中的,它们是从存储在安装目录下的 .../share/timezone/ .../share/timezonesets/ 子目录中获取的(参见 第 B.4 节 )。 TimeZone 配置参数可以在文件 postgresql.conf 中被设置,或者使用 第 19 章 中描述的任何一种标准方法设置。同时也有一些特殊的方法来设置它: SQL 命令 SET TIME ZONE 为会话设置时区。它是 SET TIMEZONE TO 的另一种拼写,它更加符合SQL的语法。 libpq 客户端使用 PGTZ 环境变量来通过连接发送一个 SET TIME ZONE 命令给服务器。

8.5.4. 间隔输入

interval 值可以使用下列语法书写:

[@] quantity unit [quantity unit...] [direction]
     其中quantity是一个数字(很可能是有符号的);
     unit毫秒millisecondsecondminutehourdayweekmonthyeardecadecenturymillennium
     或者缩写或者这些单位的复数;
     direction可以是ago或者为空。At符号(@)是一个可选的噪声。不同单位的数量通过合适的符号计数被隐式地添加。ago对所有域求反。如果IntervalStyle被设置为postgres_verbose,该语法也被用于间隔输出。
     日、小时、分钟和秒的数量可以不适用显式的单位标记指定。例如,'1 12:59:10'被读作'1 day 12 hours 59 min 10 sec'。同样,一个年和月的组合可以使用一个横线指定,例如'200-10'被读作'200年10个月'(这些较短的形式事实上是SQL标准唯一许可的形式,并且在IntervalStyle被设置为sql_standard时用于输出)。
     间隔值也可以被写成 ISO 8601 时间间隔,使用该标准4.4.3.2小节的带标志符的格式或者4.4.3.3小节的替代格式。带标志符的格式看起来像这样:

P quantity unit [ quantity unit ...] [ T [ quantity unit ...]]
      该串必须以一个P开始,并且可以包括一个引入当日时间单位的T。可用的单位缩写在表 8.16中给出。单位可以被忽略,并且可以以任何顺序指定,但是小于一天的单位必须出现在T之后。特别地,M的含义取决于它出现在T之前还是之后。
     

表 8.16. ISO 8601 间隔单位缩写

缩写含义
Y
M月(在日期部分中)
W
D
H小时
M分钟 (在时间部分中)
S

如果使用替代格式:

P [ years-months-days ] [ T hours:minutes:seconds ]
      串必须以P开始,并且一个T分隔间隔的日期和时间部分。其值按照类似于 ISO 8601日期的数字给出。
     在用一个声明书写一个间隔常量时,或者为一个用声明定义的间隔列赋予一个串时,对于为标记的量的解释依赖于。例如INTERVAL '1' YEAR被解读成1年,而INTERVAL '1'表示1秒。同样,声明允许的最后一个有效域右边的域值会被无声地丢弃掉。例如书写INTERVAL '1 day 2:03:04' HOUR TO MINUTE将会导致丢弃秒域,而不是日域。
     根据SQL标准,一个间隔值的所有域都必须由相同的符号,这样一个领头的负号将会应用到所有域;例如在间隔文字'-1 2:03:04'中的负号会被应用于日、小时、分钟和秒部分。PostgreSQL允许域具有不同的符号,并且在习惯上认为以文本表示的每个域具有独立的符号,因此在这个例子中小时、分钟和秒部分被认为是正值。如果IntervalStyle被设置为sql_standard,则一个领头的符号将被认为是应用于所有域(但是仅当没有额外符号出现)。否则将使用传统的PostgreSQL解释。为了避免混淆,我们推荐在任何域为负值时为每一个域都附加一个显式的符号。
     在冗长的输入格式中,以及在更紧凑输入格式的某些域中,域值可以有分数部分;例如'1.5 week''01:02:03.45'。这样的输入被转换为合适的月数、日数和秒数用于存储。当这样会导致月和日中的分数时,分数被加到低序域中,使用的转换因子是1月=30日和1日=24小时。例如,'1.5 month'会变成1月和15日。只有秒总是在输出时被显示为分数。
     表 8.17展示了一些有效interval输入的例子。
    

表 8.17. 间隔输入

例子描述
1-2SQL标准格式:1年2个月
3 4:05:06SQL标准格式:3日4小时5分钟6秒
1 year 2 months 3 days 4 hours 5 minutes 6 seconds传统Postgres格式:1年2个月3日4小时5分钟6秒钟
P1Y2M3DT4H5M6S带标志符的ISO 8601 格式:含义同上
P0001-02-03T04:05:06ISO 8601 的替代格式:含义同上

在内部,interval值被存储为months、days以及seconds。之所以这样做是因为一个月中的天数是变化的,并且在涉及到夏令时调整时一天可以有23或者25个小时。months以及days域是整数,而seconds域可以存储分数。因为区间通常是从常量字符串或者timestamp减法创建而来,这种存储方法在大部分情况下都很好,但是也可能导致预料之外的结果:

SELECT EXTRACT(hours from '80 minutes'::interval);
 date_part
-----------
SELECT EXTRACT(days from '80 hours'::interval);
 date_part
-----------
     函数justify_daysjustify_hours可以用来调整溢出其正常范围之外的days和hours。
    

8.5.5. 间隔输出

间隔类型的输出格式可以被设置为四种风格之一: sql_standard postgres postgres_verbose iso_8601 ,设置方法使用 SET intervalstyle 命令。默认值为 postgres 格式。表 8.18展示了每种输出风格的例子。 如果间隔值符合SQL标准的限制(仅年-月或仅日-时间,没有正负值部分的混合), sql_standard 风格为间隔文字串产生符合SQL标准规范的输出。否则输出将看起来像一个标准的年-月文字串跟着一个日-时间文字串,并且带有显式添加的符号以区分混合符号的间隔。 当 DateStyle 参数被设置为 ISO 时, postgres 风格的输出匹配 PostgreSQL 8.4版本以前的输出。 当 DateStyle 参数被设置为非 ISO 输出时, postgres_verbose 风格的输出匹配 PostgreSQL 8.4版本以前的输出。 iso_8601 风格的输出匹配在ISO 8601标准的4.4.3.2小节中描述的 带标志符的格式

表 8.18. 间隔输出风格例子

风格声明 年-月间隔 日-时间间隔 混合间隔
sql_standard 1-2 3 4:05:06 -1-2 +3 -4:05:06
postgres 1 year 2 mons 3 days 04:05:06 -1 year -2 mons +3 days -04:05:06
postgres_verbose @ 1 year 2 mons @ 3 days 4 hours 5 mins 6 secs @ 1 year 2 mons -3 days 4 hours 5 mins 6 secs ago
iso_8601 P1Y2M P3DT4H5M6S P-1Y-2M3D​T-4H-5M-6S