更新时间：2026-07-03 GMT+08:00
next_day
next_day函数用于返回起始日期之后最接近指定星期的日期。
命令格式
next_day(string start_date, string day_of_week)
参数说明
| 参数 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| start_date | 是 | DATE 或 STRING | 代表起始日期。 start_date取值为STRING类型格式时，至少要包含yyyy-mm-dd且不含多余的字符串。 格式为：
|
| day_of_week | 是 | STRING | 星期名称的前2个或3个字母缩写，或者星期的全名。例如TU代表星期二。 |
返回值说明
返回DATE类型的日期值，格式为yyyy-mm-dd。
- start_date非DATE或STRING类型时，返回报错，错误信息：data type mismatch。
- start_date为DATE或STRING类型，但不符合日期值的入参格式时，返回NULL。
- start_date值为NULL时，返回NULL。
- day_of_week值为NULL时，返回NULL。
示例代码
- 示例1
select next_day('2023-08-16','TU');返回2023-08-22。
- 示例2
select next_day('2023-08-16 10:54:00','TU');返回2023-08-22。
- 示例3
select next_day('2023-08-16 10:54:00','WE');返回2023-08-23。
- 示例4
select next_day('20230816 20:00:00',null);返回NULL。
父主题： 日期函数
