Clarified docs about ISO 8601 week numbering.

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
     <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,
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 <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::