Issue 9430: Document str() and repr() of timedelta. (original) (raw)

Issue9430

Created on 2010-07-30 18:57 by belopolsky, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (6)
msg112096 - (view)	Author: Alexander Belopolsky (belopolsky) *	Date: 2010-07-30 18:57
Attaching a tentative patch. I think it is better to document these as operations rather than special methods. It may need to be clarified that "-2 days, 0:00:22" is timedelta(-2, 22) rather than -timedelta(2, 22), but I cannot come up with anything short enough for the ops table. Maybe this should be done in a footnote.
msg112097 - (view)	Author: Ezio Melotti (ezio.melotti) *	Date: 2010-07-30 19:18
Adding a footnote with an example sounds like a good idea. There's an odd number of square brackets in the str(t) description.
msg112110 - (view)	Author: Alexander Belopolsky (belopolsky) *	Date: 2010-07-31 00:37
First revision: .diff
msg112133 - (view)	Author: Eric V. Smith (eric.smith) *	Date: 2010-07-31 11:25
I think it would be clearer if the footnote said something like "Negative 1 day plus 19 hours is equivalent to the timedelta argument of -5 hours)". If I hadn't been following the discussion on #python-dev the point of this doc change would have been lost on me without much closer scrutiny, so a little more explanation would help.
msg112138 - (view)	Author: Antoine Pitrou (pitrou) *	Date: 2010-07-31 11:36
Looks good to me.
msg112141 - (view)	Author: Georg Brandl (georg.brandl) *	Date: 2010-07-31 11:40
Committed in r83341.