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

Apache Doris 中文参考:FROM_ISO8601_DATE

· 52CE 我爱测

将 ISO8601 格式的日期表达式转化为 date 类型的日期表达式。 符合 ISO 8601 标准的日期字符串,支持的格式包括:

描述

将 ISO8601 格式的日期表达式转化为 date 类型的日期表达式。 符合 ISO 8601 标准的日期字符串,支持的格式包括:

  • YYYY:仅年份(返回该年 1 月 1 日)
  • YYYY-MM:年月(返回该月 1 日)
  • YYYY-DDD:年 + 年中的天数(DDD 范围 1-366,如 0000-059 表示 0000 年第 59 天)
  • YYYY-WWW:年 + 周数(WWW 范围 1-53,返回该周的周一)
  • YYYY-WWW-D:年 + 周数 + 周内天数(D 范围 1-7,1 表示周一,7 表示周日)
  • 在该格式中,一年的第一周必须包含该周的星期四,不然算作上一年的周

语法

from_iso8601_date(<dt>)

参数

参数 说明
<date> ISO8601 格式的日期,为字符串类型

返回值

返回 DATE 类型,格式为 YYYY-MM-DD,表示解析后的具体日期。

  • 若输入格式错误,返回 NULL
  • 结果不为合法日期时间值,返回 NULL
  • 输入 NULL,返回 NULL

举例

-- 解析不同ISO 8601格式的日期字符串
select 
    from_iso8601_date('2023') as year_only, 
    from_iso8601_date('2023-10') as year_month, 
    from_iso8601_date('2023-10-05') as full_date; 
+------------+------------+------------+
| year_only  | year_month | full_date  |
+------------+------------+------------+
| 2023-01-01 | 2023-10-01 | 2023-10-05 |
+------------+------------+------------+

-- 解析“年-天数”格式
select 
    from_iso8601_date('2021-001') as day_1,  
    from_iso8601_date('2021-059') as day_59, 
    from_iso8601_date('2021-060') as day_60,  
    from_iso8601_date('2024-366') as day_366; 
+------------+------------+------------+------------+
| day_1      | day_59     | day_60     | day_366    |
+------------+------------+------------+------------+
| 0000-01-01 | 0000-02-28 | 0000-03-01 | 2024-12-31 |
+------------+------------+------------+------------+

-- 解析“YYYY-Www-D”格式(每周以周一为第一天),因为0522-01-01 才是周四,所以第一周之前的都会返回 0521 的年份
select from_iso8601_date('0522-W01-1') as week_1;
+------------+
| week_1     |
+------------+
| 0521-12-29 |
+------------+

select from_iso8601_date('0522-W01-4') as week_4;
+------------+
| week_4     |
+------------+
| 0522-01-01 |
+------------+

---YYYY-Www格式,第一周的周一在521年
select from_iso8601_date('0522-W01') as week_1;
+------------+
| week_1     |
+------------+
| 0521-12-29 |
+------------+

---格式错误,返回 NULL
select from_iso8601_date('2023-10-01T12:34:10');
+------------------------------------------+
| from_iso8601_date('2023-10-01T12:34:10') |
+------------------------------------------+
| NULL                                     |
+------------------------------------------+

---值错误,返回 NULL
select from_iso8601_date('2024-400');
+-------------------------------+
| from_iso8601_date('2024-400') |
+-------------------------------+
| NULL                          |
+-------------------------------+

---输入 NULL
select from_iso8601_date(NULL);
+-------------------------+
| from_iso8601_date(NULL) |
+-------------------------+
| NULL                    |
+-------------------------+

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

资料来源与适用范围

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

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

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