diff --git a/Doc/library/time.rst b/Doc/library/time.rst index 56ca865b9bb..879f8c7fd0c 100644 --- a/Doc/library/time.rst +++ b/Doc/library/time.rst @@ -136,6 +136,11 @@ The module defines the following functions and data items: :c:func:`QueryPerformanceCounter`. The resolution is typically better than one microsecond. + .. deprecated:: 3.3 + The behaviour of this function depends on the platform: use + :func:`perf_counter` or :func:`process_time` instead, depending on your + requirements, to have a well defined behaviour. + .. function:: clock_getres(clk_id) diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst index 3d63127bacf..c6708fedec0 100644 --- a/Doc/whatsnew/3.3.rst +++ b/Doc/whatsnew/3.3.rst @@ -1188,6 +1188,9 @@ Deprecated Python modules, functions and methods the ANSI code page anymore and to support any filename. * :issue:`13988`: The :mod:`xml.etree.cElementTree` module is deprecated. The accelerator is used automatically whenever available. +* The behaviour of :func:`time.clock` depends on the platform: use the new + :func:`time.perf_counter` or :func:`time.process_time` function instead, + depending on your requirements, to have a well defined behaviour. Deprecated functions and types of the C API diff --git a/Misc/NEWS b/Misc/NEWS index 995ec9e634e..3b5cbda26de 100644 --- a/Misc/NEWS +++ b/Misc/NEWS @@ -81,6 +81,9 @@ Core and Builtins Library ------- +- Issue #14309: Deprecate time.clock(), use time.perf_counter() or + time.process_time() instead. + - Issue #14428: Implement the PEP 418. Add time.get_clock_info(), time.perf_counter() and time.process_time() functions, and rename time.steady() to time.monotonic().