From 2d32bf1ef23c9e468b2e8afab3c24e7a2047ac36 Mon Sep 17 00:00:00 2001 From: Harmandeep Singh Date: Thu, 12 Sep 2019 15:52:30 +0530 Subject: [PATCH] bpo-13927: time.ctime and time.asctime return string explantion (GH-11303) * bpo-13927: time.ctime and time.asctime return string explantion * Add note explaining that time.ctime and time.asctime returns a space padded date value in case it contains a single digit date * Reformat linebreaks --- Doc/library/time.rst | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/Doc/library/time.rst b/Doc/library/time.rst index 4faa0bbebc..65ab679669 100644 --- a/Doc/library/time.rst +++ b/Doc/library/time.rst @@ -127,9 +127,12 @@ Functions Convert a tuple or :class:`struct_time` representing a time as returned by :func:`gmtime` or :func:`localtime` to a string of the following - form: ``'Sun Jun 20 23:21:05 1993'``. If *t* is not provided, the current time - as returned by :func:`localtime` is used. Locale information is not used by - :func:`asctime`. + form: ``'Sun Jun 20 23:21:05 1993'``. The day field is two characters long + and is space padded if the day is a single digit, + e.g.: ``'Wed Jun 9 04:26:40 1993'``. + + If *t* is not provided, the current time as returned by :func:`localtime` + is used. Locale information is not used by :func:`asctime`. .. note:: @@ -203,10 +206,15 @@ Functions .. function:: ctime([secs]) - Convert a time expressed in seconds since the epoch to a string representing - local time. If *secs* is not provided or :const:`None`, the current time as - returned by :func:`.time` is used. ``ctime(secs)`` is equivalent to - ``asctime(localtime(secs))``. Locale information is not used by :func:`ctime`. + Convert a time expressed in seconds since the epoch to a string of a form: + ``'Sun Jun 20 23:21:05 1993'`` representing local time. The day field + is two characters long and is space padded if the day is a single digit, + e.g.: ``'Wed Jun 9 04:26:40 1993'``. + + If *secs* is not provided or :const:`None`, the current time as + returned by :func:`.time` is used. ``ctime(secs)`` is equivalent to + ``asctime(localtime(secs))``. Locale information is not used by + :func:`ctime`. .. function:: get_clock_info(name) -- 2.40.0