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

CKTIS / Python

datetime.datetime

Combine date et heure avec une résolution d’une microseconde.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

Combine date et heure avec une résolution d’une microseconde.

Lors du recul de l’horloge à New York le 2024-11-03, 01:30 vaut 05:30 UTC avec fold=0 et 06:30 UTC avec fold=1. Soustraire avec le même objet tzinfo ignore fold et donne zéro, après conversion en UTC la différence est d’une heure. L’objet tient compte du fuseau si tzinfo fournit un décalage UTC différent de None. astimezone conserve l’instant, replace(tzinfo=...) change le fuseau associé aux mêmes champs.

Le 1er janvier à 01:00 UTC correspond au 31 décembre à 22:00 avec le décalage -03:00.

from datetime import datetime, timedelta, timezone
stamp = datetime(2025, 1, 1, 1, tzinfo=timezone.utc)
zone = timezone(timedelta(hours=-3))
local = stamp.astimezone(zone)
assert local.isoformat() == "2024-12-31T22:00:00-03:00" and local == stamp
assert stamp.replace(tzinfo=zone) != stamp
from datetime import tzinfo
class RepeatedHour(tzinfo):
    def utcoffset(self, dt): return timedelta(hours=-4-dt.fold)
    def dst(self, dt): return timedelta(hours=1-dt.fold)
z = RepeatedHour()
a = datetime(2024,11,3,1,30,tzinfo=z)
b = a.replace(fold=1)
assert b-a == timedelta(0)
assert (a.astimezone(timezone.utc).hour, b.astimezone(timezone.utc).hour) == (5,6)
assert b.astimezone(timezone.utc)-a.astimezone(timezone.utc) == timedelta(hours=1)

datetime.datetime.strptime · datetime.datetime.date · datetime.datetime.combine · datetime.datetime.replace · datetime.datetime.strftime · datetime.datetime.isoformat

strptime(text, fmt) lit les champs selon le format et date() extrait la date. combine(date, heure) utilise par défaut le tzinfo de l’heure. replace crée une valeur aux champs modifiés sans convertir de fuseau et rejette une date invalide. strftime(fmt) suit les directives, isoformat() produit ici un texte ISO avec décalage.

from datetime import datetime,time,timezone
d=datetime.strptime('2024-02-29','%Y-%m-%d')
t=time(8,30,tzinfo=timezone.utc)
combined=datetime.combine(d.date(),t)
later=combined.replace(hour=9)
assert combined.hour==8 and later.strftime('%Y/%m/%d %H:%M')=='2024/02/29 09:30'
assert later.isoformat()=='2024-02-29T09:30:00+00:00'
try: d.replace(year=2023)
except ValueError: pass
else: raise AssertionError

Exemples

import datetime
utc = datetime.timezone.utc
t = datetime.datetime(2025, 1, 1, 1, tzinfo=utc)
local = t.astimezone(datetime.timezone(datetime.timedelta(hours=-3)))
print(local.isoformat())
print(local == t)

Résultat

2024-12-31T22:00:00-03:00
True

Le 1er janvier à 01:00 UTC correspond au 31 décembre à 22:00 avec le décalage -03:00.

Sources