diff options
author | Alexander Belopolsky <alexander.belopolsky@gmail.com> | 2012-10-02 22:39:16 (GMT) |
---|---|---|
committer | Alexander Belopolsky <alexander.belopolsky@gmail.com> | 2012-10-02 22:39:16 (GMT) |
commit | cf77454908b7f762b1436ce0260bea16ea7c478b (patch) | |
tree | 6515ff351b2b96e8f7b4caf3580d01acd339bda4 /Modules/timemodule.c | |
parent | 8155ff4dc0d5194aa491b217e722eb23d2f85331 (diff) | |
download | cpython-cf77454908b7f762b1436ce0260bea16ea7c478b.zip cpython-cf77454908b7f762b1436ce0260bea16ea7c478b.tar.gz cpython-cf77454908b7f762b1436ce0260bea16ea7c478b.tar.bz2 |
Issue #9650: List commonly used format codes in time.strftime and time.strptime docsttings.
Diffstat (limited to 'Modules/timemodule.c')
-rw-r--r-- | Modules/timemodule.c | 28 |
1 files changed, 25 insertions, 3 deletions
diff --git a/Modules/timemodule.c b/Modules/timemodule.c index 161407d..3b1f075 100644 --- a/Modules/timemodule.c +++ b/Modules/timemodule.c @@ -539,6 +539,26 @@ checktm(struct tm* buf) /* wcsftime() doesn't format correctly time zones, see issue #10653 */ # undef HAVE_WCSFTIME #endif +#define STRFTIME_FORMAT_CODES \ +"Commonly used format codes:\n\ +\n\ +%Y Year with century as a decimal number.\n\ +%m Month as a decimal number [01,12].\n\ +%d Day of the month as a decimal number [01,31].\n\ +%H Hour (24-hour clock) as a decimal number [00,23].\n\ +%M Minute as a decimal number [00,59].\n\ +%S Second as a decimal number [00,61].\n\ +%z Time zone offset from UTC.\n\ +%a Locale's abbreviated weekday name.\n\ +%A Locale's full weekday name.\n\ +%b Locale's abbreviated month name.\n\ +%B Locale's full month name.\n\ +%c Locale's appropriate date and time representation.\n\ +%I Hour (12-hour clock) as a decimal number [01,12].\n\ +%p Locale's equivalent of either AM or PM.\n\ +\n\ +Other codes may be available on your platform. See documentation for\n\ +the C library strftime function.\n" #ifdef HAVE_STRFTIME #ifdef HAVE_WCSFTIME @@ -683,13 +703,13 @@ time_strftime(PyObject *self, PyObject *args) #undef time_char #undef format_time - PyDoc_STRVAR(strftime_doc, "strftime(format[, tuple]) -> string\n\ \n\ Convert a time tuple to a string according to a format specification.\n\ See the library reference manual for formatting codes. When the time tuple\n\ -is not present, current time as returned by localtime() is used."); +is not present, current time as returned by localtime() is used.\n\ +\n" STRFTIME_FORMAT_CODES); #endif /* HAVE_STRFTIME */ static PyObject * @@ -712,7 +732,9 @@ PyDoc_STRVAR(strptime_doc, "strptime(string, format) -> struct_time\n\ \n\ Parse a string to a time tuple according to a format specification.\n\ -See the library reference manual for formatting codes (same as strftime())."); +See the library reference manual for formatting codes (same as\n\ +strftime()).\n\ +\n" STRFTIME_FORMAT_CODES); static PyObject * _asctime(struct tm *timeptr) |