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'

如果 dayOfWeek 不是识别的日期名称,Azure Databricks将引发 INVALID_PARAMETER_VALUE。

注意

在 Databricks Runtime 中,如果 spark.sql.ansi.enabled 为 false,则函数返回 NULL 而不是 dayOfWeek 格式错误的消息。

常见错误条件

示例

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

> SELECT next_day('2024-01-01', 'INVALID');
  Error: INVALID_PARAMETER_VALUE