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

NEXT_DAY

説明​

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

ヒント

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

構文​

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

パラメータ​

Parameterデスクリプション
<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'

Return Value​

入力がDATETIMEかDATEかに関わらず、DATE値を返します。

特別なケース：

  • <datetime/date>の入力がNULLの場合、関数はNULLを返します。
  • 入力がNEXT_DAY("9999-12-31 12:00:00", <day_of_week>)の場合、関数は入力と同じ値を返します。

Example​

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