summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorAlexander Belopolsky <abalkin@users.noreply.github.com>2017-10-26 19:34:11 (GMT)
committerGitHub <noreply@github.com>2017-10-26 19:34:11 (GMT)
commit66c88ce30ca2b23daa37038e1a3c0de98f241f50 (patch)
tree91e0dcb60059c3025fef3ea4e2dcb849f25b103f /Doc
parent52ad72dd0a5a56414cc29b7c9b03259169825f35 (diff)
downloadcpython-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.rst8
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)