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

CKTIS / Python

strftime : formater une date et une heure avec un décalage UTC

Associez un décalage UTC fixe et connu à une date et une heure sans les modifier, puis affichez la même valeur dans un format personnalisé et au format ISO 8601.

Version : Python 3.12

Syntaxe

dt.strftime(format) -> str
dt.replace(tzinfo=offset) -> datetime
dt.isoformat(sep='T', timespec='auto') -> str

Dans Python 3.12, strftime(format) est une méthode d’instance de datetime.datetime. Elle renvoie une chaîne str selon le format fourni, sans modifier l’objet. Dans l’exemple, %d/%m/%Y donne le jour, le mois et l’année, et %H:%M:%S donne l’heure au format 24 heures, les minutes et les secondes. Les barres obliques, les deux-points et les espaces sont repris tels quels.

Si vous savez que l’heure affichée correspond à un décalage UTC fixe, utilisez replace(tzinfo=offset) avec un objet timezone construit à partir d’un timedelta. Vous obtenez un nouveau datetime avec information de fuseau horaire (aware), sans changer la date ni l’heure. L’opération associe un décalage sans effectuer de conversion, et un décalage fixe ne suit pas les changements d’heure saisonniers. Pour représenter le même instant dans un autre fuseau, appelez astimezone() sur un datetime qui possède déjà cette information.

%z affiche le décalage UTC : +05:30 devient +0530, et pour un datetime sans information de fuseau (naive), cette directive donne une chaîne vide. %Z affiche le nom du fuseau renvoyé par tzname() au lieu du décalage numérique. Si tzname() renvoie None, par exemple lorsque tzinfo vaut None, %Z donne une chaîne vide. L’ensemble des directives prises en charge varie selon la plateforme, et les noms des mois et des jours de la semaine peuvent dépendre des paramètres régionaux.

Utilisez strftime pour choisir la présentation et isoformat() pour obtenir une représentation ISO 8601. Les deux méthodes renvoient du texte sans modifier le datetime. Par défaut, isoformat() sépare la date de l’heure par T et affiche le décalage de cet exemple sous la forme +05:30.

Exemples

from datetime import datetime, timedelta, timezone

wall_time = datetime(2024, 6, 15, 9, 5, 7)
offset = timezone(timedelta(hours=5, minutes=30))
aware = wall_time.replace(tzinfo=offset)

print(aware.strftime("%d/%m/%Y %H:%M:%S %z"))
print(aware.isoformat())

Résultat

15/06/2024 09:05:07 +0530
2024-06-15T09:05:07+05:30

Les deux lignes conservent `09:05:07` : la première suit le format `strftime` et se termine par `+0530` ; la seconde utilise `isoformat()` et se termine par `+05:30`.

Leçons associées

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

Sources