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

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