From 8d8e6156a00e67fda1edc1bdb657097eaf5c1459 Mon Sep 17 00:00:00 2001 From: Vinay Sajip Date: Mon, 30 Aug 2010 18:10:03 +0000 Subject: Improved logging.Formatter date/time formatting documentation. --- Doc/library/logging.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst index f257643..e82be99 100644 --- a/Doc/library/logging.rst +++ b/Doc/library/logging.rst @@ -321,6 +321,14 @@ order:: "%(asctime)s - %(levelname)s - %(message)s" +Formatters use a user-configurable function to convert the creation time of a +record to a tuple. By default, :func:`time.localtime` is used; to change this +for a particular formatter instance, set the ``converter`` attribute of the +instance to a function with the same signature as :func:`time.localtime` or +:func:`time.gmtime`. To change it for all formatters, for example if you want +all logging times to be shown in GMT, set the ``converter`` attribute in the +Formatter class (to ``time.gmtime`` for GMT display). + Configuring Logging ^^^^^^^^^^^^^^^^^^^ -- cgit v0.12