diff options
author | Alexander Belopolsky <abalkin@users.noreply.github.com> | 2017-10-26 19:34:11 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2017-10-26 19:34:11 (GMT) |
commit | 66c88ce30ca2b23daa37038e1a3c0de98f241f50 (patch) | |
tree | 91e0dcb60059c3025fef3ea4e2dcb849f25b103f /Doc | |
parent | 52ad72dd0a5a56414cc29b7c9b03259169825f35 (diff) | |
download | cpython-66c88ce30ca2b23daa37038e1a3c0de98f241f50.zip cpython-66c88ce30ca2b23daa37038e1a3c0de98f241f50.tar.gz cpython-66c88ce30ca2b23daa37038e1a3c0de98f241f50.tar.bz2 |
Closes bpo-28281: Remove year (1-9999) limits on the weekday() function. (#4109)
Patch by Mark Gollahon.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/calendar.rst | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/Doc/library/calendar.rst b/Doc/library/calendar.rst index 8fe93fd..56b75ef 100644 --- a/Doc/library/calendar.rst +++ b/Doc/library/calendar.rst @@ -19,11 +19,13 @@ the week to Sunday (6) or to any other weekday. Parameters that specify dates are given as integers. For related functionality, see also the :mod:`datetime` and :mod:`time` modules. -Most of these functions and classes rely on the :mod:`datetime` module which -uses an idealized calendar, the current Gregorian calendar extended +The functions and classes defined in this module +use an idealized calendar, the current Gregorian calendar extended indefinitely in both directions. This matches the definition of the "proleptic Gregorian" calendar in Dershowitz and Reingold's book "Calendrical Calculations", where -it's the base calendar for all computations. +it's the base calendar for all computations. Zero and negative years are +interpreted as prescribed by the ISO 8601 standard. Year 0 is 1 BC, year -1 is +2 BC, and so on. .. class:: Calendar(firstweekday=0) |