Python datetime : comment manipuler la date et l’heure en Python

Le module Python datetime facilite l’utilisation des dates et des heures. Cela vous permet d’afficher des données dans différents formats et de créer des objets de date en seulement quelques lignes de code.

Présentation du module datetime

Python datetime est un module Python qu’il vous faut absolument connaitre, que vous venez de terminer votre premier tutoriel Python ou que vous travaillez depuis longtemps avec ce langage de programmation Internet. Les modules sont le pendant des bibliothèques de code dans d’autres langages de programmation. En important le module datetime, vous ajoutez des fonctions de traitement de la date et de l’heure à Python. Des objets de date spécifiques dans le module sont utilisés à cette fin, que vous pouvez facilement créer dans votre code.

Python datetime : date et heure

Par exemple, vous pouvez utiliser Python datetime pour stocker une date et une heure dans un objet distinct. Pour ce faire, vous avez besoin du constructeur Python datetime, dont la syntaxe ressemble à ceci :

import datetime as dt
dt.datetime(année, mois, jour, heure, minute, seconde, microseconde, fuseau horaire)

Les paramètres acceptés par la fonction représentent la date et l’heure actuelles. Les paramètres permettant de spécifier l’heure sont facultatifs ; la valeur par défaut est toujours 0. Il en va de même pour le paramètre qui spécifie le fuseau horaire et qui est défini par défaut par NUL. La fonction datetime vous renvoie un objet Python datetime.

Python date : date

Comme le constructeur datetime, le constructeur Python date peut également être utilisé pour créer un objet de date. L’heure actuelle n’a ici aucune importance. Sur le plan syntaxique, le constructeur de date est similaire à son homologue datetime :

import datetime as dt
dt.date(année, mois, jour)

Les paramètres de transfert que prend le constructeur Python date sont l’année, le mois et le jour souhaités. Le résultat de l’appel de fonction est un objet de date.

Invoquer la date actuelle : la marche à suivre

Si vous ne souhaitez pas enregistrer de données spécifiques, mais la date et l’heure actuelles, des fonctions prédéfinies sont disponibles. Selon que vous êtes intéressé par la date actuelle uniquement ou par la date et l’heure, vous devrez recourir à une autre fonction.

Procédure pour la date actuelle

Si seule la date, qui se compose de l’année, du mois et du jour, vous intéresse, vous pouvez utiliser une fonction de la classe Python date appelée « today ». L’appel de fonction est extrêmement simple :

import datetime as dt
current_date = dt.date.today()

Pour appeler today, vous devez d’abord spécifier le module datetime, qui est notifié par l’alias dt dans l’exemple ci-dessus. Utilisez ensuite la notation par points pour invoquer la classe de date, dans laquelle la fonction today est à son tour spécifiée. Une fois le code ci-dessus exécuté, la variable current_date contient un objet Python date avec la date courante.

Procédure pour la date et l’heure actuelles

Si vous avez également besoin de l’heure actuelle, une fonction de la classe datetime vous sera utile : la fonction now. Lors d’un appel de now, vous obtenez un objet Python datetime qui contient la date et l’heure actuelles – et qui est précis à la milliseconde.

import datetime as dt
current_date_and_time = dt.datetime.now()

L’appel est effectué de manière analogue à l’appel de la fonction today, mais dans la classe datetime. Un objet datetime contenant la date et l’heure actuelles est stocké dans la variable « current_date_and_time » après l’appel de la fonction.

Formater les données en Python

En particulier pour les applications où vous souhaitez sortir la date, vous devez disposer d’un moyen de mettre les objets datetime ou date au format approprié pour votre application. Le module Python datetime propose également une fonction appelée strftime à cet effet.

La syntaxe de la fonction s’apparente à ceci :

import datetime as dt
current_date = dt.date.today()
current_date.strftime(format)

La fonction est appelée directement sur un objet date ou datetime et accepte un format spécifique en paramètre de transfert. Vous devez spécifier ce format comme string Python, donc entre guillemets. Python prend en charge un certain nombre de formats différents, dont les abréviations sont présentées dans le tableau suivant :