Skip to content

Commit

Permalink
bpo-45515: Add zoneinfo to the datetime documentation (GH-29038) (GH-…
Browse files Browse the repository at this point in the history
…29066)

We should have done this way back when 3.9 was released, but it fell off
the radar.

Co-authored-by: Paul Ganssle <git@m.ganssle.io>
(cherry picked from commit 8e40ca1)
  • Loading branch information
miss-islington committed Oct 19, 2021
1 parent cb34c1e commit 7657888
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 4 deletions.
10 changes: 6 additions & 4 deletions Doc/library/datetime.rst
Expand Up @@ -27,6 +27,9 @@ on efficient attribute extraction for output formatting and manipulation.
Module :mod:`time`
Time access and conversions.

Module :mod:`zoneinfo`
Concrete time zones representing the IANA time zone database.

Package `dateutil <https://dateutil.readthedocs.io/en/stable/>`_
Third-party library with expanded time zone and parsing support.

Expand Down Expand Up @@ -2174,14 +2177,13 @@ only EST (fixed offset -5 hours), or only EDT (fixed offset -4 hours)).

.. seealso::

`dateutil.tz <https://dateutil.readthedocs.io/en/stable/tz.html>`_
:mod:`zoneinfo`
The :mod:`datetime` module has a basic :class:`timezone` class (for
handling arbitrary fixed offsets from UTC) and its :attr:`timezone.utc`
attribute (a UTC timezone instance).

*dateutil.tz* library brings the *IANA timezone database*
(also known as the Olson database) to Python, and its usage is
recommended.
``zoneinfo`` brings the *IANA timezone database* (also known as the Olson
database) to Python, and its usage is recommended.

`IANA timezone database <https://www.iana.org/time-zones>`_
The Time Zone Database (often called tz, tzdata or zoneinfo) contains code
Expand Down
@@ -0,0 +1,3 @@
Add references to :mod:`zoneinfo` in the :mod:`datetime` documentation,
mostly replacing outdated references to ``dateutil.tz``. Change by Paul
Ganssle.

0 comments on commit 7657888

Please sign in to comment.