Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
23cee80c
Commit
23cee80c
authored
Jun 01, 2018
by
Vinay Sajip
Committed by
GitHub
Jun 01, 2018
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
bpo-33400: Removed references to RFC3339 and ISO8601 from the logging documentation. (GH-7297)
parent
c0d341d4
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
12 additions
and
12 deletions
+12
-12
Doc/library/logging.config.rst
Doc/library/logging.config.rst
+4
-5
Doc/library/logging.rst
Doc/library/logging.rst
+8
-7
No files found.
Doc/library/logging.config.rst
View file @
23cee80c
...
...
@@ -790,11 +790,10 @@ Sections which specify formatter configuration are typified by the following.
The ``format`` entry is the overall format string, and the ``datefmt`` entry is
the :func:`strftime`\ -compatible date/time format string. If empty, the
package substitutes ISO8601-style format date/times, which is almost equivalent to
specifying the date format string ``'
%
Y
-%
m
-%
d
%
H
:%
M
:%
S
'``. This format also
specifies milliseconds, which are appended to the result of using the above
format string, with a comma separator. An example time in this format is
``2003-01-23 00:29:50,411``.
package substitutes something which is almost equivalent to specifying the date
format string ``'
%
Y
-%
m
-%
d
%
H
:%
M
:%
S
'``. This format also specifies milliseconds,
which are appended to the result of using the above format string, with a comma
separator. An example time in this format is ``2003-01-23 00:29:50,411``.
The ``class`` entry is optional. It indicates the name of the formatter'
s
class
(
as
a
dotted
module
and
class
name
.)
This
option
is
useful
for
instantiating
a
...
...
Doc/library/logging.rst
View file @
23cee80c
...
...
@@ -515,9 +515,8 @@ The useful mapping keys in a :class:`LogRecord` are given in the section on
Returns
a
new
instance
of
the
:
class
:`
Formatter
`
class
.
The
instance
is
initialized
with
a
format
string
for
the
message
as
a
whole
,
as
well
as
a
format
string
for
the
date
/
time
portion
of
a
message
.
If
no
*
fmt
*
is
specified
,
``
'%(message)s'
``
is
used
.
If
no
*
datefmt
*
is
specified
,
an
ISO8601
-
like
(
or
:
rfc
:`
3339
`-
like
)
date
format
is
used
.
See
the
:
meth
:`
formatTime
`
documentation
for
more
details
.
specified
,
``
'%(message)s'
``
is
used
.
If
no
*
datefmt
*
is
specified
,
a
format
is
used
which
is
described
in
the
:
meth
:`
formatTime
`
documentation
.
The
*
style
*
parameter
can
be
one
of
'%'
,
'{'
or
'$'
and
determines
how
the
format
string
will
be
merged
with
its
data
:
using
one
of
%-
formatting
,
...
...
@@ -557,8 +556,10 @@ The useful mapping keys in a :class:`LogRecord` are given in the section on
formatters to provide for any specific requirement, but the basic behavior
is as follows: if *datefmt* (a string) is specified, it is used with
:func:`time.strftime` to format the creation time of the
record. Otherwise, an ISO8601-like (or RDC 3339-like) format is used. The
resulting string is returned.
record. Otherwise, the format '
%
Y
-%
m
-%
d
%
H
:%
M
:%
S
,
uuu
' is used, where the
uuu part is a millisecond value and the other letters are as per the
:func:`time.strftime` documentation. An example time in this format is
``2003-01-23 00:29:50,411``. The resulting string is returned.
This function uses a user-configurable function to convert the creation
time to a tuple. By default, :func:`time.localtime` is used; to change
...
...
@@ -569,8 +570,8 @@ The useful mapping keys in a :class:`LogRecord` are given in the section on
attribute in the ``Formatter`` class.
.. versionchanged:: 3.3
Previously, the default
ISO8601-like format was hard-coded as in this
example:
``2010-09-06 22:38:15,292`` where the part before the comma is
Previously, the default
format was hard-coded as in this example:
``2010-09-06 22:38:15,292`` where the part before the comma is
handled by a strptime format string (``'
%
Y
-%
m
-%
d
%
H
:%
M
:%
S
'``), and the
part after the comma is a millisecond value. Because strptime does not
have a format placeholder for milliseconds, the millisecond value is
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment