next_day 関数

適用対象: Databricks SQL Databricks Runtime

expr より後の dayOfWeek 名が付けられた最初の日付を返します。

構文

next_day(expr, dayOfWeek)

引数

• expr: DATE 式。
• dayOfWeek: 曜日を識別する STRING 式。

戻り値

DATE 値。

dayOfWeek は、次のいずれかである必要があります (大文字と小文字は区別されません)。

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

注意

Databricks Runtime で、spark.sql.ansi.enabled が false の場合、関数はdayOfWeek の形式に誤りがある場合のエラーではなく、NULL を返します。

例

> SELECT next_day('2015-01-14', 'TU');
 2015-01-20

関連する関数

• dayofweek 関数
• last_day 関数