File tree Expand file tree Collapse file tree 1 file changed +9
-8
lines changed
Expand file tree Collapse file tree 1 file changed +9
-8
lines changed Original file line number Diff line number Diff line change @@ -161,14 +161,15 @@ The following exceptions are used mostly as base classes for other exceptions.
161161
162162 .. attribute :: __timestamp_ns__
163163
164- The time at which the exception instance was instantiated (usually when
165- it was raised) in nanoseconds in :func: `time.time_ns ` units. Display of
166- this in tracebacks can be controlled using the
167- :envvar: `PYTHON_TRACEBACK_TIMESTAMPS ` environment variable. In
168- applications with complicated exception chains and exception groups it be
169- used to help visualize what happened when. The value will be 0 if a time
170- was not recorded as is the case on :exc: `StopIteration ` and
171- :exc: `StopAsyncIteration `.
164+ The absolute time in nanoseconds at which the exception was instantiated
165+ (usually: when it was raised); as accurate as :func: `time.time_ns `.
166+ Display of this in tracebacks is off by default but can be controlled
167+ using the :envvar: `PYTHON_TRACEBACK_TIMESTAMPS ` environment variable. In
168+ applications with complicated exception chains and exception groups it
169+ may be useful to help understand what happened when. The value will be
170+ ``0 `` if a timestamp was not recorded. :exc: `StopIteration ` and
171+ :exc: `StopAsyncIteration ` never record timestamps as those are primarily
172+ for control flow.
172173
173174 .. versionadded :: next
174175
You can’t perform that action at this time.
0 commit comments