メインコンテンツまでスキップ
バージョン: 4.x

翌日

説明

NEXT_DAY関数は、指定された日付より後で、指定された曜日に一致する最初の日付を返すために使用されます。

ヒント

この関数はバージョン3.0.6以降でサポートされています。

構文

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

パラメータ

パラメータ説明
<datetime/date>次の曜日を見つけるために使用される日付。
<day_of_week>曜日を識別するSTRING式。

<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 |
+--------------------------------------------+-----------------------------------+