next_day 函数

  • 项目

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

返回晚于 expr 并已按 dayOfWeek 中命名的第一个日期。

语法

next_day(expr, dayOfWeek)

参数

  • expr：一个日期表达式。
  • 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