timestamp with time zone

日期和时间输入几乎可以使用任何合理格式，包括 ISO 8601、SQL 兼容格式、传统 POSTGRES 格式及其他格式。某些格式中的日、月、年排列顺序存在歧义，因此支持指定这些字段的预期顺序。将 DateStyle 参数设为 MDY 可按月-日-年解释，设为 DMY 可按日-月-年解释，设为 YMD 可按年-月-日解释。

PostgreSQL 在处理日期/时间输入方面，比 SQL 标准要求的更灵活。有关日期/时间输入的精确解析规则，以及可识别的文本字段（包括月份、星期几和时区），请参见附录 B。

请记住，任何日期或时间字面值输入都必须像文本字符串一样用单引号括起来。更多信息请参见第 4.1.2.7 节。SQL 要求使用下列语法：

type [ (p) ] 'value'

其中，p 是可选的精度说明，给出秒字段的小数位数。time、timestamp 和 interval 类型可以指定精度，范围为 0 至 6。如果常量写法中未指定精度，则默认采用字面值的精度（但不超过 6 位）。

1999-01-08 04:05:06

1999-01-08 04:05:06 -8:00

January 8 04:05:06 1999 PST

TIMESTAMP '2004-10-19 10:23:54'

TIMESTAMP '2004-10-19 10:23:54+02'

TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02'

日期/时间类型的输出格式可以设为四种样式之一：ISO 8601、SQL（Ingres）、传统的 POSTGRES（Unix date 格式）或 German。默认是 ISO 格式。（SQL 标准要求使用 ISO 8601 格式。该输出格式之所以名为“SQL”，纯属历史偶然。）表 8.14展示了各种输出样式的示例。date 和 time 类型的输出通常只包含示例中的日期部分或时间部分。不过，POSTGRES 样式对纯日期值仍会采用 ISO 格式输出。

SQL和POSTGRES风格中，如果指定了 DMY 字段顺序，“日”将出现在“月”之前，否则“月”出现在“日”之前（有关该设置如何影响输入值的解释，请参考第 8.5.1 节）。表 8.15给出了示例。

在 ISO 样式中，时区总是显示为相对于 UTC 的有符号数字偏移，格林尼治以东的时区使用正号。如果偏移是整小时，就显示为 hh；如果是整分钟，则显示为 hh:mm；否则显示为 hh:mm:ss。（第三种情况在任何现代时区标准下都不可能出现，但在处理标准化时区被采用之前的时间戳时可能会看到。）在其他日期样式中，如果当前时区有通用的字母缩写，就会显示该缩写；否则会以 ISO 8601 基本格式的有符号数字偏移显示（hh 或 hhmm）。这些样式中显示的字母缩写，取自当前由TimeZone运行时参数选中的 IANA 时区数据库条目；它们不受timezone_abbreviations设置影响。

用户可以通过 SET datestyle 命令、postgresql.conf 配置文件中的DateStyle参数，或者服务器端或客户端上的 PGDATESTYLE 环境变量来选择日期/时间样式。

格式化函数to_char（见第 9.8 节）也可以作为一个更灵活的方式来格式化日期/时间输出。

时区及其惯例不仅由地理位置决定，也受政治决策影响。世界各地的时区在 20 世纪逐渐得到一定程度的标准化，但仍可能随意变更，尤其是夏令时规则。PostgreSQL 使用广泛应用的 IANA（Olson）时区数据库记录历史时区规则。对于未来时间，假定某个时区最新已知的规则将一直沿用下去。

PostgreSQL 努力在典型用法上与 SQL 标准定义保持兼容。不过，SQL 标准在日期和时间类型及其能力方面存在一些奇怪的混搭。两个显而易见的问题是：

为了克服这些困难，我们建议在使用时区时采用同时包含日期和时间的日期/时间类型。我们不建议使用 time with time zone 类型（尽管 PostgreSQL 出于兼容旧应用以及遵循 SQL 标准的考虑而支持它）。PostgreSQL 对于任何只包含日期或时间的类型，都会假定其使用本地时区。

所有带时区的日期和时间都在内部以 UTC 存储。显示给客户端之前，它们会转换为 TimeZone 配置参数指定时区的本地时间。

PostgreSQL 允许使用三种不同形式来指定时区：

简而言之，这就是缩写和全名的区别：缩写表示某个特定的 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 章中说明的其他标准方式设置。另外，还有一些特殊的设置方法：

interval值可以使用下列详细语法书写：

[@] quantity unit [quantity unit...] [direction]

其中quantity是一个数字（可以带有符号）；unit是microsecond、millisecond、second、minute、hour、day、week、month、year、decade、century、millennium 或它们的缩写或复数形式；direction 可以是 ago 或为空。at 符号（@）只是可选的噪声。不同单位的数量会按适当的符号规则隐式相加。ago 会将所有字段取反。如果IntervalStyle被设置为 postgres_verbose，该语法也会用于间隔输出。

日、小时、分钟和秒的数量也可以不写显式单位标记。例如，'1 12:59:10' 会被读作 '1 day 12 hours 59 min 10 sec'。同样，年和月的组合也可以用一个连字符表示，例如 '200-10' 会被读作 '200 years 10 months'。（事实上，这些较短形式正是 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 之前还是之后。

如果使用替代格式：

P [ years-months-days ] [ T hours:minutes:seconds ]

字符串必须以 P 开头，T 分隔时间间隔的日期部分和时间部分。各值采用类似 ISO 8601 日期的数字形式。

当编写带有 fields 说明的间隔常量，或者把字符串赋给一个定义时带有 fields 说明的间隔列时，未标记数量的解释方式取决于 fields。例如，INTERVAL '1' YEAR 会被读作 1 年，而 INTERVAL '1' 表示 1 秒。此外，位于 fields 说明所允许的最小字段“右侧”的字段值会被静默丢弃。例如，写 INTERVAL '1 day 2:03:04' HOUR TO MINUTE 会导致秒字段被丢弃，而不是日字段。

根据 SQL 标准，一个间隔值的所有字段都必须带有相同符号，因此一个前导负号会作用于所有字段；例如间隔字面值 '-1 2:03:04' 中的负号会同时作用于日、小时、分钟和秒。PostgreSQL 允许各字段具有不同符号，并且传统上认为文本表示中的每个字段都带有各自独立的符号，因而在这个例子里，小时、分钟和秒部分会被视为正值。如果 IntervalStyle 被设置为 sql_standard，则会把前导符号视为作用于所有字段（但前提是没有出现额外符号）；否则将采用传统的 PostgreSQL 解释。为了避免混淆，我们建议只要有任何字段为负值，就为每个字段都显式写出符号。

在内部，interval 值以三个整数字段存储：月、日和微秒。之所以将它们分开保存，是因为一个月中的天数会变化，而如果涉及夏令时切换，一天也可能只有 23 或 25 小时。使用其他单位的间隔输入字符串会先规范化为这种格式，然后再以标准化方式重建输出，例如：

SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
               interval
---------------------------------------
 3 years 3 mons 700 days 133:17:36.789

这里，周按“7 天”计算并单独保留，而较小和较大的时间单位则被合并并规范化了。

输入字段值可以带有小数部分，例如 '1.5 weeks' 或 '01:02:03.45'。然而，由于 interval 在内部只存储整数字段，小数值必须转换成更小的单位。大于月的单位的小数部分会被舍入为整数个月，例如 '1.5 years' 会变成 '1 year 6 mons'。周和天的小数部分会在假定每月 30 天、每天 24 小时的前提下，计算成整数天和微秒，例如 '1.75 months' 会变成 1 mon 22 days 12:00:00。只有秒在输出时才可能显示为小数。

表 8.17展示了一些有效interval输入的示例。

如前所述，PostgreSQL 将 interval 值存储为月、日和微秒。输出时，月份字段通过除以 12 转换为年和月；天数字段原样显示；微秒字段转换为时、分、秒和小数秒。因此，月、分、秒的显示值分别不会超出 0–11、0–59 和 0–59 的范围，而年、日、时的显示值则可以很大。（若希望将较大的天数或小时数折算到更高一级字段，可使用 justify_days 和 justify_hours 函数。）

可使用 SET intervalstyle 将 interval 的输出格式设为 sql_standard、postgres、postgres_verbose 或 iso_8601 四种风格之一，默认为 postgres。表 8.18 给出了各输出风格的示例。

如果间隔值满足 SQL 标准的限制条件（仅有年-月或仅有日-时间，且不混合正负分量），sql_standard 风格会生成符合 SQL 标准的间隔字面值输出。否则，输出将表现为一个标准的年-月字面值串后跟一个日-时间字面值串，并显式加上符号，以消除正负混合间隔的歧义。

postgres 样式的输出与 PostgreSQL 8.4 之前版本在DateStyle参数设为 ISO 时的输出一致。

postgres_verbose 样式的输出与 PostgreSQL 8.4 之前版本在 DateStyle 参数设为非 ISO 输出时的结果一致。

iso_8601 风格的输出符合 ISO 8601 标准 4.4.3.2 节描述的“带标志符的格式”。