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') -> strEn 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
- Python 3.12 datetime documentation — datetime.isoformat
- Python 3.12 datetime documentation — datetime.replace
- Python 3.12 datetime documentation — datetime.astimezone
- Python 3.12 datetime documentation — timezone Objects
- Python 3.12 datetime documentation — datetime.strftime
- Python 3.12 datetime documentation — strftime() and strptime() Behavior