Dates et heures en Python : datetime, timedelta, fuseaux

Le module standard datetime gère tout ce qui touche aux dates et aux heures en Python : créer une date, calculer une échéance, mesurer un écart, convertir une chaîne en date. Il fournit quatre classes clés : date (une date), time (une heure), datetime (les deux) et timedelta (une durée). Ce guide couvre l'obtention de la date actuelle, l'arithmétique avec timedelta, la conversion texte-date avec strptime, et la gestion des fuseaux horaires avec zoneinfo.

Il s'adresse aux développeurs qui horodatent des logs, calculent des échéances ou lisent des dates depuis un fichier. Un concept structure tout : une date peut être naïve (sans fuseau) ou consciente (avec fuseau). Pour le formatage détaillé d'une date en texte, voir le guide formatage de chaînes. Tous les exemples ont été exécutés avec Python 3.12.

Ce que vous allez apprendre

Distinguer les classes date, time, datetime et timedelta.
Obtenir la date et l'heure actuelles proprement.
Calculer des échéances et des écarts avec timedelta.
Convertir une chaîne en date avec strptime.
Gérer les fuseaux horaires avec zoneinfo et UTC.

Les classes date, time et datetime

Le module propose quatre classes complémentaires. On choisit selon ce que l'on manipule : un jour, un horaire, un instant complet ou une durée.

from datetime import date, time, datetime, timedelta

date(2026, 7, 2)                  # une date : 2026-07-02
time(14, 30)                      # une heure : 14:30:00
datetime(2026, 7, 2, 14, 30)      # date + heure : 2026-07-02 14:30:00
timedelta(days=7)                 # une durée : 7 jours

Une fois un objet datetime créé, on accède à ses composants par des attributs :

dt = datetime(2026, 7, 2, 14, 30)
print(dt.year, dt.month, dt.day)   # 2026 7 2
print(dt.hour, dt.minute)          # 14 30

Obtenir la date et l'heure actuelles

Pour l'instant présent, datetime.now() renvoie la date et l'heure locales, et date.today() la date seule.

from datetime import datetime, date, timezone

datetime.now()                  # 2026-07-02 14:30:12.345
date.today()                    # 2026-07-02
datetime.now(timezone.utc)      # même instant, en UTC

Calculer avec timedelta

Un timedelta représente une durée. On l'ajoute ou on le soustrait à une date pour obtenir une échéance.

from datetime import datetime, timedelta

maintenant = datetime.now()

dans_une_semaine = maintenant + timedelta(days=7)
il_y_a_deux_heures = maintenant - timedelta(hours=2)
echeance = maintenant + timedelta(days=1, hours=12)   # combinable

Inversement, soustraire deux dates donne un timedelta, ce qui répond à la question « combien de temps entre A et B ? ».

from datetime import date

ecart = date(2026, 12, 25) - date(2026, 7, 2)
print(ecart.days)             # 176  → jours avant Noël

L'attribut .days donne le nombre de jours entiers, et .total_seconds() la durée totale en secondes, pratique pour convertir en heures ou minutes.

Convertir entre texte et date

Les dates arrivent souvent sous forme de texte (fichier, API, saisie). La méthode strptime (string parse time) lit une chaîne selon un format décrit par des codes.

from datetime import datetime

saisie = "02/07/2026 14:30"
dt = datetime.strptime(saisie, "%d/%m/%Y %H:%M")
print(dt)     # 2026-07-02 14:30:00

Les codes de format sont standards : %d jour, %m mois, %Y année (4 chiffres), %H heure, %M minute, %S seconde. L'opération inverse, produire du texte à partir d'un datetime, se fait avec strftime :

dt.strftime("%d/%m/%Y")         # '02/07/2026'

Gérer les fuseaux horaires

Une date naïve ignore le fuseau ; une date consciente (aware) le connaît. Dès qu'un programme touche plusieurs régions, il faut des dates conscientes. Depuis Python 3.9, le module zoneinfo fournit les fuseaux, sans dépendance externe.

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

paris = datetime(2026, 7, 2, 14, 0, tzinfo=ZoneInfo("Europe/Paris"))
print(paris)                        # 2026-07-02 14:00:00+02:00

en_utc = paris.astimezone(timezone.utc)
print(en_utc)                       # 2026-07-02 12:00:00+00:00

On attache un fuseau à la création avec tzinfo, puis astimezone convertit vers un autre fuseau. zoneinfo remplace l'ancienne bibliothèque tierce pytz.

Les timestamps Unix

Un timestamp est le nombre de secondes écoulées depuis le 1er janvier 1970 (UTC). C'est le format d'échange le plus universel entre systèmes. On convertit dans les deux sens :

from datetime import datetime, timezone

dt = datetime(2026, 7, 2, tzinfo=timezone.utc)
ts = dt.timestamp()                          # 1782950400.0
datetime.fromtimestamp(ts, timezone.utc)     # retour à un datetime

À retenir

Le module datetime fournit date, time, datetime et timedelta ; on choisit selon le besoin.
datetime.now() donne l'instant local ; datetime.now(timezone.utc) l'instant en UTC.
datetime.utcnow() est déprécié (3.12) : préférez now(timezone.utc).
timedelta exprime une durée : on l'ajoute à une date, et soustraire deux dates en renvoie une.
strptime lit une chaîne en date, strftime fait l'inverse (codes %d, %m, %Y).
Depuis Python 3.9, zoneinfo gère les fuseaux sans dépendance (remplace pytz).
Règle d'or : stocker en UTC, convertir à l'affichage.

FAQ : les dates et heures en Python

Comment obtenir la date et l'heure actuelles en Python ?

Importez datetime depuis le module datetime, puis appelez datetime.now() pour la date et l'heure locales, ou date.today() pour la date seule. Pour une heure fiable indépendante du fuseau, utilisez datetime.now(timezone.utc), car datetime.utcnow() est déprécié depuis Python 3.12.

Importez la classe datetime puis appelez now() :

from datetime import datetime, date, timezone

datetime.now()                  # date et heure locales
date.today()                    # date seule
datetime.now(timezone.utc)      # heure en UTC (recommandé pour stocker)

Pour une heure fiable, indépendante du fuseau, préférez datetime.now(timezone.utc). L'ancienne datetime.utcnow() est dépréciée depuis Python 3.12, car elle renvoyait une date sans fuseau, source d'erreurs.

Comment ajouter ou soustraire des jours à une date en Python ?

Utilisez un objet timedelta, qui représente une durée. Ajoutez-le ou soustrayez-le d'une date : datetime.now() + timedelta(days=7) donne dans une semaine. timedelta accepte days, hours, minutes, seconds et weeks, que l'on combine librement pour décaler une date.

On utilise un objet timedelta (une durée) qu'on ajoute ou soustrait :

from datetime import datetime, timedelta

maintenant = datetime.now()
maintenant + timedelta(days=7)      # dans une semaine
maintenant - timedelta(hours=2)     # il y a 2 heures

timedelta accepte days, hours, minutes, seconds, weeks, combinables :

timedelta(days=1, hours=12)         # 1 jour et demi

Comment calculer la différence entre deux dates en Python ?

Soustrayez une date d'une autre : le résultat est un objet timedelta. Son attribut .days donne le nombre de jours, et .total_seconds() le nombre total de secondes. Par exemple date(2026, 12, 25) - date(2026, 7, 2) renvoie un timedelta dont .days vaut 176.

Soustraire deux dates renvoie un timedelta :

from datetime import date

ecart = date(2026, 12, 25) - date(2026, 7, 2)
print(ecart.days)             # 176

.days donne le nombre de jours.
.total_seconds() donne la durée totale en secondes (utile pour des heures ou minutes).

La soustraction fonctionne aussi entre deux datetime complets, avec la précision des secondes.

Comment convertir une chaîne en date en Python ?

Utilisez datetime.strptime(texte, format), en décrivant le format avec des codes comme %d, %m, %Y, %H, %M. Par exemple datetime.strptime("02/07/2026", "%d/%m/%Y") lit la chaîne en objet datetime. L'opération inverse, du datetime vers texte, se fait avec strftime.

La méthode strptime (string parse time) lit une chaîne selon un format :

from datetime import datetime

dt = datetime.strptime("02/07/2026 14:30", "%d/%m/%Y %H:%M")
print(dt)     # 2026-07-02 14:30:00

Les codes décrivent le format : %d jour, %m mois, %Y année, %H heure, %M minute.L'opération inverse (datetime vers texte) se fait avec strftime : dt.strftime("%d/%m/%Y").

Comment gérer les fuseaux horaires en Python ?

Distinguez les dates naïves, sans fuseau, des dates conscientes, avec fuseau. Depuis Python 3.9, le module zoneinfo fournit les fuseaux : ZoneInfo("Europe/Paris"). astimezone convertit d'un fuseau à un autre. La bonne pratique est de stocker en UTC et de convertir à l'affichage.

Distinguez une date naïve (sans fuseau) d'une date consciente (aware, avec fuseau). Depuis Python 3.9, le module zoneinfo fournit les fuseaux, sans dépendance externe :

from datetime import datetime, timezone
from zoneinfo import ZoneInfo

paris = datetime(2026, 7, 2, 14, 0, tzinfo=ZoneInfo("Europe/Paris"))
paris.astimezone(timezone.utc)   # convertit en UTC

zoneinfo remplace l'ancienne bibliothèque pytz. Bonne pratique : stocker en UTC, convertir vers le fuseau local seulement à l'affichage.

Quelle différence entre date, time et datetime en Python ?

date représente une date seule, année mois jour. time représente une heure seule, sans date. datetime combine les deux, une date et une heure. timedelta, à part, représente une durée. On choisit la classe selon qu'on manipule un jour, un horaire, un instant complet ou un écart.

Le module datetime fournit quatre classes complémentaires :

Classe	Représente	Exemple
`date`	une date seule	`date(2026, 7, 2)`
`time`	une heure seule	`time(14, 30)`
`datetime`	date et heure	`datetime(2026, 7, 2, 14, 30)`
`timedelta`	une durée	`timedelta(days=7)`

On choisit selon le besoin : un jour (date), un horaire (time), un instant complet (datetime) ou un écart (timedelta).

Prochaines étapes

Les dates servent surtout à horodater, formater et journaliser. Voici les sujets liés.

Formater une chaîne (f-strings) Afficher une date dans le format voulu, directement dans une f-string.

Journaliser avec logging Horodater proprement les messages de log de vos scripts.

Lire et écrire des fichiers Lire des dates depuis un CSV ou un fichier de logs.

Manipuler du JSON Sérialiser des dates dans un fichier ou une API.