Fonction next_day

S’applique à : Databricks SQL Databricks Runtime

Retourne la première date postérieure à expr et nommée comme dans dayOfWeek.

Syntaxe

next_day(expr, dayOfWeek)

Arguments

• expr : expression de type DATE.
• dayOfWeek : expression de type STRING identifiant un jour de la semaine.

Retours

Une DATE.

dayOfWeek doit être l’une des valeurs suivantes (non-respect de la casse) :

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

Si dayOfWeek n’est pas un nom de jour reconnu, Azure Databricks déclenche INVALID_PARAMETER_VALUE.

Notes

Dans Databricks Runtime, si spark.sql.ansi.enabled est false, la fonction retourne NULL au lieu d’une erreur pour un dayOfWeek malformé.

Conditions d’erreur courantes

• INVALID_PARAMETER_VALUE

Exemples

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

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

Fonctions connexes

• Fonction dayofweek
• Fonction last_day