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

Apache Doris 中文参考:MAKEDATE

· 52CE 我爱测

MAKEDATE 函数用于根据指定的年份和一年中的天数(dayofyear)构建并返回对应的日期。该函数通过计算 “年份的第一天 + 天数偏移” 生成结果,支持对超出当年天数的输入进行自动顺延处理。

描述

MAKEDATE 函数用于根据指定的年份和一年中的天数(dayofyear)构建并返回对应的日期。该函数通过计算 “年份的第一天 + 天数偏移” 生成结果,支持对超出当年天数的输入进行自动顺延处理。

该函数与 mysql 中的 makedate 函数 行为一致。

语法

MAKEDATE(`<year>`, `<day_of_year>`)

参数

参数 说明
year 指定的年份,类型为 INT,支持的有效范围为 0 至 9999
dayofyear 一年中的第几天(1-366),类型为 INT

返回值

返回 DATE 类型的值,表示根据输入的年份和天数计算得到的日期(格式为 YYYY-MM-DD)。

  • 若 <day_of_year> 小于等于 0,返回错误。
  • 若 <day_of_year> 超过指定年份的总天数(平年 365 天,闰年 366 天),则自动顺延到下一年及以后的年份(例如:2021 年(平年)的第 366 天会顺延为 2022-01-01)。
  • 计算结果超出有效日期范围(0000-01-01 至 9999-12-31),返回错误
  • 若任一参数为 NULL,返回 NULL。

举例

--- 计算当年的第 N 天(说明:2021 是平年,共 365 天,第 365 天为 12 月 31 日)
SELECT MAKEDATE(2021, 1), MAKEDATE(2021, 100), MAKEDATE(2021, 365);
+-------------------+---------------------+----------------------+
| makedate(2021, 1) | makedate(2021, 100) | makedate(2021, 365)  |
+-------------------+---------------------+----------------------+
| 2021-01-01        | 2021-04-10          | 2021-12-31           |
+-------------------+---------------------+----------------------+

--- 闰年处理:2020 年是闰年(366 天)
SELECT MAKEDATE(2020, 366);
+----------------------+
| makedate(2020, 366)  |
+----------------------+
| 2020-12-31           |
+----------------------+

--- 天数超出当年总天数,自动顺延到下一年
SELECT MAKEDATE(2021, 366), MAKEDATE(2021, 400);
+----------------------+----------------------+
| makedate(2021, 366)  | makedate(2021, 400)  |
+----------------------+----------------------+
| 2022-01-01           | 2022-02-04           |
+----------------------+----------------------+

--- 天数为非正数,返回错误
SELECT MAKEDATE(2020, 0);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]The function makedate Argument value 2020, 0 must larger than zero ,and year between 1 and 9999

--- 参数为 NULL,返回 NULL
SELECT MAKEDATE(NULL, 100), MAKEDATE(2023, NULL);
+---------------------+----------------------+
| makedate(NULL, 100) | makedate(2023, NULL) |
+---------------------+----------------------+
| NULL                | NULL                 |
+---------------------+----------------------+

--- 年份超出范围
SELECT MAKEDATE(9999, 366);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation makedate of 9999, 366 out of range

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

资料来源与适用范围

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

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

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