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

日期类型字面量

· 52CE 我爱测

和标准 SQL 一致,Doris 要求使用类型关键字和字符串来指定时间字面量。关键字和字符串之间的空格是可选的。例如:

描述

和标准 SQL 一致,Doris 要求使用类型关键字和字符串来指定时间字面量。关键字和字符串之间的空格是可选的。例如:

DATE '2008-08-08'
TIMESTAMP'2008-08-08 20:08:08'

日期格式

DATE 字面

  • 使用 - 分隔的字符串,采用 'YYYY-MM-DD' 或 'YY-MM-DD'格式。Doris 也兼容 MySQL 的非标准分隔符格式,但是不推荐使用。
  • 作为没有分隔符的字符串,采用 'YYYYMMDD' 或 'YYMMDD' 格式(前提是该字符串在日期上有意义)。

DATETIME、TIMESTAMP_NS、TIMESTAMPTZ 字面量

  • 使用 - 分隔的字符串,采用 'YYYY-MM-DD hh:mm:ss' 或 'YY-MM-DD hh:mm:ss'格式。Doris 也兼容 MySQL 的非标准分隔符格式,但是不推荐使用。日期和时间之间的分隔符可以是空格( )也可以是T。不同于 MySQL 8.4 及更早的版本,Doris 不支持其他任何其他的时间和日期之间的分隔符。
  • 作为没有分隔符的字符串,采用 'YYYYMMDDhhmmss' 或 'YYMMDDhhmmss' 格式(前提是该字符串在日期上有意义)。

日期时间字面量可以包含小数秒部分。DATETIME 和 TIMESTAMPTZ 最多保留 6 位(微秒),TIMESTAMP_NS 保留 9 位(纳秒);多余的小数位会按照目标类型的精度四舍五入。小数部分必须使用点号(.)与时间的其余部分分隔;不识别其他的小数秒分隔符。

两位数年份

包含两位数年份值的日期是有歧义的,因为世纪是未知的。Doris 使用以下规则来解释两位数的年份值:

  • 范围在 70-99 之间的年份值会被解释为 1970-1999 年。
  • 范围在 00-69 之间的年份值会被解释为 2000-2069 年。

时区

DATE、DATETIME、TIMESTAMP_NS 和 TIMESTAMPTZ 字面量可以使用时区后缀。使用时区时,时区需要紧邻之前的日期或时间部分,之间不得有空格。例如:

TIMESTAMP '2008-08-08 20:08:08+08:00'

Doris 支持的时区格式有:

  • 时区时间偏移量:格式为 {+ | -}hh:mm。如东八区为:+08:00
  • 时区名。如上海时区为:Asia/Shanghai

错误值的处理

当遇到不能解析为合法日期字面量的值时,Doris 会直接报错。例如

SELECT date '071332'

会产生如下错误:

date/datetime literal [071332] is invalid

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

资料来源与适用范围

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

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

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