CKTIS / Python
Associer un décalage UTC avec datetime.replace()
Associez un décalage UTC fixe et connu sans modifier la date ni l’heure affichée, puis produisez une chaîne au format de votre choix ou au format ISO 8601.
Version : Python 3.12
Syntaxe
dt.replace(year=dt.year, month=dt.month, day=dt.day, hour=dt.hour, minute=dt.minute, second=dt.second, microsecond=dt.microsecond, tzinfo=dt.tzinfo, fold=dt.fold)
aware = dt.replace(tzinfo=timezone(timedelta(hours=2)))
aware.strftime("%d/%m/%Y %H:%M:%S %z")
aware.isoformat()Dans Python 3.12, datetime.datetime.replace est une méthode d’instance de la classe datetime du module datetime. Elle renvoie un nouvel objet : les champs fournis sont remplacés et les autres sont repris de l’original. Ce n’est pas un calcul de durée : par exemple, hour=24 lève ValueError au lieu de passer au jour suivant.
Si vous savez que l’heure relevée correspond au décalage +02:00, créez tz = timezone(timedelta(hours=2)), puis appelez dt.replace(tzinfo=tz). Un objet naïf devient associé à un fuseau (aware), mais la date et l’heure affichée restent identiques. Un décalage fixe ne tient pas compte des changements d’heure d’été. dt.replace(tzinfo=None) retire l’information de fuseau sans convertir la date ni l’heure.
Pour représenter le même instant dans un autre fuseau, appelez astimezone(tz) sur un objet qui possède déjà une information de fuseau : la date ou l’heure peut changer, mais pas l’instant. Sur un objet naïf, astimezone() suppose le fuseau local du système. L’argument distinct fold ne peut être fourni que par son nom. Dans un intervalle d’heure locale qui se répète, 0 désigne le premier instant et 1 le second. Si vous omettez fold, sa valeur d’origine est conservée.
strftime() suit une chaîne de format explicite ; ici, %z produit +0200. L’ensemble des directives prises en charge dépend de la plateforme. Sans argument, isoformat() renvoie une chaîne ISO 8601 avec le séparateur T et le décalage +02:00. Aucune des deux méthodes ne modifie l’objet ni ne convertit l’heure.
Exemples
from datetime import datetime, timedelta, timezone
wall_time = datetime(2024, 6, 15, 9, 30)
fixed_offset = timezone(timedelta(hours=2))
aware = wall_time.replace(tzinfo=fixed_offset)
print(aware.strftime("%d/%m/%Y %H:%M:%S %z"))
print(aware.isoformat())Résultat
15/06/2024 09:30:00 +0200 2024-06-15T09:30:00+02:00
Les deux lignes conservent `09:30:00`. Le format personnalisé place le jour avant le mois et écrit `+0200` ; le format ISO 8601 écrit `+02:00`.
Leçons associées
- Python · Leçon 31 · Intermédiaire · Version : 3
Sources
- Python 3.12 datetime documentation: datetime.replace()
- Python 3.12 datetime documentation: datetime.astimezone()
- Python 3.12 datetime documentation: timezone
- Python 3.12 datetime documentation: datetime.strftime()
- Python 3.12 datetime documentation: strftime() and strptime() Behavior
- Python 3.12 datetime documentation: datetime.isoformat()
- PEP 495 – Local Time Disambiguation