p15693087
/
django
1
0
Fork 0
Code Issues Pull Requests Projects 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 The ``week`` ``lookup_type`` is calculated based on `ISO-8601
<https://en.wikipedia.org/wiki/ISO-8601>`_, i.e., <https://en.wikipedia.org/wiki/ISO-8601>`_, i.e.,
a week starts on a Monday. The first week is the one with the majority a week starts on a Monday. The first week of a year is the one that
of the days, i.e., a week that starts on or before Thursday. The value contains the year's first Thursday, i.e. the first week has the majority
returned is in the range 1 to 52 or 53. (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 Each ``lookup_name`` above has a corresponding ``Extract`` subclass (listed
below) that should typically be used instead of the more verbose equivalent, 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 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 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:: Example::