Cours MariaDB / Choisir DATE, DATETIME ou TIMESTAMP et comprendre les fuseaux horaires
DATE conserve une date, DATETIME des champs de date et d’heure, et TIMESTAMP un instant converti selon le fuseau de la connexion. Choisissez d’abord entre une heure locale de calendrier et le moment d’un événement : changer le fuseau de session peut modifier l’affichage de TIMESTAMP sans modifier celui de DATETIME.
Distinguer une date, une heure locale et un instant
| Type | Usage possible | Comportement du fuseau |
|---|---|---|
| DATE | Anniversaire ou jour de réservation | Ne conserve ni heure ni identifiant de fuseau |
| DATETIME | Champs de calendrier tels que 2026-10-13 09:00:00 | Le changement du fuseau de session seul ne convertit pas la valeur |
| TIMESTAMP | Instant de réception ou d’enregistrement d’un événement | Conversion entre le fuseau de session et UTC à l’écriture et à la lecture |
Le temps universel coordonné, ou UTC, fournit une référence commune pour comparer des instants. Avec un décalage de +09:00, 09:00 en Corée correspond à 00:00 UTC le même jour. Ajouter les lettres UTC à une chaîne ne configure pas le fuseau d’une connexion.
Un DATETIME local ne conserve pas à lui seul la région ni les règles de changement d’heure. Selon le besoin, une application peut normaliser ses valeurs en UTC ou conserver des champs locaux accompagnés d’un identifiant de fuseau. TIMESTAMP ne conserve pas non plus le nom du fuseau utilisé à l’entrée : il ne remplace donc pas toutes les informations nécessaires à la planification d’un rendez-vous local.
Vérifier la version et le fuseau de la connexion
Utilisez l’instance d’apprentissage, le compte course_user et la base shopcourse. Les cours sur la création de la base et le client et les fichiers SQL donnent les prérequis. Saisissez ces instructions dans le client MariaDB, sans utiliser une connexion contenant des données de production :
SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;
Après USE, la base sélectionnée doit être shopcourse. Examinez ensuite les réglages de temps :
SELECT @@SESSION.time_zone AS session_zone,
@@GLOBAL.time_zone AS global_zone,
@@system_time_zone AS system_zone;
SESSION concerne la connexion courante ; le réglage global fournit une valeur initiale aux nouvelles connexions. SYSTEM demande d’utiliser le fuseau du système d’exploitation du serveur. Ne déduisez pas le réglage actif de la seule localisation de la machine. Cet exercice utilise les décalages explicites +09:00 et +00:00, sans demander le chargement des tables de fuseaux nommés.
Les plages ordinaires de DATE et DATETIME couvrent les années 1000 à 9999. La plage de TIMESTAMP dépend de la version : avant MariaDB 11.5, sa borne supérieure est le 2038-01-19 03:14:07 UTC ; à partir de 11.5, elle atteint le 2106-02-07 06:28:15 UTC. Sa borne inférieure ordinaire est le 1970-01-01 00:00:01 UTC, indépendamment des valeurs spéciales nulles ou zéro. Comparez votre résultat de VERSION() avec les limites de TIMESTAMP selon la version, car deux paquets d’installation peuvent proposer des versions différentes.
Insérer une fois et changer seulement le fuseau
Vérifiez qu’aucune table time_lab à conserver n’existe déjà. Enregistrez ce bloc dans un fichier UTF-8 lesson10-date-time-types.sql, puis exécutez-le avec SOURCE et son chemin local réel. Vous pouvez aussi saisir ses instructions dans l’ordre. Gardez la même connexion ouverte jusqu’à la restauration des réglages.
L’exemple sauvegarde le mode SQL et le fuseau de session, puis utilise STRICT_TRANS_TABLES pour le contrôle des dates. Il ne modifie pas les réglages globaux. La déclaration explicite TIMESTAMP NULL DEFAULT NULL évite de dépendre des propriétés automatiques implicites de la première colonne TIMESTAMP, qui varient selon la version et la configuration. Le cours sur la définition et la vérification d’une table explique l’intérêt de contrôler sa déclaration réelle.
USE shopcourse;
SET @saved_sql_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = 'STRICT_TRANS_TABLES';
SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE time_lab (
item_id INT PRIMARY KEY,
event_date DATE NOT NULL,
wall_time DATETIME NOT NULL,
instant_time TIMESTAMP NULL DEFAULT NULL
) ENGINE=InnoDB;
INSERT INTO time_lab VALUES
(1, '2026-10-13', '2026-10-13 09:00:00', '2026-10-13 09:00:00');
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+00:00';
SELECT item_id, event_date, wall_time, instant_time FROM time_lab;
SET SESSION time_zone = '+09:00';
SELECT item_id, wall_time, instant_time FROM time_lab;
Les deux premières requêtes lisent DATE, DATETIME et TIMESTAMP. La troisième lit seulement l’identifiant et les deux colonnes contenant une heure. Les valeurs des colonnes suivent cette comparaison :
| Fuseau de lecture | event_date | wall_time | instant_time |
|---|---|---|---|
| +09:00 après insertion | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 09:00:00 |
| +00:00 | 2026-10-13 | 2026-10-13 09:00:00 | 2026-10-13 00:00:00 |
| +09:00 rétabli | 2026-10-13, conservée mais non sélectionnée dans cette dernière requête | 2026-10-13 09:00:00 | 2026-10-13 09:00:00 |
Le TIMESTAMP ne devient pas un second événement lorsque vous changez le décalage. C’est le même instant, présenté dans le fuseau de lecture. DATETIME conserve ses champs de calendrier. Revenir à +09:00 permet de retrouver l’affichage initial sans mettre les données à jour. Les références DATETIME et TIMESTAMP décrivent cette différence.
Déclarer les valeurs automatiques et les fractions de seconde
Pour renseigner automatiquement une heure de création, déclarez explicitement DEFAULT CURRENT_TIMESTAMP sur la colonne concernée. ON UPDATE CURRENT_TIMESTAMP correspond à un autre choix : actualiser automatiquement une colonne lorsque les conditions de mise à jour sont remplies. Une heure de dernière modification ne représente pas nécessairement l’instant où un événement extérieur s’est produit.
DATETIME(6) et TIMESTAMP(6) indiquent une précision de six chiffres après la seconde, soit des microsecondes. Le 6 ne décrit ni la longueur totale de la valeur ni la plage des années. Faites correspondre la précision de la colonne et celle de son expression de valeur par défaut, par exemple avec CURRENT_TIMESTAMP(6) lorsque ce niveau est nécessaire. Tous les enregistrements n’ont pas besoin de microsecondes.
Utilisez des formats sans ambiguïté comme YYYY-MM-DD et YYYY-MM-DD HH:MM:SS. Une entrée telle que 10/11/26 ne permet pas de déduire clairement l’intention d’un utilisateur francophone ou anglophone. Conserver des dates sous forme de textes arbitraires complique aussi les conversions et les comparaisons. La référence DATE présente le type de date seul.
Diagnostiquer une date invalide ou un décalage inattendu
Après le fichier normal, lancez cet essai séparément, dans la même connexion encore en mode strict. Le 30 février 2026 n’existe pas :
INSERT INTO time_lab VALUES (2, '2026-02-30', '2026-10-13 09:00:00', NULL);
Une erreur Incorrect date value doit empêcher l’insertion. Vérifiez avec SELECT COUNT(*) FROM time_lab; que la table contient toujours une seule ligne. Évitez d’insérer ce test au milieu du fichier normal : une erreur peut en interrompre la lecture, notamment avec --abort-source-on-error.
Le mode SQL influence les dates impossibles, les dates zéro et les composantes égales à zéro. Ne l’assouplissez pas simplement pour faire disparaître une erreur : cela peut changer le sens des données acceptées. La documentation du mode SQL précise ces conditions.
Si le résultat diffère de neuf heures, vérifiez d’abord le type de colonne et @@SESSION.time_zone. Avant un UPDATE ajoutant ou retirant neuf heures, contrôlez si l’application et la connexion appliquent deux fois une conversion. Corriger l’affichage en modifiant les données risquerait alors de déplacer l’instant réellement enregistré.
Un décalage fixe ne représente pas les changements d’heure saisonniers d’une région. Les fuseaux nommés nécessitent des données de fuseau adaptées sur le serveur et une politique cohérente dans l’application. Cet exercice vérifie uniquement la conversion entre deux décalages fixes.
Restaurer le fuseau et le mode SQL initiaux
Dans la connexion qui a sauvegardé les deux variables, restaurez les réglages puis lisez leur valeur :
SET SESSION time_zone = @saved_time_zone;
SET SESSION sql_mode = @saved_sql_mode;
SELECT @@SESSION.time_zone, @@SESSION.sql_mode;
Si vous avez fermé cette connexion, les variables enregistrées ne sont pas conservées dans la nouvelle session. Consultez alors ses réglages courants au lieu de lui appliquer des variables vides. La fermeture d’une connexion termine ses réglages propres, mais ne supprime pas les lignes enregistrées.
Pour répéter l’exercice, confirmez la base avec SELECT DATABASE();, la déclaration avec SHOW CREATE TABLE shopcourse.time_lab; et les données à conserver. Sauvegardez-les si nécessaire. Seulement après avoir confirmé cette cible d’apprentissage, exécutez :
DROP TABLE shopcourse.time_lab;
La suppression concerne la structure et les données de shopcourse.time_lab ; un ROLLBACK ordinaire ne les restaure pas. La table products du premier exercice de produits reste hors de cette réinitialisation. Relancez ensuite le fichier normal pour comparer de nouveau les affichages sous les deux décalages.




