datetime
Dates et heures : création, formatage, lecture depuis du texte et calculs sur des intervalles de temps.
Exemple
#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)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
#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 exemple2026.month
int 1-12
Le mois.day
int
Le jour du mois. Une date inexistante, par exemple le 31 avril, lèveValueError.hour, minute, second
int, 0 par défaut
L’heure, la minute et la seconde.tzinfo
fuseau horaire, facultatif
Par exempletimezone.utcouZoneInfo("Europe/Warsaw"). Sans lui, la date n’a pas de fuseau horaire associé.
Plus d’exemples
#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())weekday() numérote les jours du lundi (0) au dimanche (6), donc 3 signifie jeudi.
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"))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()etfromisoformat()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
#- timeMettre le programme en pause, horodatages et mesure précise du temps d’exécution du code.
- jsonConvertit des données Python en texte JSON et inversement. La base de l’enregistrement de données et de la communication avec les API.
- f-stringsDes chaînes avec insertion de valeurs d’expressions : f"Vous avez {points} pts".
- str.format()Insère des valeurs aux emplacements marqués par des accolades.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.