Accueil › Python › Dates, fuseaux et heure d'été
Dates, fuseaux et heure d'été
Données, JSON et APIavance
Il existe deux sortes de datetime en Python, et tout le sujet tient dans leur différence.
from datetime import datetime, timezone
from zoneinfo import ZoneInfo
naif = datetime.now() # pas de tzinfo : quel instant ? on ne sait pas
conscient = datetime.now(timezone.utc) # un instant précis
paris = datetime.now(ZoneInfo("Europe/Paris")) # le même instant, affiché à Paris
Un datetime naïf n'a pas de tzinfo. Il ne désigne aucun instant : 2026-03-29 02:30 n'a même pas existé à Paris, cette minute a été sautée. Les mélanger lève une erreur :
naif < conscient
# TypeError: can't compare offset-naive and offset-aware datetimes
La discipline qui règle le problème, et elle tient en trois lignes :
- Stockez et calculez en UTC. Base de données, fichiers, API : toujours
timezone.utc. - Convertissez en fuseau nommé au seul moment de l'affichage, avec
astimezone(ZoneInfo("Europe/Paris")). - Donnez un fuseau à toute date qui entre dans le programme, dès la ligne qui la lit.
recu = datetime.fromisoformat("2026-03-29T01:30:00+01:00") # conscient, bien
recu_utc = recu.astimezone(timezone.utc) # on calcule là-dessus
print(recu_utc.astimezone(ZoneInfo("Europe/Paris"))) # on affiche là
datetime.utcnow() est à oublier : elle renvoie la bonne heure sans tzinfo, donc un objet naïf, et elle est dépréciée depuis Python 3.12.
Les termes à connaître
- datetime naïf (naive)
Un
datetimesanstzinfo: il porte une date et une heure, mais aucune indication de fuseau. On ne peut donc pas savoir quel instant il désigne. C'est ce que renvoiedatetime.now()appelé sans argument.- datetime conscient (aware)
Un
datetimedonttzinfoest renseigné : il désigne un instant précis et universel.datetime.now(timezone.utc)oudatetime.now(ZoneInfo("Europe/Paris"))en produisent un.- ZoneInfo
Classe du module
zoneinfo(bibliothèque standard depuis Python 3.9) qui représente un fuseau nommé avec ses règles historiques d'heure d'été :ZoneInfo("Europe/Paris"). À préférer à un décalage fixe commetimezone(timedelta(hours=2)), qui serait faux la moitié de l'année.- UTC
Le temps universel coordonné : une référence sans heure d'été, qui ne saute jamais. C'est le fuseau dans lequel on stocke et on calcule. Le fuseau local ne sert qu'à l'affichage.
- Arithmétique murale (wall clock)
Ajouter un
timedeltaà undatetimeconscient travaille sur l'heure affichée, pas sur la durée réelle écoulée :+ timedelta(days=1)garde la même heure au cadran, ce qui peut représenter 23 ou 25 heures autour d'un changement d'heure.- fold
Attribut d'un
datetimequi départage l'heure ambiguë du passage à l'heure d'hiver, vécue deux fois.fold=0désigne la première occurrence,fold=1la seconde. Il vaut0par défaut, ce qui choisit silencieusement l'une des deux.- fromisoformat / isoformat
Le couple à utiliser pour transporter une date en texte.
isoformat()écrit2026-03-29T01:30:00+01:00;fromisoformatle relit. Depuis Python 3.11,fromisoformataccepte aussi le suffixeZet les formats ISO 8601 abrégés.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.