日期/时间类型

MAXIR 支持主要的日期和时间数据类型，如下表所示。

!>重要
MAXIR 不支持在 DDL 中定义数据类型为 interval 的列，因为 MAXIR 不支持存储 interval 类型的数据。

有关日期/时间数据类型可执行操作的信息：

• 如计算引擎为 Hybrid DPS，请参考 PostgreSQL 文档中的 Date/Time Functions and Operators 。

• 如计算引擎为 Extreme DPS，请参考 日期/时间函数和运算符。

日期/时间类型的输出样式因使用的客户端而异，本文不做展开。

说明

• timestamptz 可以作为 timestamp with time zone 的缩写使用。
• 日期按照公历来计算，即使是引入公历之前的年份。更多详细信息，请参考 PostgreSQL 文档中的 History of Units 。

日期

MAXIR 支持 ISO 8601 中的日期/时间输入。

使用一对单引号（' '）括起任何日期或时间文字输入，例如，'2022-07-01' 或 '2022-7-1'。

时间戳

时间戳类型接受日期和时间的连接格式的有效输入。

MAXIR 支持两种时间戳类型：timestamp with time zone 和 timestamp，建议你在指定值之前确定是否需要时区。如果你选择 timestamp with time zone，使用 +/- 符号指定时区偏移量。如果指定时间戳类型为 timestamp，MAXIR 会忽略时间戳数据中包含的时区信息。

对于 timestamp with time zone，MAXIR 内部以 UTC 进行存储。具有明确时区的输入值将使用正确的偏移量转换为 UTC。如果输入字符串缺少时区指示，TimeZone 系统参数的值将用作时区。转换为 UTC 使用该时区的 UTC 偏移量。

当 timestamp with time zone 值输出时，显示的值是从 UTC 转换后的时区的本地时间。

如果你在 timestamp with time zone 类型和 timestamp 类型之间转换值，timestamp 值通常被视为时区的本地时间。

!>重要
MAXIR 不允许使用大写字母 T 来连接值中的日期部分和时间部分，请使用空格代替。

MAXIR 支持两种时间戳的输入样式。

时区

时区以及时区规范，受到政治决策的影响，而不仅仅是物理地理位置。虽然从 1900 年代开始，世界各地的时区逐渐开始变得标准化，但是随意更改仍时有发生，特别是关于夏令时的规则。出于标准化考虑，MAXIR 使用通用的 IANA（Olson）时区数据库获取有关历史时区规则的信息。对于未来的时间，MAXIR 则假设已知的时区将无限期地持续观察。

MAXIR 努力与 SQL 标准的典型用法兼容。然而，SQL 标准对日期和时间类型及其功能有一些奇怪的混合。两个明显的问题是：

1. 在现实世界中，时区除非与日期以及时间一起关联，否则几乎没有意义，因为偏移量可以因夏令时边界问题而在一年中变化。

2. 默认时区是指定为 UTC 的常数数值偏移量。因此，在跨 DST 边界进行日期/时间运算时，无法适应夏令时。

为了解决上述问题，MAXIR 建议在使用同时包含日期和时间的日期/时间类型的时候指定时区。

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

支持的时区格式

MAXIR 支持三种时区格式：

• 时区全称

  基于 IANA 时区数据库，用于表示某个地理区域相对于协调世界时（UTC）的时间差异，例如 America/New_York、Europe/Paris 等。这些地理区域标识代表特定区域的时区，每个时区全称都对应一个相对于协调世界时（UTC）的时间差异，它以小时为单位，可以是正数、负数或零。正数表示 UTC 以东的时间，负数表示 UTC 以西的时间，零表示该时区与 UTC 时间一致。例如 America/New_York 时区的偏移量为 -5 小时，表示该时区在 UTC 以西，时间相比 UTC 晚 5 小时。

• 基于 ISO-8601 标准的时区偏移表示

  时区格式为一个正号或负号后跟小时和分钟的偏移量来表示：±HH[:MM]。每个时区偏移都表示一个相对于 UTC 的时间差异，可以是正数、负数或零。正数表示时区在 UTC 以东，负数表示时区在 UTC 以西，零表示该时区与 UTC 时间一致。例如，+02:00 表示 UTC 以东的时区，时间比 UTC 早 2 小时；-05:30 表示比 UTC 以西的时区，时间比 UTC 晚 5 小时 30 分钟。

• 基于 POSIX 标准的时区偏移表示

  时区格式为一个正号或负号后跟小时和分钟的偏移量来表示：±HH[:MM]。每个时区偏移都表示一个相对于 UTC 的时间差异，可以是正数、负数或零。其中正数表示时区在 UTC 以西，负数表示时区在 UTC 以东（偏移方向与 ISO-8601 标准的时区相反）。例如，+02:00 表示 UTC 以西的时区，时间比 UTC 晚 2 小时；-05:30 表示比 UTC 以东的时区，时间比 UTC 早 5 小时 30 分钟。

时区偏移说明

在时区偏移在不同的使用场景下所遵循的标准不同。如下为在各种场景下的时区偏移说明：

场景 1：时间 Literal

时区偏移遵循的标准：ISO-8601

说明：当时间 Literal 中出现时区偏移时，将遵循 ISO-8601 标准处理该时区偏移。

示例：

SELECT timestamptz '2024-01-15 12:00:00+06';
 
 
      timestamptz
------------------------
 2024-01-15 06:00:00+00
(1 row)
 
SELECT timestamptz '2024-01-15 12:00:00+06:00';
 
 
      timestamptz
------------------------
 2024-01-15 06:00:00+00
(1 row)

说明
此示例中，会话时区设置为 UTC。

场景 2：输出的时间结果

时区偏移遵循的标准：ISO-8601

说明：当时区偏移出现在时间输出中时，其所代表的含义遵循 ISO-8601 标准。

示例：

SELECT timestamptz '2024-01-15 12:00:00+00';
 
      timestamptz
------------------------
 2024-01-15 20:00:00+08
(1 row)

说明
此示例中，会话时区设置为 Asia/Shanghai。

场景 3：字符串转换为时间类型

时区偏移遵循的标准：ISO-8601

说明：当表示时间的字符串中出现时区偏移时，将遵循 ISO-8601 标准处理该时区偏移

样例：

SELECT CAST('2024-01-15 12:00:00+06' AS timestamptz);
 
      timestamptz
------------------------
 2024-01-15 06:00:00+00
(1 row)
 
SELECT CAST('2024-01-15 12:00:00+06:00' AS timestamptz);
 
      timestamptz
------------------------
 2024-01-15 06:00:00+00
(1 row)

说明
此示例中，会话时区设置为 UTC。

场景 4：时间格式化函数

在该场景下，存在两种情况：

1. 字符串格式转换为时间

   时区偏移遵循的标准：ISO-8601

   说明：当时区偏移出现在时间格式化函数的源字符串中时，将遵循 ISO-8601 标准处理该时区偏移

   示例：

   SELECT to_timestamp('2024-01-15 12:00:00-08', 'YYYY-MM-DD HH24:MI:SSTZH');
    
       to_timestamp
   ------------------------
   2024-01-15 20:00:00+00
   (1 row)
    
   SELECT to_timestamp('2024-01-15 12:00:00-08:30', 'YYYY-MM-DD HH24:MI:SSTZH:TZM');
    
         to_timestamp
   ------------------------
    2024-01-15 20:30:00+00
   (1 row)

   说明
   此示例中，会话时区设置为 UTC。

2. 时间格式转换为字符串

   时区偏移遵循的标准：请参考“场景 5：会话中的时区”中所遵循的标准。

   说明：在时间格式化为字符串的处理逻辑中，'TZH' 格式符输出时使用的是会话的时区偏移，具体遵循的标准参见“场景 5：会话中的时区”中的描述。

   示例：

   SELECT to_char(timestamptz '2024-01-15 12:00:00+10', 'YYYY-MM-DD HH24:MI:SS TZH:TZM');
    
         to_char
   ----------------------------
   2024-01-15 10:00:00+08:00
   (1 row)

   说明
   此示例中，会话时区设置为'+8'。

场景 5：会话中的时区

该场景分为两种情况：

1. 会话时区设置为 ±HH

   时区偏移遵循的标准：ISO-8601

   说明：当会话的时区设置为 '±HH' 格式时，遵循 ISO-8601 标准处理该时区偏移

   示例：

   SET time zone '+07';
    
   SELECT timestamp with time zone '2024-02-25 10:00:00+00';
    
         timestamptz
   ------------------------
    2024-02-25 17:00:00+07
   (1 row)
    
    
   SET time zone '-07';
    
   SELECT timestamp with time zone '2024-02-25 10:00:00+00';
    
         timestamptz
   ------------------------
    2024-02-25 03:00:00-07
   (1 row)

   说明
   此示例中，会话时区设置为 '+07'。

2. 会话时区设置为 ±HH:MM

   时区偏移遵循的标准：POSIX

   说明：当会话的时区设置为 '±HH:MM' 格式时，遵循 POSIX 标准处理该时区偏移

   示例：

   SET time zone '+07:00';
    
   SELECT timestamp with time zone '2024-02-25 10:00:00+00';
    
         timestamptz
   ------------------------
    2024-02-25 03:00:00-07
   (1 row)
    
    
   SET time zone '-07:00';
    
   SELECT timestamp with time zone '2024-02-25 10:00:00+00';
    
         timestamptz
   ------------------------
    2024-02-25 17:00:00+07
   (1 row)    

   说明
   此示例中，会话时区设置为 '+07:00' 。

场景 6：AT TIME ZONE 命令中的时区

时区偏移遵循的标准：POSIX

说明：当 AT TIME ZONE 命令中的时区设置为 offset 格式（±HH/±HH:MM）时，遵循 POSIX 标准处理该时区偏移

示例：

SET time zone 'UTC';
 
SELECT timestamptz '2024-01-10 12:00:00+00' at time zone '+08' ;
 
 
      timezone
---------------------
 2024-01-10 04:00:00
(1 row)
 
SELECT timestamptz '2024-01-10 12:00:00+00' at time zone '+08:00' ;
 
      timezone
---------------------
 2024-01-10 04:00:00
(1 row)
 
SELECT timestamp '2024-01-10 12:00:00' at time zone '+08';
 
        timezone
------------------------
 2024-01-10 20:00:00+00
(1 row)
 
SELECT timestamp '2024-01-10 12:00:00' at time zone '+08:00';
 
 
        timezone
------------------------
 2024-01-10 20:00:00+00
(1 row)

说明
此示例中，会话时区设置为 UTC。

间隔

interval 类型有一个额外的选项，那就是通过编写以下短语之一来限制存储的字段集：

YEAR
MONTH
DAY
HOUR
MINUTE
SECOND
MILLISECOND
MICROSECOND

以下是一个 interval 值的示例：

1 year 2 months 3 days 4 hours 5 minutes 6 seconds