NEXT_DAY 函数

next_day(start_date, day_of_week)

功能描述

返回 start_date 之后第一次出现 day_of_week 的日期。

参数说明

• start_date：起始日期，支持 STRING、DATE、TIMESTAMP 类型。
• day_of_week：STRING 类型，表示星期几。支持以下格式（不区分大小写）：
  • 2 字符简写：SU, MO, TU, WE, TH, FR, SA
  • 3 字符简写：SUN, MON, TUE, WED, THU, FRI, SAT
  • 全称：SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY

返回结果

DATE 类型。

使用示例

1. 查找下一个星期二：

   SELECT next_day('2015-01-14', 'TU');
   -- 结果：2015-01-20
   

2. 使用全称：

   SELECT next_day('2015-01-14', 'WEDNESDAY');
   -- 结果：2015-01-21
   

3. 支持 timestamp 输入（只返回日期部分）：

   SELECT next_day('2015-07-23 12:12:12', 'Mon');
   -- 结果：2015-07-27
   

注意事项

• 当任一参数为 NULL 时，返回 NULL。
• 当 day_of_week 不是合法的星期名称时，返回 NULL。
• 当 start_date 不是合法的日期格式时，返回 NULL。
• day_of_week 不区分大小写。