[2.0.x] Clarified docs about ISO 8601 week numbering.

Backport of 0c100f8b57 from master
This commit is contained in:
Alasdair Nicol 2018-03-22 00:00:39 +00:00 committed by Tim Graham
parent 83362cb94a
commit 7f7bb1d1f4
2 changed files with 5 additions and 4 deletions

View File

@ -221,9 +221,10 @@ returned when this timezone is active will be the same as above except for:
The ``week`` ``lookup_type`` is calculated based on `ISO-8601
<https://en.wikipedia.org/wiki/ISO-8601>`_, i.e.,
a week starts on a Monday. The first week is the one with the majority
of the days, i.e., a week that starts on or before Thursday. The value
returned is in the range 1 to 52 or 53.
a week starts on a Monday. The first week of a year is the one that
contains the year's first Thursday, i.e. the first week has the majority
(four or more) of its days in the year. The value returned is in the range
1 to 52 or 53.
Each ``lookup_name`` above has a corresponding ``Extract`` subclass (listed
below) that should typically be used instead of the more verbose equivalent,

View File

@ -2884,7 +2884,7 @@ in the database <database-time-zone-definitions>`.
For date and datetime fields, return the week number (1-52 or 53) according
to `ISO-8601 <https://en.wikipedia.org/wiki/ISO-8601>`_, i.e., weeks start
on a Monday and the first week starts on or before Thursday.
on a Monday and the first week contains the year's first Thursday.
Example::