From: Georg Brandl Date: Sat, 31 Jul 2010 11:40:07 +0000 (+0000) Subject: #9430: document timedelta str() and repr(). X-Git-Tag: v3.2a1~2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f55c31594b9abb2ddb446d2d6206342a9258d205;p=python #9430: document timedelta str() and repr(). --- diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index f626e357c4..22c82e8127 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -265,6 +265,14 @@ Supported operations: | ``abs(t)`` | equivalent to +\ *t* when ``t.days >= 0``, and| | | to -*t* when ``t.days < 0``. (2) | +--------------------------------+-----------------------------------------------+ +| ``str(t)`` | Returns a string in the form | +| | ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D | +| | is negative for negative ``t``. (5) | ++--------------------------------+-----------------------------------------------+ +| ``repr(t)`` | Returns a string in the form | +| | ``datetime.timedelta(D[, S[, U]])``, where D | +| | is negative for negative ``t``. (5) | ++--------------------------------+-----------------------------------------------+ Notes: @@ -280,6 +288,16 @@ Notes: (4) -*timedelta.max* is not representable as a :class:`timedelta` object. +(5) + String representations of :class:`timedelta` objects are normalized + similarly to their internal representation. This leads to somewhat + unusual results for negative timedeltas. For example: + + >>> timedelta(hours=-5) + datetime.timedelta(-1, 68400) + >>> print(_) + -1 day, 19:00:00 + In addition to the operations listed above :class:`timedelta` objects support certain additions and subtractions with :class:`date` and :class:`datetime` objects (see below).