Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Python `date` : lire une date, l’extraire et l’associer à une heure

En Python 3.12, `strptime()` renvoie un `datetime`, `.date()` en extrait la date et `combine()` lui associe une heure choisie.

Version : Python 3.12

Syntaxe

from datetime import date, datetime, time

calendar_day = date(year, month, day)
parsed = datetime.strptime(text, format_string)
calendar_day = parsed.date()
combined = datetime.combine(calendar_day, clock_time)
combined = datetime.combine(calendar_day, clock_time, tzinfo=zone)

En Python 3.12, datetime.date est une classe immuable du module datetime. Un objet date contient une année, un mois et un jour, mais ni heure ni fuseau horaire. Après from datetime import date, date(year, month, day) construit une date à partir de trois entiers. Si les arguments sont représentables par le type int du C, une date invalide comme le 29 février 2023 déclenche ValueError. En CPython 3.12, un entier qui ne peut pas être converti en int du C, comme l’année dans date(10**100, 1, 1), déclenche OverflowError avant la validation de la date.

Après from datetime import datetime, le nom datetime désigne la classe datetime.datetime, et non le module. La méthode de classe datetime.strptime(text, format_string) lit le texte selon le format indiqué et renvoie un datetime, même si le texte ne contient qu’une date. Dans %d/%m/%Y, des barres obliques séparent le jour, le mois et l’année sur quatre chiffres. Si aucune heure n’est indiquée, le résultat contient 00:00:00. Un texte incompatible avec le format ou une date invalide déclenche ValueError. La classe date ne possède pas de méthode strptime() en Python 3.12.

La méthode d’instance parsed.date() renvoie un objet date avec la même année, le même mois et le même jour. Elle ne modifie pas parsed, ne conserve ni l’heure ni le fuseau horaire et ne fait aucune conversion de fuseau. À la différence de cette méthode, le constructeur date(year, month, day) reçoit les composantes de la date séparément.

La méthode de classe datetime.combine(calendar_day, clock_time) crée un nouveau datetime à partir d’une date et d’un objet datetime.time, pas d’une chaîne. Par défaut, elle reprend le tzinfo de l’objet time ; un argument explicite tzinfo=zone remplace cette valeur sans convertir l’heure. Si le premier argument est un datetime, son heure et son tzinfo sont ignorés.

Exemples

from datetime import date, datetime, time

parsed = datetime.strptime("29/02/2024", "%d/%m/%Y")
calendar_day = parsed.date()
assert type(calendar_day) is date
combined = datetime.combine(calendar_day, time(14, 30))

print(parsed.isoformat())
print(calendar_day.isoformat())
print(combined.isoformat())

Résultat

2024-02-29T00:00:00
2024-02-29
2024-02-29T14:30:00

La première ligne affiche minuit après la lecture d’une date sans heure, la deuxième affiche uniquement la date, et la troisième affiche cette même date à 14:30 sans fuseau horaire.

Leçons associées

  • Python · Leçon 31 · Intermédiaire · Version : 3

Sources