From 0c100f8b57213dc41e23a280ca14f155eea576db Mon Sep 17 00:00:00 2001 From: Alasdair Nicol Date: Thu, 22 Mar 2018 00:00:39 +0000 Subject: [PATCH] Clarified docs about ISO 8601 week numbering. --- docs/ref/models/database-functions.txt | 7 ++++--- docs/ref/models/querysets.txt | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/ref/models/database-functions.txt b/docs/ref/models/database-functions.txt index 2d0d5d2fe7..bbc7683ccf 100644 --- a/docs/ref/models/database-functions.txt +++ b/docs/ref/models/database-functions.txt @@ -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 `_, 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, diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt index f2abf1c8df..b9a1eb5e83 100644 --- a/docs/ref/models/querysets.txt +++ b/docs/ref/models/querysets.txt @@ -2888,7 +2888,7 @@ in the database `. For date and datetime fields, return the week number (1-52 or 53) according to `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::