更新时间：2023-11-03 GMT+08:00
next_day
next_day函数用于返回start_date之后最接近day_of_week的日期。
命令格式
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。
示例代码
返回2023-08-22。
select next_day('2023-08-16','TU');
返回2023-08-22。
select next_day('2023-08-16 10:54:00','TU');
返回2023-08-23。
select next_day('2023-08-16 10:54:00','WE');
返回NULL。
select next_day('20230816','TU');
返回NULL。
select next_day('20230816 20:00:00',null);
父主题： 日期函数
