#9430: document timedelta str() and repr().
This commit is contained in:
parent
a02607ea36
commit
f55c31594b
|
@ -265,6 +265,14 @@ Supported operations:
|
||||||
| ``abs(t)`` | equivalent to +\ *t* when ``t.days >= 0``, and|
|
| ``abs(t)`` | equivalent to +\ *t* when ``t.days >= 0``, and|
|
||||||
| | to -*t* when ``t.days < 0``. (2) |
|
| | 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:
|
Notes:
|
||||||
|
|
||||||
|
@ -280,6 +288,16 @@ Notes:
|
||||||
(4)
|
(4)
|
||||||
-*timedelta.max* is not representable as a :class:`timedelta` object.
|
-*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
|
In addition to the operations listed above :class:`timedelta` objects support
|
||||||
certain additions and subtractions with :class:`date` and :class:`datetime`
|
certain additions and subtractions with :class:`date` and :class:`datetime`
|
||||||
objects (see below).
|
objects (see below).
|
||||||
|
|
Loading…
Reference in New Issue