https://github.com/python/cpython/commit/c3bcc927061e5ed058580b8092bbb6564897fcaa commit: c3bcc927061e5ed058580b8092bbb6564897fcaa branch: main author: Nakum Milan <[email protected]> committer: StanFromIreland <[email protected]> date: 2026-10-22T06:51:02Z summary:
gh-160035: Simplify datetime awareness docs (#160086) Co-authored-by: Stan Ulbrych <[email protected]> files: M Doc/library/datetime.rst diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst index af904a05a47f06..2598ab40b23da7 100644 --- a/Doc/library/datetime.rst +++ b/Doc/library/datetime.rst @@ -180,18 +180,12 @@ Objects of the :class:`date` type are always naive. An object of type :class:`.time` or :class:`.datetime` may be aware or naive. -A :class:`.datetime` object ``d`` is aware if both of the following hold: - -1. ``d.tzinfo`` is not ``None`` -2. ``d.tzinfo.utcoffset(d)`` does not return ``None`` - +A :class:`.datetime` object ``d`` is aware if +:meth:`d.utcoffset() <datetime.utcoffset>` does not return ``None``. Otherwise, ``d`` is naive. -A :class:`.time` object ``t`` is aware if both of the following hold: - -1. ``t.tzinfo`` is not ``None`` -2. ``t.tzinfo.utcoffset(None)`` does not return ``None``. - +A :class:`.time` object ``t`` is aware if +:meth:`t.utcoffset() <time.utcoffset>` does not return ``None``. Otherwise, ``t`` is naive. The distinction between aware and naive doesn't apply to :class:`timedelta` _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
