大网数据广告活动
数据库部署与 SQL 参考

转换为 TIMESTAMPTZ 类型

· 52CE 我爱测

将字符串和数字类型转换为 TIMESTAMPTZ 类型的规则与转换为 DATETIME 类型几乎完全一样,区别在于转换成 TIMESTAMPTZ 时,最终会将转换后的 DATETIME 值转换成UTC时间,有可能出现 DATETIME 的值合法,但是转换成UTC时间后的值不合法的情况。例如: `sql set time_zone="+08:00";

将字符串和数字类型转换为 TIMESTAMPTZ 类型的规则与转换为 DATETIME 类型几乎完全一样,区别在于转换成 TIMESTAMPTZ 时,最终会将转换后的 DATETIME 值转换成UTC时间,有可能出现 DATETIME 的值合法,但是转换成UTC时间后的值不合法的情况。例如:

set time_zone="+08:00";

select cast("0000-01-01 00:00:00+08:00" as datetimev2);
+-------------------------------------------------+
| cast("0000-01-01 00:00:00+08:00" as datetimev2) |
+-------------------------------------------------+
| 0000-01-01 00:00:00                             |
+-------------------------------------------------+
1 row in set (0.00 sec)

select cast("0000-01-01 00:00:00+08:00" as timestamptz);
+--------------------------------------------------+
| cast("0000-01-01 00:00:00+08:00" as timestamptz) |
+--------------------------------------------------+
| NULL                                             |
+--------------------------------------------------+
1 row in set (0.04 sec)

字符串0000-01-01 00:00:00+08:00是一个合法的 DATETIME 值,但是转换成UTC时间后会超出合法范围,最终结果是NULL。

详细转换规则参见转换为 DATETIME 类型文档。

From Datelike Types

支持 Datetime 类型转换为 Timestamptz 类型,转换时,根据前会话的时区将 DATETIME 转换成UTC时间,有可能出现 DATETIME 的值合法,但是转换成UTC时间后的值不合法的情况。

由于 Timestamptz 具有不同的精度取值,还存在不同精度的 Timestamptz 之间的转换。

Timestamptz

严格模式

规则描述

低精度向高精度转换时,新出现的小数位补 0,该转换必定合法。

高精度向低精度转换时,将会向前进位,进位可以继续向前传递,如果产生溢出,转换后的值不合法。

错误处理

如果溢出,报错。

例子
输入 TIMESTAMPTZ 源类型 目标类型 结果 TIMESTAMPTZ Comment
2020-12-12 00:00:00.123+08:00 Timestamptz(3) Timestamptz(6) 2020-12-12 00:00:00.123000+08:00 扩充精度
2020-12-12 00:00:00.123456+08:00 Timestamptz(6) Timestamptz(3) 2020-12-12 00:00:00.123+08:00 降低精度,无进位
2020-12-12 00:00:00.996666+08:00 Timestamptz(6) Timestamptz(2) 2020-12-12 00:00:01.00+08:00 降低精度,进位到秒
9999-12-31 23:59:59.999999+08:00 Timestamptz(6) Timestamptz(5) 报错 进位溢出,产生 10000 年的非法日期

非严格模式

除错误处理外,非严格模式的行为同严格模式完全一致。

规则描述

低精度向高精度转换时,新出现的小数位补 0,该转换必定合法。

高精度向低精度转换时,将会向前进位,进位可以继续向前传递,如果产生溢出,转换后的值不合法。

错误处理

如果溢出,返回值为 NULL。

例子
输入 TIMESTAMPTZ 源类型 目标类型 结果 TIMESTAMPTZ Comment
2020-12-12 00:00:00.123+08:00 Timestamptz(3) Timestamptz(6) 2020-12-12 00:00:00.123000+08:00 扩充精度
2020-12-12 00:00:00.123456+08:00 Timestamptz(6) Timestamptz(3) 2020-12-12 00:00:00.123+08:00 降低精度,无进位
2020-12-12 00:00:00.99666+08:00 Timestamptz(6) Timestamptz(2) 2020-12-12 00:00:01.00+08:00 降低精度,进位到秒
9999-12-31 23:59:59.999999+08:00 Timestamptz(6) Timestamptz(5) NULL 进位溢出,产生 10000 年的非法日期

Datetime

严格模式

规则描述

低精度向高精度转换时,新出现的小数位补 0,该转换必定合法。

高精度向低精度转换时,将会向前进位,进位可以继续向前传递,如果产生溢出,转换后的值不合法。

错误处理

如果溢出,报错。

例子
输入 DATETIME 源类型 目标类型 结果 TIMESTAMPTZ Comment
2020-12-12 00:00:00.123 Datetime(3) Timestamptz(6) 2020-12-12 00:00:00.123000+08:00 扩充精度
2020-12-12 00:00:00.123456 Datetime(6) Timestamptz(3) 2020-12-12 00:00:00.123+08:00 降低精度,无进位
2020-12-12 00:00:00.99666 Datetime(6) Timestamptz(2) 2020-12-12 00:00:01.00+08:00 降低精度,进位到秒
9999-12-31 23:59:59.999999 Datetime(6) Timestamptz(5) 报错 进位溢出,产生 10000 年的非法日期

非严格模式

除错误处理外,非严格模式的行为同严格模式完全一致。

规则描述

低精度向高精度转换时,新出现的小数位补 0,该转换必定合法。

高精度向低精度转换时,将会向前进位,进位可以继续向前传递,如果产生溢出,转换后的值不合法。

错误处理

如果溢出,返回值为 NULL。

例子
输入 DATETIME 源类型 目标类型 结果 TIMESTAMPTZ Comment
2020-12-12 00:00:00.123 Datetime(3) Timestamptz(6) 2020-12-12 00:00:00.123000+08:00 扩充精度
2020-12-12 00:00:00.123456 Datetime(6) Timestamptz(3) 2020-12-12 00:00:00.123+08:00 降低精度,无进位
2020-12-12 00:00:00.99666 Datetime(6) Timestamptz(2) 2020-12-12 00:00:01.00+08:00 降低精度,进位到秒
9999-12-31 23:59:59.999999 Datetime(6) Timestamptz(5) NULL 进位溢出,产生 10000 年的非法日期

TIMESTAMP_NS

将 TIMESTAMP_NS 转换为 TIMESTAMPTZ(p) 时,Doris 会把不带时区的 TIMESTAMP_NS 值解释为当前会话时区中的日期时间,转换为对应的绝对时间,并将纳秒小数四舍五入到目标精度 p(0 到 6)。

所有合法的 TIMESTAMP_NS 值都在 TIMESTAMPTZ 的日期范围内,因此严格和非严格模式下转换都会成功。输入为 NULL 时返回 NULL。

假设 time_zone = '+08:00':

输入 TIMESTAMP_NS 目标类型 结果 TIMESTAMPTZ 说明
2024-02-29 12:34:56.123456499 Timestamptz(6) 2024-02-29 12:34:56.123456+08:00 向下舍入到微秒
2024-02-29 12:34:56.123456500 Timestamptz(6) 2024-02-29 12:34:56.123457+08:00 向上舍入到微秒
1969-12-31 23:59:59.999999500 Timestamptz(6) 1970-01-01 00:00:00.000000+08:00 进位到下一秒

反向转换请参见转换为 TIMESTAMP_NS。

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。