Formations — 1 037 leçons en français

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 :

  1. Stockez et calculez en UTC. Base de données, fichiers, API : toujours timezone.utc.
  2. Convertissez en fuseau nommé au seul moment de l'affichage, avec astimezone(ZoneInfo("Europe/Paris")).
  3. 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 datetime sans tzinfo : 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 renvoie datetime.now() appelé sans argument.

datetime conscient (aware)

Un datetime dont tzinfo est renseigné : il désigne un instant précis et universel. datetime.now(timezone.utc) ou datetime.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 comme timezone(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 à un datetime conscient 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 datetime qui départage l'heure ambiguë du passage à l'heure d'hiver, vécue deux fois. fold=0 désigne la première occurrence, fold=1 la seconde. Il vaut 0 par défaut, ce qui choisit silencieusement l'une des deux.

fromisoformat / isoformat

Le couple à utiliser pour transporter une date en texte. isoformat() écrit 2026-03-29T01:30:00+01:00 ; fromisoformat le relit. Depuis Python 3.11, fromisoformat accepte aussi le suffixe Z et les formats ISO 8601 abrégés.

Lire l'explication détaillée et faire le quiz →

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.