diff options
| author | Paul Ganssle <1377457+pganssle@users.noreply.github.com> | 2021-10-19 18:09:41 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-19 18:09:41 (GMT) |
| commit | 8e40ca127fa92d6113617c80710e0a077977a84d (patch) | |
| tree | d25d807f54779b6eee9e9b0fd81ac3f2029896ad | |
| parent | 6e35b096ac07288a2e23909bb39f3a18c0c83951 (diff) | |
| download | cpython-8e40ca127fa92d6113617c80710e0a077977a84d.zip cpython-8e40ca127fa92d6113617c80710e0a077977a84d.tar.gz cpython-8e40ca127fa92d6113617c80710e0a077977a84d.tar.bz2 | |
Add zoneinfo to the datetime documentation (GH-29038)
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>
| -rw-r--r-- | Doc/library/datetime.rst | 10 | ||||
| -rw-r--r-- | Misc/NEWS.d/next/Library/2021-10-18-14-52-48.bpo-45515.aXdvm_.rst | 3 |
2 files changed, 9 insertions, 4 deletions
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index 196aa84..0f8b70c 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -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. @@ -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 diff --git a/Misc/NEWS.d/next/Library/2021-10-18-14-52-48.bpo-45515.aXdvm_.rst b/Misc/NEWS.d/next/Library/2021-10-18-14-52-48.bpo-45515.aXdvm_.rst new file mode 100644 index 0000000..382733f --- /dev/null +++ b/Misc/NEWS.d/next/Library/2021-10-18-14-52-48.bpo-45515.aXdvm_.rst @@ -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. |