NEXT_DAY

描述

NEXT_DAY 函数用于返回给定日期之后第一个匹配指定星期几的日期。

提示

该函数自 3.0.6 版本开始支持.

语法

NEXT_DAY(<datetime/date>, <day_of_week>)

参数

参数	描述
<datetime/date>	用于查找下一个星期几的日期。
<day_of_week>	用于标识星期几的字符串表达式。

<day_of_week> 必须是以下值之一（不区分大小写）：

• 'SU', 'SUN', 'SUNDAY'
• 'MO', 'MON', 'MONDAY'
• 'TU', 'TUE', 'TUESDAY'
• 'WE', 'WED', 'WEDNESDAY'
• 'TH', 'THU', 'THURSDAY'
• 'FR', 'FRI', 'FRIDAY'
• 'SA', 'SAT', 'SATURDAY'

返回值

无论输入是 DATETIME 还是 DATE 类型，都返回 DATE 类型的值。

特殊情况：

• 如果 <datetime/date> 输入为 NULL，函数返回 NULL。
• 如果输入是 NEXT_DAY("9999-12-31 12:00:00", <day_of_week>)，函数将返回与输入相同的值。

示例

select next_day("2020-01-31 02:02:02", "MONDAY"),next_day("2020-01-31", "MONDAY");

+--------------------------------------------+-----------------------------------+
| next_day("2020-01-31 02:02:02", "MONDAY")  | next_day("2020-01-31", "MONDAY")  |
+--------------------------------------------+-----------------------------------+
| 2020-02-03                                 | 2020-02-03                        |
+--------------------------------------------+-----------------------------------+