]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-89762: Document strftime %G, %V, and %u format specifiers (#124572)
authorRUANG (James Roy) <longjinyii@outlook.com>
Mon, 28 Oct 2024 21:53:18 +0000 (05:53 +0800)
committerGitHub <noreply@github.com>
Mon, 28 Oct 2024 21:53:18 +0000 (21:53 +0000)
Doc/library/time.rst

index a0bf13fc0a357705b3737889de4c12404e7b3187..8e29e57d00f9b2be9df08469d749e34e95eb9aeb 100644 (file)
@@ -483,6 +483,9 @@ Functions
    |           |                                                |       |
    |           |                                                |       |
    +-----------+------------------------------------------------+-------+
+   | ``%u``    | Day of the week (Monday is 1; Sunday is 7)     |       |
+   |           | as a decimal number [1, 7].                    |       |
+   +-----------+------------------------------------------------+-------+
    | ``%w``    | Weekday as a decimal number [0(Sunday),6].     |       |
    |           |                                                |       |
    +-----------+------------------------------------------------+-------+
@@ -515,6 +518,16 @@ Functions
    | ``%Z``    | Time zone name (no characters if no time zone  |       |
    |           | exists). Deprecated. [1]_                      |       |
    +-----------+------------------------------------------------+-------+
+   | ``%G``    | ISO 8601 year (similar to ``%Y`` but follows   |       |
+   |           | the rules for the ISO 8601 calendar year).     |       |
+   |           | The year starts with the week that contains    |       |
+   |           | the first Thursday of the calendar year.       |       |
+   +-----------+------------------------------------------------+-------+
+   | ``%V``    | ISO 8601 week number (as a decimal number      |       |
+   |           | [01,53]). The first week of the year is the    |       |
+   |           | one that contains the first Thursday of the    |       |
+   |           | year. Weeks start on Monday.                   |       |
+   +-----------+------------------------------------------------+-------+
    | ``%%``    | A literal ``'%'`` character.                   |       |
    +-----------+------------------------------------------------+-------+