8000 gh-132642: Add documentation on how to render human-readable timedelta object by KentaroJay · Pull Request #133825 · python/cpython · GitHub
[go: up one dir, main page]
Skip to content

gh-132642: Add documentation on how to render human-readable timedelta object #133825

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 15 commits into from
May 10, 2025
Merged

gh-132642: Add documentation on how to render human-readable timedelta object #133825

Changes from 9 commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
d6cbc74
Fix doc
KentaroJay May 10, 2025
5f6dd02
Fix
KentaroJay May 10, 2025
b4cb1cd
Fix
KentaroJay May 10, 2025
2a69fe6
Update Doc/library/datetime.rst
KentaroJay May 10, 2025
0594cd5
Fix
KentaroJay May 10, 2025
bddce2d
Fix
KentaroJay May 10, 2025
a3ca8f0
Fix
KentaroJay May 10, 2025
278f291
Merge branch 'main' into fix-issue-132642
KentaroJay May 10, 2025
90815d7
Update Doc/library/datetime.rst
KentaroJay May 10, 2025
d5dea14
Update Doc/library/datetime.rst
KentaroJay May 10, 2025
118ef87
Update Doc/library/datetime.rst
KentaroJay May 10, 2025
32d3eaf
Added a test
KentaroJay May 10, 2025
ec5fab8
Fix
KentaroJay May 10, 2025
5f2ba13
Capitalize
KentaroJay May 10, 2025
f67ec7e
Update datetimetester.py
KentaroJay May 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions Doc/library/datetime.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -261,6 +261,22 @@ A :class:`timedelta` object represents a duration, the difference between two
>>> (d.days, d.seconds, d.microseconds)
(-1, 86399, 999999)

The string representation of :class:`!timedelta` objects can be confusing,
but the following recipe can be used to produce a more readable format:

.. code-block:: pycon

>>> def pretty_timedelta(td):
... if td.days >= 0:
... return str(td)
... return f'-({-td!s})'
...
>>> d = timedelta(hours=-1)
>>> str(d) # not human-friendly
'-1 day, 23:00:00'
>>> pretty_timedelta(d)
'-(1:00:00)'


Class attributes:

Expand Down
Loading
0