Cours MariaDB / Calculer des périodes et afficher les dates

Dans MariaDB, DATE_ADD ajoute une période à une date, DATEDIFF compare les parties calendaires et TIMESTAMPDIFF calcule une différence entière dans l’unité choisie. DATE_FORMAT produit du texte pour l’affichage ; pour sélectionner un mois complet, utilisez une borne de début incluse et la borne du mois suivant exclue.

Définir la question avant de choisir une fonction

Une échéance dans un mois, un changement de jour à minuit et deux heures écoulées ne désignent pas la même mesure. Commencez par préciser l’unité et le sens de la comparaison. Conservez des valeurs temporelles pour calculer ; les convertir en libellés locaux puis réinterpréter ces libellés ajoute des ambiguïtés inutiles.

Fonction Question traitée Ordre des arguments
DATE_ADD Quelle date obtient-on après une période ? Date de départ, puis INTERVAL valeur unité.
DATEDIFF Combien de jours séparent les dates calendaires ? Première date moins seconde date ; les heures sont ignorées.
TIMESTAMPDIFF Quelle différence entière dans une unité donnée ? Unité, début, fin ; la fin moins le début.
DATE_FORMAT Quel texte afficher pour cette date ? Valeur temporelle, puis chaîne de format.

Le cours sur DATE, DATETIME, TIMESTAMP et les fuseaux horaires explique la différence entre les types stockés. Une même règle de bornes doit aussi servir aux sélections détaillées et aux totaux d’un rapport mensuel : sinon, un événement peut apparaître dans une liste mais manquer dans son total.

Comparer un mois et trente jours avec des dates fixes

Connectez-vous à la base d’apprentissage shopcourse avec course_user. Sélectionnez-la avec USE shopcourse;, puis examinez SELECT VERSION(), DATABASE(), @@SESSION.time_zone;. Les requêtes autonomes ci-dessous n’utilisent aucune table ; la petite table de la cinquième section nécessitera les droits de création, insertion, lecture et suppression dans cette base.

Exécutez le SQL dans le client MariaDB. Vous pouvez enregistrer les blocs dans un fichier UTF-8 et utiliser SOURCE C:/mariadb-lab/lesson21.sql;, en adaptant le chemin réel, comme expliqué dans le cours sur le client et les fichiers SQL. Les entrées fixes évitent que les résultats changent selon la date à laquelle vous faites l’exercice. Écrivez les dates dans l’ordre année-mois-jour.

SELECT DATE_ADD('2026-01-31',INTERVAL 1 MONTH);
SELECT DATE_ADD('2026-01-31',INTERVAL 30 DAY);

Les résultats sont respectivement 2026-02-28 et 2026-03-02. Février 2026 n’a pas de jour 31 : l’ajout d’un mois ajuste donc le résultat au dernier jour valide du mois cible. Ajouter trente jours suit une autre règle et atteint mars. Le mois civil ne peut pas être remplacé systématiquement par trente jours.

La syntaxe de DATE_ADD permet de choisir explicitement l’unité de l’intervalle. Pour une échéance, décidez si vous voulez conserver le numéro du jour ou une règle de fin de mois. Par exemple, ajouter encore un mois à la date obtenue du 28 février n’est pas nécessairement équivalent à ajouter deux mois à la date initiale du 31 janvier : la première correction a déjà changé le numéro du jour. Ne déduisez pas une politique d’abonnement de la seule syntaxe SQL.

Distinguer jours calendaires, heures et sens de la différence

SELECT DATEDIFF('2026-02-02 01:00:00','2026-02-01 23:00:00'),
 TIMESTAMPDIFF(HOUR,'2026-02-01 23:00:00','2026-02-02 01:00:00');

Cette requête donne 1 et 2. Le passage du 1er février à 23 h au 2 février à 1 h traverse minuit, mais ne dure que deux heures dans ces valeurs de calendrier. DATEDIFF ignore les composantes horaires et soustrait la seconde date de la première.

TIMESTAMPDIFF reçoit l’unité, le début puis la fin. Dans l’exemple, le début est donc le 1er février à 23 h. Si vous inversez les deux valeurs temporelles de chaque appel, vous obtenez -1 et -2. Recopier mécaniquement le même ordre entre ces fonctions risque d’inverser le signe attendu.

Le résultat de TIMESTAMPDIFF est entier. Avec une différence de deux heures et trente minutes, l’unité HOUR donne 2, tandis que MINUTE donne 150. Choisissez une unité assez fine pour la précision recherchée ; ne prenez pas 2 pour une mesure contenant aussi les minutes restantes.

Une paire de DATETIME décrit des champs de calendrier, sans identifier à elle seule un fuseau régional. Lorsqu’un changement d’heure ou plusieurs régions interviennent, définissez si vous comparez des heures locales ou des instants normalisés, puis effectuez les conversions appropriées. Le nom TIMESTAMPDIFF ne garantit pas automatiquement une mesure universelle du temps réellement écoulé pour toute paire de dates locales.

Réserver DATE_FORMAT à la présentation

SELECT DATE_FORMAT('2026-02-05 12:34:56','%Y-%m'),
 DATE_FORMAT('2026-02-05 12:34:56','%Y-%m-%d %H:%i:%s');

Les chaînes obtenues sont 2026-02 et 2026-02-05 12:34:56. Dans le format, %Y représente l’année sur quatre chiffres, %m le mois, %d le jour, %H l’heure de 00 à 23, %i les minutes et %s les secondes. Confondre %m et %i peut produire un texte plausible mais incorrect.

Les spécificateurs de DATE_FORMAT permettent aussi d’afficher des noms de mois ou de jours. Leur langue dépend notamment de lc_time_names ; un format purement numérique comme celui de l’exemple évite cette dépendance de vocabulaire. Vérifiez les paramètres de votre session si les noms ne sont pas dans la langue attendue.

La fonction renvoie une représentation textuelle et ne modifie pas une colonne enregistrée. Gardez la valeur temporelle d’origine pour filtrer et calculer. Un libellé limité à année-mois ne conserve ni le jour ni l’heure : il ne doit pas remplacer l’instant d’un événement dont vous aurez besoin ensuite.

Sélectionner le mois entier avec une borne supérieure exclue

Dans shopcourse, contrôlez SHOW TABLES LIKE 'dates_21_lab'; avant la création. Si une table existe déjà, inspectez sa définition et son contenu au lieu de l’écraser. Le bloc suivant contient toute la création, les trois insertions et la requête ; il ne dépend pas des tables de produits des autres leçons.

CREATE TABLE dates_21_lab (event_id INT PRIMARY KEY, occurred_at DATETIME NOT NULL)
 ENGINE=InnoDB;
INSERT INTO dates_21_lab VALUES
 (1,'2026-02-01 00:00:00'),(2,'2026-02-28 23:59:59'),(3,'2026-03-01 00:00:00');
SELECT event_id FROM dates_21_lab
WHERE occurred_at >= '2026-02-01' AND occurred_at < '2026-03-01'
ORDER BY event_id;
event_id occurred_at Dans la sélection de février ?
1 2026-02-01 00:00:00 Oui : le début est inclus.
2 2026-02-28 23:59:59 Oui : encore avant mars.
3 2026-03-01 00:00:00 Non : la borne supérieure est exclue.

La requête renvoie uniquement les identifiants 1 et 2, dans cet ordre. Les deux comparaisons décrivent l’intervalle allant du début de février inclus au début de mars exclu. Le même principe permet d’enchaîner les mois sans compter deux fois leur frontière commune.

Fixer la fin à 2026-02-28 23:59:59 serait fragile si la colonne passait à DATETIME(6) : un événement à 23:59:59.500000 appartient encore à février mais dépasse cette limite à la seconde. Le début du mois suivant évite ce problème sans deviner la dernière fraction possible. La table d’origine utilise ici DATETIME sans fractions ; le raisonnement reste applicable à une précision plus fine.

Comparer directement la colonne à deux bornes rend aussi la condition de recherche explicite pour examiner les index. Cela ne garantit pas qu’un index soit présent ou choisi ; vérifiez le schéma et le plan réel lorsque les volumes le justifient. Il n’est pas nécessaire de transformer chaque valeur en texte « année-mois » pour exprimer cette période.

Diagnostiquer les dates incorrectes et recommencer proprement

Si une fonction donne NULL ou un résultat inattendu, contrôlez séparément la valeur d’entrée, l’ordre des arguments, l’unité, le type et le fuseau de la session. Examinez les avertissements immédiatement après la requête dans la même connexion avec SHOW WARNINGS;. Vérifiez aussi le mode SQL et les règles de fin de mois ou d’année bissextile. Une conversion acceptée ne suffit pas à rendre une date incomplète ou une date zéro valide pour votre application.

Une date manquante ne signifie pas automatiquement « aujourd’hui ». Avant d’utiliser une valeur de remplacement, décidez si vous devez conserver cette absence et comment l’exclure ou la signaler dans les résultats. Les règles de NULL et des valeurs de remplacement s’appliquent également aux données temporelles.

DROP TABLE shopcourse.dates_21_lab;

Exécutez cette suppression seulement après avoir vérifié le nom complet et sauvegardé ce qui doit être conservé. Elle retire la structure et les lignes de shopcourse.dates_21_lab, sans supprimer la base ni les tables des autres exercices. DROP TABLE n’est pas annulé par un ROLLBACK ordinaire. Pour répéter l’exercice, sélectionnez shopcourse, rejouez le bloc de création et d’insertion, puis vérifiez que la sélection donne toujours 1 et 2.