CKTIS / Python
datetime.timedelta
Telt de opgegeven tijdseenheden op en normaliseert naar dagen, seconden binnen de dag en microseconden binnen de seconde.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)Telt de opgegeven tijdseenheden op en normaliseert naar dagen, seconden binnen de dag en microseconden binnen de seconde.
Het totaal aan fractionele microseconden wordt naar het dichtstbijzijnde gehele getal afgerond en bij gelijke afstand naar even: 0.5 en 1.5 µs geven 0 en 2 µs. days moet tussen -999999999 en 999999999 liggen, anders volgt OverflowError. Na normalisatie kan alleen days negatief zijn. Min één seconde geeft days=-1 en seconds=86399.
total_seconds() levert de hele duur als -1.0, terwijl seconds alleen de rest bevat.
from datetime import timedelta
d = timedelta(microseconds=-1)
assert (d.days, d.seconds, d.microseconds) == (-1, 86399, 999999)
assert d == timedelta(days=-1, microseconds=86_399_999_999)
assert timedelta(hours=36).total_seconds() == 129600.0
assert [timedelta(microseconds=n).microseconds for n in [0.5, 1.5]] == [0, 2]
assert timedelta.min.days == -999999999 and timedelta.max.days == 999999999
try:
timedelta(days=1000000000)
except OverflowError:
pass
else:
raise AssertionError
Voorbeelden
import datetime
d = datetime.timedelta(seconds=-1)
print(d.days, d.seconds)
print(d.total_seconds())
Resultaat
-1 86399 -1.0
total_seconds() levert de hele duur als -1.0, terwijl seconds alleen de rest bevat.