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

CKTIS / Python

Décalage UTC fixe et formatage avec `strftime` et `isoformat`

Associez un décalage UTC fixe sans modifier l’heure affichée, puis représentez la même date et la même heure dans un format personnalisé et au format ISO 8601.

Version : Python 3.12

Syntaxe

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

En Python 3.12, dt.replace(tzinfo=tz) renvoie un nouvel objet datetime.datetime dont tzinfo est renseigné, sans modifier la date ni l’heure affichée. Utilisez cette méthode si vous savez que l’heure locale enregistrée correspond à ce décalage. timezone(timedelta(...)) représente un décalage fixe par rapport à UTC, pas un fuseau qui applique des règles d’heure d’été.

Associer un décalage ne revient pas à convertir l’heure. Pour un objet datetime conscient du fuseau horaire (en anglais aware), dt.astimezone(tz) conserve le même instant et ajuste au besoin la date et l’heure au fuseau cible. Remplacer tzinfo par un décalage différent conserve l’heure affichée, mais change l’instant représenté.

dt.strftime(format) renvoie une chaîne qui suit le motif fourni. Dans l’exemple, %d/%m/%Y %H:%M:%S %z place le jour avant le mois, omet les fractions de seconde et écrit le décalage sous la forme +0530. Pour un objet naïf (en anglais naive), %z produit une chaîne vide. La prise en charge de certaines directives varie selon la plateforme, et les noms des mois dépendent des paramètres régionaux.

dt.isoformat() renvoie la date et l’heure sous forme de chaîne et ajoute le décalage si utcoffset() ne renvoie pas None. sep est le caractère qui sépare la date de l’heure, par défaut 'T'. Le résultat n’est pas toujours conforme à la norme ISO 8601 : sep peut être un caractère non autorisé par la norme et, même avec le séparateur par défaut, le décalage UTC peut contenir des secondes ou des fractions de seconde, que la norme n’autorise pas dans les décalages. Avec timespec='auto', les secondes sont affichées et six chiffres fractionnaires sont ajoutés uniquement si les microsecondes sont non nulles. Un format plus court, comme timespec='milliseconds', tronque sans arrondir ; une valeur timespec invalide déclenche ValueError. Aucune des deux méthodes de formatage ne modifie l’objet.

Exemples

from datetime import datetime, timedelta, timezone

wall_time = datetime(2025, 3, 29, 14, 5, 6, 987654)
fixed_offset = timezone(timedelta(hours=5, minutes=30))
annotated = wall_time.replace(tzinfo=fixed_offset)

print(annotated.strftime('%d/%m/%Y %H:%M:%S %z'))
print(annotated.isoformat(timespec='milliseconds'))

Résultat

29/03/2025 14:05:06 +0530
2025-03-29T14:05:06.987+05:30

Après l’ajout de `+05:30`, l’heure affichée reste `14:05:06`. La première ligne suit le format personnalisé avec `+0530`, et la seconde le format ISO avec `+05:30` et la fraction `.987`.

Leçons associées

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

Sources