next_day-Funktion

Gilt für: Databricks SQL Databricks Runtime

Gibt das erste Datum zurück, das nach expr liegt und wie in dayOfWeek benannt ist.

Syntax

next_day(expr, dayOfWeek)

Argumente

• expr: Ein DATE-Ausdruck.
• dayOfWeek: Ein STRING-Ausdruck, der einen Wochentag identifiziert.

Gibt zurück

Ein DATE-Element.

dayOfWeek muss einer der folgenden Begriffe sein (Groß-/Kleinschreibung wird nicht beachtet):

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

Hinweis

Wenn spark.sql.ansi.enabled in Databricks Runtime false ist, gibt die Funktion NULL anstelle eines Fehlers für einen falsch formatierten dayOfWeek-Wert zurück.

Beispiele

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

Zugehörige Funktionen

• dayofweek Funktion
• last_day Funktion