diff options
| author | ldwoolley <ldwoolley@gmail.com> | 2016-10-07 16:39:04 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2016-10-07 16:39:04 -0700 |
| commit | 41dcb1d13cb61b6e0816dd444c640a85059cc881 (patch) | |
| tree | c276a98610bfea754c13cde65b3a6834385ccfbd /docs | |
| parent | ead6ed984fee9019b94700068f553223ad30b012 (diff) | |
| download | babel-41dcb1d13cb61b6e0816dd444c640a85059cc881.tar.gz | |
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.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/dates.rst | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/dates.rst b/docs/dates.rst index 48fd58f..bb3398a 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. | +----------+--------+--------------------------------------------------------+ |