From: Georg Brandl Date: Fri, 27 Feb 2009 16:59:03 +0000 (+0000) Subject: #5365: add quick look conversion table for different time representations. X-Git-Tag: v2.7a1~1929 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=5c189b16a8e915889b26d0fecc45faec935092c4;p=python #5365: add quick look conversion table for different time representations. --- diff --git a/Doc/library/time.rst b/Doc/library/time.rst index c9b7355316..1ffef2b244 100644 --- a/Doc/library/time.rst +++ b/Doc/library/time.rst @@ -118,6 +118,24 @@ An explanation of some terminology and conventions is in order. The time value sequence was changed from a tuple to a :class:`struct_time`, with the addition of attribute names for the fields. +* Use the following functions to convert between time representations: + + +-------------------------+-------------------------+-------------------------+ + | From | To | Use | + +=========================+=========================+=========================+ + | seconds since the epoch | :class:`struct_time` in | :func:`gmtime` | + | | UTC | | + +-------------------------+-------------------------+-------------------------+ + | seconds since the epoch | :class:`struct_time` in | :func:`localtime` | + | | local time | | + +-------------------------+-------------------------+-------------------------+ + | :class:`struct_time` in | seconds since the epoch | :func:`calendar.timegm` | + | UTC | | | + +-------------------------+-------------------------+-------------------------+ + | :class:`struct_time` in | seconds since the epoch | :func:`mktime` | + | local time | | | + +-------------------------+-------------------------+-------------------------+ + The module defines the following functions and data items: