]> granicus.if.org Git - python/commit
Issue #22117: Add a new Python timestamp format _PyTime_t to pytime.h
authorVictor Stinner <victor.stinner@gmail.com>
Fri, 27 Mar 2015 12:31:18 +0000 (13:31 +0100)
committerVictor Stinner <victor.stinner@gmail.com>
Fri, 27 Mar 2015 12:31:18 +0000 (13:31 +0100)
commitcb29f0177c91ebb739b89d8cc4ba223785c94d61
tree986ec5f0229d996767a5c6492debb14f1507a522
parenta766ddfa2fa0934a3852d74b0630a7bd3c91958e
Issue #22117: Add a new Python timestamp format _PyTime_t to pytime.h

In practice, _PyTime_t is a number of nanoseconds. Its C type is a 64-bit
signed number. It's integer value is in the range [-2^63; 2^63-1]. In seconds,
the range is around [-292 years; +292 years]. In term of Epoch timestamp
(1970-01-01), it can store a date between 1677-09-21 and 2262-04-11.

The API has a resolution of 1 nanosecond and use integer number. With a
resolution on 1 nanosecond, 64-bit IEEE 754 floating point numbers loose
precision after 194 days. It's not the case with this API. The drawback is
overflow for values outside [-2^63; 2^63-1], but these values are unlikely for
most Python modules, except of the datetime module.

New functions:

- _PyTime_GetMonotonicClock()
- _PyTime_FromObject()
- _PyTime_AsMilliseconds()
- _PyTime_AsTimeval()

This change uses these new functions in time.sleep() to avoid rounding issues.

The new API will be extended step by step, and the old API will be removed step
by step. Currently, some code is duplicated just to be able to move
incrementally, instead of pushing a large change at once.
Include/pytime.h
Modules/timemodule.c
Python/pytime.c