CKTIS / Python
datetime.timedelta
Sumuje podane jednostki czasu i normalizuje wynik do dni, sekund w obrębie doby oraz mikrosekund w obrębie sekundy.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)Sumuje podane jednostki czasu i normalizuje wynik do dni, sekund w obrębie doby oraz mikrosekund w obrębie sekundy.
Łączne ułamkowe mikrosekundy są zaokrąglane do najbliższej liczby całkowitej, a remisy do parzystej: 0.5 i 1.5 µs dają 0 i 2 µs. Pole days musi mieścić się od -999999999 do 999999999, w przeciwnym razie powstaje OverflowError. Po normalizacji ujemne może być tylko pole days. Minus jedna sekunda daje days=-1 i seconds=86399.
Cały odstęp zwraca total_seconds() jako -1.0, podczas gdy seconds zawiera tylko resztę.
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
Przykłady
import datetime
d = datetime.timedelta(seconds=-1)
print(d.days, d.seconds)
print(d.total_seconds())
Wynik
-1 86399 -1.0
Cały odstęp zwraca total_seconds() jako -1.0, podczas gdy seconds zawiera tylko resztę.