From 41dcb1d13cb61b6e0816dd444c640a85059cc881 Mon Sep 17 00:00:00 2001 From: ldwoolley Date: Fri, 7 Oct 2016 16:39:04 -0700 Subject: [PATCH] Improve Date Fields descriptions for issue #419 Described recommendation to use "Y" with "w" for consistent results in ISO year-week and indicated possible surprising results for year rollover and total number of weeks in a year. --- docs/dates.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/dates.rst b/docs/dates.rst index 48fd58fd..bb3398ab 100644 --- a/docs/dates.rst +++ b/docs/dates.rst @@ -140,7 +140,10 @@ Date Fields | | | the padding, but for two letters it also specifies the | | | | maximum length. | | +--------+--------------------------------------------------------+ - | | ``Y`` | Same as ``y`` but uses the ISO year-week calendar. | + | | ``Y`` | Same as ``y`` but uses the ISO year-week calendar. ISO | + | | | year-week increments after completing the last week of | + | | | the year. Therefore it may change a few days before or | + | | | after ``y``. Recommend use with the ``w`` Symbol. | | +--------+--------------------------------------------------------+ | | ``u`` | ?? | +----------+--------+--------------------------------------------------------+ @@ -158,7 +161,9 @@ Date Fields | | | abbreviation, or four for the full name, or 5 for the | | | | narrow name. | +----------+--------+--------------------------------------------------------+ - | Week | ``w`` | Week of year. | + | Week | ``w`` | Week of year according to the ISO year-week calendar. | + | | | This may have 52 or 53 weeks depending on the year. | + | | | Recommend use with the ``Y`` symbol. | | +--------+--------------------------------------------------------+ | | ``W`` | Week of month. | +----------+--------+--------------------------------------------------------+ -- 2.47.2