datetime

Dates et heures : création, formatage, lecture depuis du texte et calculs sur des intervalles de temps.

Sur cette page

Exemple

#
Python
from datetime import datetime, timedelta

start = datetime(2026, 9, 28, 10, 30)
deadline = start + timedelta(days=7)

print(start)
print(deadline.strftime("%d.%m.%Y à %H:%M"))
print((deadline - start).days)
print(deadline > start)
Résultatrésultat enregistré, vous pouvez le vérifier
2026-09-28 10:30:00
05.10.2026 à 10:30
7
True

Définition et utilisation

#

Le module datetime contient des classes pour décrire le temps : date (une date seule), time (une heure seule), datetime (une date avec une heure) et timedelta (un intervalle de temps, par exemple 7 jours ou 90 minutes). On les importe le plus souvent directement : from datetime import datetime, timedelta.

La méthode strftime() transforme une date en texte selon un motif, par exemple %d.%m.%Y donne « 28.09.2026 », et datetime.strptime() fait l’inverse en lisant une date depuis un texte. Pour le format ISO standard (2026-09-28T10:30:00), il existe des méthodes plus simples, isoformat() et fromisoformat().

On compare les dates avec les opérateurs ordinaires < et >, et l’ajout d’un timedelta décale une date vers l’avant ou vers l’arrière. La soustraction de deux dates donne un timedelta, dont vous pouvez lire par exemple le nombre de jours. L’instant présent est renvoyé par datetime.now(), et pour travailler avec les fuseaux horaires, il y a le module zoneinfo.

Syntaxe

#
Syntaxe
from datetime import date, datetime, timedelta

datetime(year, month, day, hour=0, minute=0, second=0)
datetime.now()
moment.strftime(format)
datetime.strptime(texte, format)
timedelta(days=0, hours=0, minutes=0)

Paramètres

#
  • year

    int

    L’année, par exemple 2026.
  • month

    int 1-12

    Le mois.
  • day

    int

    Le jour du mois. Une date inexistante, par exemple le 31 avril, lève ValueError.
  • hour, minute, second

    int, 0 par défaut

    L’heure, la minute et la seconde.
  • tzinfo

    fuseau horaire, facultatif

    Par exemple timezone.utc ou ZoneInfo("Europe/Warsaw"). Sans lui, la date n’a pas de fuseau horaire associé.

Plus d’exemples

#
Lire une date depuis un texte
Python
from datetime import date, datetime

exam = datetime.strptime("15.10.2026 18:00", "%d.%m.%Y %H:%M")
print(exam)
print(exam.isoformat())

birthday = date.fromisoformat("2012-05-03")
print(birthday.year, birthday.weekday())
Résultatrésultat enregistré, vous pouvez le vérifier
2026-10-15 18:00:00
2026-10-15T18:00:00
2012 3

weekday() numérote les jours du lundi (0) au dimanche (6), donc 3 signifie jeudi.

Combien de jours avant l’examen ?
Python
from datetime import date, datetime

exam = date(2026, 12, 15)
days_left = (exam - date.today()).days

print(f"Il reste {days_left} jours avant l’examen")
print(datetime.now().strftime("%H:%M"))
Résultat
Cliquez sur Exécuter pour voir le résultat.

Le résultat dépend du moment de l’exécution. Le 28 septembre 2026, la première ligne est « Il reste 78 jours avant l’examen », et la seconde affiche l’heure actuelle.

Bonnes pratiques

#
  • Ne décomposez pas les dates à la main avec split(). strptime() et fromisoformat() vérifient immédiatement que la date est valide.
  • Dans les f-strings, vous pouvez formater les dates directement : f"{deadline:%d.%m.%Y}".
  • Pour l’enregistrement en JSON et en base de données, utilisez le format ISO, et stockez l’heure des utilisateurs de différents pays en UTC : datetime.now(timezone.utc).

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.