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

CKTIS / Python

datetime.timedelta

Additionne les unités de durée fournies et normalise en jours, secondes dans la journée et microsecondes dans la seconde.

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

Syntaxe

datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)

Additionne les unités de durée fournies et normalise en jours, secondes dans la journée et microsecondes dans la seconde.

Le total des microsecondes fractionnaires est arrondi à l’entier le plus proche, pair en cas d’égalité: 0.5 et 1.5 µs donnent 0 et 2 µs. days doit rester entre -999999999 et 999999999, sinon OverflowError est levée. Après normalisation seul days peut être négatif. Moins une seconde donne days=-1 et seconds=86399.

total_seconds() renvoie la durée entière sous la forme -1.0, tandis que seconds contient le reste.

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

Exemples

import datetime
d = datetime.timedelta(seconds=-1)
print(d.days, d.seconds)
print(d.total_seconds())

Résultat

-1 86399
-1.0

total_seconds() renvoie la durée entière sous la forme -1.0, tandis que seconds contient le reste.

Sources