Catégories :

Fonctions de date et d’heure

TIMEDIFF

Calcule la différence entre deux expressions de date, d’heure ou d’horodatage en fonction de la partie de date ou d’heure spécifiée.

Alternative pour DATEDIFF.

Syntaxe

TIMEDIFF( <date_or_time_part> , <date_or_time_expr1> , <date_or time_expr2> )

Arguments

  • partie_date_ou_heure doit être l’une des valeurs listées dans Parties de date et d’heure prises en charge.

  • expr_date_ou_heure1, expr_date_ou_heure2 doivent être une date, une heure, un horodatage ou une expression pouvant correspondre à l’une de celles-ci. La première valeur est soustraite de la deuxième valeur.

Notes sur l’utilisation

Exemples

Ceci montre le résultat de la soustraction de deux dates, dans lesquelles la seconde est deux ans plus tard que la première :

SELECT TIMEDIFF(YEAR, '2017-01-01', '2019-01-01') AS Years;

Sortie :

+--------+
| YEARS  |
+========+
|     2  |
+--------+

Ceci montre que nous n’arrondissons pas à la valeur la plus proche. La différence est plus proche de 12 mois que de 11, mais nous calculons la différence comme 11 mois :

SELECT TIMEDIFF(MONTH, '2017-01-1', '2017-12-31') AS Months;

Sortie :

+--------+
| MONTHS |
+========+
|    11  |
+--------+

Des exemples supplémentaires figurent dans DATEDIFF.