mirrors
/
django
mirror of https://github.com/django/django.git
1
0
Fork 0
Code Issues 24 Releases Wiki Activity

Clarified docs about ISO 8601 week numbering.

This commit is contained in:
Alasdair Nicol 2018-03-22 00:00:39 +00:00 committed by Tim Graham
parent 9aca67bea8
commit 0c100f8b57
2 changed files with 5 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/ref/models/database-functions.txt
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,

2
docs/ref/models/querysets.txt
View File

@ -2888,7 +2888,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::