KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

datetime.datetime

Combineert datum en kloktijd met microseconderesolutie.

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

Syntax

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

Combineert datum en kloktijd met microseconderesolutie.

Bij het terugzetten van de klok in New York op 2024-11-03 betekent 01:30 met fold=0 05:30 UTC en met fold=1 06:30 UTC. Aftrekken met hetzelfde tzinfo-object negeert fold en geeft nul, na omzetting naar UTC is het verschil een uur. Het object heeft een effectieve tijdzone wanneer tzinfo een UTC-verschil anders dan None geeft. astimezone behoudt het tijdstip, terwijl replace(tzinfo=...) dezelfde velden een andere zone geeft.

Op 1 januari is 01:00 UTC gelijk aan 31 december 22:00 bij -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) leest velden volgens het formaat en date() geeft de datum. combine(datum, tijd) gebruikt standaard tzinfo van de tijd. replace maakt een nieuwe waarde met gewijzigde velden zonder zoneconversie en weigert ongeldige datums. strftime(fmt) volgt formaatrichtlijnen, isoformat() geeft hier ISO-tekst met tijdsverschil.

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

Voorbeelden

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)

Resultaat

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

Op 1 januari is 01:00 UTC gelijk aan 31 december 22:00 bij -03:00.

Bronnen