next_day 函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes 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，则函数返回 NULL 而不是 dayOfWeek 格式错误的消息。

示例

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