Module Python Datetime

Le module Datetime nous permet de travailler avec des objets date et heure. Il fournit trois types de données supplémentaires : date, time et datetime.

import datetime

date()

datetime.date(year: int, month: int, day: int)

La méthode date retourne un objet date avec les attributs year, month et day :

from datetime import date
# Créer un objet date
obj = date(2022, 12, 1)
# Accéder à l'attribut year
obj.year

2022

obj.month

12

obj.day

1

time()

datetime.time(hour: int, minute: int, second: int)

La méthode time retourne un objet heure avec les attributs hour, minute, second, microsecond et tzinfo :

from datetime import time
# Créer un objet heure
obj = time(10, 20, 33)
# Accéder à l'attribut hour
obj.hour

10

obj.second

33

obj.microsecond

0

datetime()

datetime.datetime(year, month, day, hour, minute, second)

La méthode datetime retourne un objet avec les attributs des objets date et time :

from datetime import datetime
# Créer un objet datetime avec date et heure
obj = datetime(2024, 12, 1, 15, 35, 59)
# Accéder à l'attribut year
obj.year

2024

obj.month

12

obj.day

1

obj.hour

15

obj.second

59

now() et today()

Les méthodes now et today retournent un objet datetime avec le jour et l’heure exacts du système :

from datetime import datetime
# Obtenir la date et l'heure actuelles
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 19, 56, 49, 589806)

Puisque l’objet retourné est un datetime, nous pouvons accéder aux attributs date et time :

now.date()

datetime.date(2022, 7, 23)

now.time()

datetime.time(19, 56, 49, 589806)

now.year

2022

now.month

7

now.day

23

now.hour

19

now.minute

56

now.second

49

now.microsecond

589806

De plus, now peut prendre un objet timezone comme paramètre optionnel :

from datetime import datetime, timezone
# Obtenir l'heure UTC actuelle
datetime.now(timezone.utc)

datetime.datetime(2022, 7, 24, 0, 20, 8, 265634, tzinfo=datetime.timezone.utc)

Si un paramètre timezone n’est pas spécifié, now utilisera par défaut le fuseau horaire du système.

strftime() et strptime()

Vous pouvez facilement transformer des objets datetime en chaînes de caractères et vice-versa avec les méthodes strftime et strptime.

strftime()

strftime nous permet de créer des chaînes de caractères formatées lisibles à partir d’un objet datetime Python :

from datetime import datetime
# Obtenir la date et l'heure actuelles pour les exemples de formatage
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 20, 31, 19, 751479)

# Formater datetime en jour-mois-année avec mois abrégé
now.strftime("%d-%b-%Y")

'23-Jul-2022'

# Formater datetime en jour-mois-année avec mois numérique
now.strftime("%d-%m-%Y")

'23-07-2022'

# Formater datetime en mois/jour/année
now.strftime("%m/%d/%Y")

'07/23/2022'

# Formater datetime avec date et heure
now.strftime("%b/%d/%Y - %H:%M:%S")

'Jul/23/2022 - 20:31:19'

Vous trouverez peut-être les chaînes passées à strftime un peu étranges, mais il est assez facile de comprendre leur signification. Par exemple, %m/%d/%Y retournera le mois, le jour et l’année séparés par / (07/23/2022).

strptime()

La méthode strptime crée un objet datetime à partir d’une chaîne de caractères.

Cette méthode accepte deux paramètres :

obj.strptime(datetime_string, format)

• Une chaîne représentant un objet datetime.
• Le code de format Python équivalent à cette chaîne.

from datetime import datetime

# Analyser la chaîne en objet datetime
datetime_str = '12-Jul-2023'
datetime.strptime(datetime_str, '%d-%b-%Y')

datetime.datetime(2023, 7, 12, 0, 0)

# Analyser la chaîne avec date et heure
datetime_str = 'Jul/12/2023 - 14:38:37'
datetime.strptime(datetime_str, "%b/%d/%Y - %H:%M:%S")

datetime.datetime(2023, 7, 12, 14, 38, 37)

Codes de Format

timedelta()

L’objet timedelta représente la différence entre deux dates ou heures.

from datetime import datetime

# Créer deux objets datetime
date_1 = datetime.strptime('12-Jul-2023', '%d-%b-%Y')
date_2 = datetime.strptime('01-Jan-2024', '%d-%b-%Y')

# Calculer la différence (retourne timedelta)
difference = date_2 - date_1
difference

datetime.timedelta(days=173)

# Obtenir le nombre de jours à partir de timedelta
difference.days

173

timedelta peut ajouter des days, seconds et microseconds à un objet datetime :

from datetime import datetime, timedelta

# Obtenir la date et l'heure actuelles pour les opérations timedelta
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 21, 25, 2, 341081)

# Ajouter 10 jours et 15 secondes à la date et l'heure actuelles
now + timedelta(days=10, seconds=15)

datetime.datetime(2022, 8, 2, 21, 25, 17, 341081)

Et peut soustraire des days, seconds et microseconds à un objet datetime :

from datetime import datetime, timedelta

# Obtenir la date et l'heure actuelles pour l'exemple de soustraction
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 21, 25, 2, 341081)

# Soustraire 10 jours et 15 secondes de la date et l'heure actuelles
now - timedelta(days=10, seconds=15)

datetime.datetime(2022, 7, 13, 21, 59, 41, 100883)

Liens pertinents

• Cheatsheet : Formatage de Chaînes
• Blog : Types de Données Python
• str()
• format()
• print()