Skip to content

Commit 305588c

Browse files
authored
bpo-20281, bpo-29964: update datetime docs to refer %z and %Z to a pre-existing footnote (GH-30354)
1 parent e674e48 commit 305588c

File tree

1 file changed

+6
-7
lines changed

1 file changed

+6
-7
lines changed

Doc/library/time.rst

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -476,10 +476,10 @@ Functions
476476
| | negative time difference from UTC/GMT of the | |
477477
| | form +HHMM or -HHMM, where H represents decimal| |
478478
| | hour digits and M represents decimal minute | |
479-
| | digits [-23:59, +23:59]. | |
479+
| | digits [-23:59, +23:59]. [1]_ | |
480480
+-----------+------------------------------------------------+-------+
481481
| ``%Z`` | Time zone name (no characters if no time zone | |
482-
| | exists). | |
482+
| | exists). Deprecated. [1]_ | |
483483
+-----------+------------------------------------------------+-------+
484484
| ``%%`` | A literal ``'%'`` character. | |
485485
+-----------+------------------------------------------------+-------+
@@ -500,7 +500,7 @@ Functions
500500
calculations when the day of the week and the year are specified.
501501

502502
Here is an example, a format for dates compatible with that specified in the
503-
:rfc:`2822` Internet email standard. [#]_ ::
503+
:rfc:`2822` Internet email standard. [1]_ ::
504504

505505
>>> from time import gmtime, strftime
506506
>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())
@@ -928,10 +928,9 @@ Timezone Constants
928928

929929
.. rubric:: Footnotes
930930

931-
.. [#] The use of ``%Z`` is now deprecated, but the ``%z`` escape that expands to the
932-
preferred hour/minute offset is not supported by all ANSI C libraries. Also, a
931+
.. [1] The use of ``%Z`` is now deprecated, but the ``%z`` escape that expands to the
932+
preferred hour/minute offset is not supported by all ANSI C libraries. Also, a
933933
strict reading of the original 1982 :rfc:`822` standard calls for a two-digit
934-
year (%y rather than %Y), but practice moved to 4-digit years long before the
934+
year (``%y`` rather than ``%Y``), but practice moved to 4-digit years long before the
935935
year 2000. After that, :rfc:`822` became obsolete and the 4-digit year has
936936
been first recommended by :rfc:`1123` and then mandated by :rfc:`2822`.
937-

0 commit comments

Comments
 (0)