mirror of
https://github.com/python/cpython.git
synced 2024-11-27 11:55:13 +08:00
b26a9b10ea
for better WinRT compatibility.
1596 lines
45 KiB
C
1596 lines
45 KiB
C
/* Time module */
|
|
|
|
#include "Python.h"
|
|
|
|
#include <ctype.h>
|
|
|
|
#ifdef HAVE_SYS_TIMES_H
|
|
#include <sys/times.h>
|
|
#endif
|
|
|
|
#ifdef HAVE_SYS_TYPES_H
|
|
#include <sys/types.h>
|
|
#endif
|
|
|
|
#if defined(HAVE_SYS_RESOURCE_H)
|
|
#include <sys/resource.h>
|
|
#endif
|
|
|
|
#ifdef QUICKWIN
|
|
#include <io.h>
|
|
#endif
|
|
|
|
#if defined(__WATCOMC__) && !defined(__QNX__)
|
|
#include <i86.h>
|
|
#else
|
|
#ifdef MS_WINDOWS
|
|
#define WIN32_LEAN_AND_MEAN
|
|
#include <windows.h>
|
|
#include "pythread.h"
|
|
|
|
#if defined(__BORLANDC__)
|
|
/* These overrides not needed for Win32 */
|
|
#define timezone _timezone
|
|
#define tzname _tzname
|
|
#define daylight _daylight
|
|
#endif /* __BORLANDC__ */
|
|
#endif /* MS_WINDOWS */
|
|
#endif /* !__WATCOMC__ || __QNX__ */
|
|
|
|
#if defined(__APPLE__)
|
|
#include <mach/mach_time.h>
|
|
#endif
|
|
|
|
/* Forward declarations */
|
|
static int floatsleep(double);
|
|
static PyObject* floattime(_Py_clock_info_t *info);
|
|
|
|
#ifdef MS_WINDOWS
|
|
static OSVERSIONINFOEX winver;
|
|
#endif
|
|
|
|
static PyObject *
|
|
time_time(PyObject *self, PyObject *unused)
|
|
{
|
|
return floattime(NULL);
|
|
}
|
|
|
|
PyDoc_STRVAR(time_doc,
|
|
"time() -> floating point number\n\
|
|
\n\
|
|
Return the current time in seconds since the Epoch.\n\
|
|
Fractions of a second may be present if the system clock provides them.");
|
|
|
|
#if defined(HAVE_CLOCK)
|
|
|
|
#ifndef CLOCKS_PER_SEC
|
|
#ifdef CLK_TCK
|
|
#define CLOCKS_PER_SEC CLK_TCK
|
|
#else
|
|
#define CLOCKS_PER_SEC 1000000
|
|
#endif
|
|
#endif
|
|
|
|
static PyObject *
|
|
floatclock(_Py_clock_info_t *info)
|
|
{
|
|
clock_t value;
|
|
value = clock();
|
|
if (value == (clock_t)-1) {
|
|
PyErr_SetString(PyExc_RuntimeError,
|
|
"the processor time used is not available "
|
|
"or its value cannot be represented");
|
|
return NULL;
|
|
}
|
|
if (info) {
|
|
info->implementation = "clock()";
|
|
info->resolution = 1.0 / (double)CLOCKS_PER_SEC;
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
}
|
|
return PyFloat_FromDouble((double)value / CLOCKS_PER_SEC);
|
|
}
|
|
#endif /* HAVE_CLOCK */
|
|
|
|
#if defined(MS_WINDOWS) && !defined(__BORLANDC__)
|
|
#define WIN32_PERF_COUNTER
|
|
/* Win32 has better clock replacement; we have our own version, due to Mark
|
|
Hammond and Tim Peters */
|
|
static int
|
|
win_perf_counter(_Py_clock_info_t *info, PyObject **result)
|
|
{
|
|
static LONGLONG cpu_frequency = 0;
|
|
static LONGLONG ctrStart;
|
|
LARGE_INTEGER now;
|
|
double diff;
|
|
|
|
if (cpu_frequency == 0) {
|
|
LARGE_INTEGER freq;
|
|
QueryPerformanceCounter(&now);
|
|
ctrStart = now.QuadPart;
|
|
if (!QueryPerformanceFrequency(&freq) || freq.QuadPart == 0) {
|
|
/* Unlikely to happen - this works on all intel
|
|
machines at least! Revert to clock() */
|
|
*result = NULL;
|
|
return -1;
|
|
}
|
|
cpu_frequency = freq.QuadPart;
|
|
}
|
|
QueryPerformanceCounter(&now);
|
|
diff = (double)(now.QuadPart - ctrStart);
|
|
if (info) {
|
|
info->implementation = "QueryPerformanceCounter()";
|
|
info->resolution = 1.0 / (double)cpu_frequency;
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
}
|
|
*result = PyFloat_FromDouble(diff / (double)cpu_frequency);
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
#if defined(WIN32_PERF_COUNTER) || defined(HAVE_CLOCK)
|
|
#define PYCLOCK
|
|
static PyObject*
|
|
pyclock(_Py_clock_info_t *info)
|
|
{
|
|
#ifdef WIN32_PERF_COUNTER
|
|
PyObject *res;
|
|
if (win_perf_counter(info, &res) == 0)
|
|
return res;
|
|
#endif
|
|
return floatclock(info);
|
|
}
|
|
|
|
static PyObject *
|
|
time_clock(PyObject *self, PyObject *unused)
|
|
{
|
|
return pyclock(NULL);
|
|
}
|
|
|
|
PyDoc_STRVAR(clock_doc,
|
|
"clock() -> floating point number\n\
|
|
\n\
|
|
Return the CPU time or real time since the start of the process or since\n\
|
|
the first call to clock(). This has as much precision as the system\n\
|
|
records.");
|
|
#endif
|
|
|
|
#ifdef HAVE_CLOCK_GETTIME
|
|
static PyObject *
|
|
time_clock_gettime(PyObject *self, PyObject *args)
|
|
{
|
|
int ret;
|
|
int clk_id;
|
|
struct timespec tp;
|
|
|
|
if (!PyArg_ParseTuple(args, "i:clock_gettime", &clk_id))
|
|
return NULL;
|
|
|
|
ret = clock_gettime((clockid_t)clk_id, &tp);
|
|
if (ret != 0) {
|
|
PyErr_SetFromErrno(PyExc_IOError);
|
|
return NULL;
|
|
}
|
|
return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
|
|
}
|
|
|
|
PyDoc_STRVAR(clock_gettime_doc,
|
|
"clock_gettime(clk_id) -> floating point number\n\
|
|
\n\
|
|
Return the time of the specified clock clk_id.");
|
|
|
|
static PyObject *
|
|
time_clock_settime(PyObject *self, PyObject *args)
|
|
{
|
|
int clk_id;
|
|
PyObject *obj;
|
|
struct timespec tp;
|
|
int ret;
|
|
|
|
if (!PyArg_ParseTuple(args, "iO:clock_settime", &clk_id, &obj))
|
|
return NULL;
|
|
|
|
if (_PyTime_ObjectToTimespec(obj, &tp.tv_sec, &tp.tv_nsec) == -1)
|
|
return NULL;
|
|
|
|
ret = clock_settime((clockid_t)clk_id, &tp);
|
|
if (ret != 0) {
|
|
PyErr_SetFromErrno(PyExc_IOError);
|
|
return NULL;
|
|
}
|
|
Py_RETURN_NONE;
|
|
}
|
|
|
|
PyDoc_STRVAR(clock_settime_doc,
|
|
"clock_settime(clk_id, time)\n\
|
|
\n\
|
|
Set the time of the specified clock clk_id.");
|
|
|
|
static PyObject *
|
|
time_clock_getres(PyObject *self, PyObject *args)
|
|
{
|
|
int ret;
|
|
int clk_id;
|
|
struct timespec tp;
|
|
|
|
if (!PyArg_ParseTuple(args, "i:clock_getres", &clk_id))
|
|
return NULL;
|
|
|
|
ret = clock_getres((clockid_t)clk_id, &tp);
|
|
if (ret != 0) {
|
|
PyErr_SetFromErrno(PyExc_IOError);
|
|
return NULL;
|
|
}
|
|
|
|
return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
|
|
}
|
|
|
|
PyDoc_STRVAR(clock_getres_doc,
|
|
"clock_getres(clk_id) -> floating point number\n\
|
|
\n\
|
|
Return the resolution (precision) of the specified clock clk_id.");
|
|
#endif /* HAVE_CLOCK_GETTIME */
|
|
|
|
static PyObject *
|
|
time_sleep(PyObject *self, PyObject *args)
|
|
{
|
|
double secs;
|
|
if (!PyArg_ParseTuple(args, "d:sleep", &secs))
|
|
return NULL;
|
|
if (secs < 0) {
|
|
PyErr_SetString(PyExc_ValueError,
|
|
"sleep length must be non-negative");
|
|
return NULL;
|
|
}
|
|
if (floatsleep(secs) != 0)
|
|
return NULL;
|
|
Py_INCREF(Py_None);
|
|
return Py_None;
|
|
}
|
|
|
|
PyDoc_STRVAR(sleep_doc,
|
|
"sleep(seconds)\n\
|
|
\n\
|
|
Delay execution for a given number of seconds. The argument may be\n\
|
|
a floating point number for subsecond precision.");
|
|
|
|
static PyStructSequence_Field struct_time_type_fields[] = {
|
|
{"tm_year", "year, for example, 1993"},
|
|
{"tm_mon", "month of year, range [1, 12]"},
|
|
{"tm_mday", "day of month, range [1, 31]"},
|
|
{"tm_hour", "hours, range [0, 23]"},
|
|
{"tm_min", "minutes, range [0, 59]"},
|
|
{"tm_sec", "seconds, range [0, 61])"},
|
|
{"tm_wday", "day of week, range [0, 6], Monday is 0"},
|
|
{"tm_yday", "day of year, range [1, 366]"},
|
|
{"tm_isdst", "1 if summer time is in effect, 0 if not, and -1 if unknown"},
|
|
#ifdef HAVE_STRUCT_TM_TM_ZONE
|
|
{"tm_zone", "abbreviation of timezone name"},
|
|
{"tm_gmtoff", "offset from UTC in seconds"},
|
|
#endif /* HAVE_STRUCT_TM_TM_ZONE */
|
|
{0}
|
|
};
|
|
|
|
static PyStructSequence_Desc struct_time_type_desc = {
|
|
"time.struct_time",
|
|
"The time value as returned by gmtime(), localtime(), and strptime(), and\n"
|
|
" accepted by asctime(), mktime() and strftime(). May be considered as a\n"
|
|
" sequence of 9 integers.\n\n"
|
|
" Note that several fields' values are not the same as those defined by\n"
|
|
" the C language standard for struct tm. For example, the value of the\n"
|
|
" field tm_year is the actual year, not year - 1900. See individual\n"
|
|
" fields' descriptions for details.",
|
|
struct_time_type_fields,
|
|
9,
|
|
};
|
|
|
|
static int initialized;
|
|
static PyTypeObject StructTimeType;
|
|
|
|
|
|
static PyObject *
|
|
tmtotuple(struct tm *p)
|
|
{
|
|
PyObject *v = PyStructSequence_New(&StructTimeType);
|
|
if (v == NULL)
|
|
return NULL;
|
|
|
|
#define SET(i,val) PyStructSequence_SET_ITEM(v, i, PyLong_FromLong((long) val))
|
|
|
|
SET(0, p->tm_year + 1900);
|
|
SET(1, p->tm_mon + 1); /* Want January == 1 */
|
|
SET(2, p->tm_mday);
|
|
SET(3, p->tm_hour);
|
|
SET(4, p->tm_min);
|
|
SET(5, p->tm_sec);
|
|
SET(6, (p->tm_wday + 6) % 7); /* Want Monday == 0 */
|
|
SET(7, p->tm_yday + 1); /* Want January, 1 == 1 */
|
|
SET(8, p->tm_isdst);
|
|
#ifdef HAVE_STRUCT_TM_TM_ZONE
|
|
PyStructSequence_SET_ITEM(v, 9,
|
|
PyUnicode_DecodeLocale(p->tm_zone, "surrogateescape"));
|
|
SET(10, p->tm_gmtoff);
|
|
#endif /* HAVE_STRUCT_TM_TM_ZONE */
|
|
#undef SET
|
|
if (PyErr_Occurred()) {
|
|
Py_XDECREF(v);
|
|
return NULL;
|
|
}
|
|
|
|
return v;
|
|
}
|
|
|
|
/* Parse arg tuple that can contain an optional float-or-None value;
|
|
format needs to be "|O:name".
|
|
Returns non-zero on success (parallels PyArg_ParseTuple).
|
|
*/
|
|
static int
|
|
parse_time_t_args(PyObject *args, char *format, time_t *pwhen)
|
|
{
|
|
PyObject *ot = NULL;
|
|
time_t whent;
|
|
|
|
if (!PyArg_ParseTuple(args, format, &ot))
|
|
return 0;
|
|
if (ot == NULL || ot == Py_None) {
|
|
whent = time(NULL);
|
|
}
|
|
else {
|
|
if (_PyTime_ObjectToTime_t(ot, &whent) == -1)
|
|
return 0;
|
|
}
|
|
*pwhen = whent;
|
|
return 1;
|
|
}
|
|
|
|
static PyObject *
|
|
time_gmtime(PyObject *self, PyObject *args)
|
|
{
|
|
time_t when;
|
|
struct tm buf, *local;
|
|
|
|
if (!parse_time_t_args(args, "|O:gmtime", &when))
|
|
return NULL;
|
|
|
|
errno = 0;
|
|
local = gmtime(&when);
|
|
if (local == NULL) {
|
|
#ifdef EINVAL
|
|
if (errno == 0)
|
|
errno = EINVAL;
|
|
#endif
|
|
return PyErr_SetFromErrno(PyExc_OSError);
|
|
}
|
|
buf = *local;
|
|
return tmtotuple(&buf);
|
|
}
|
|
|
|
PyDoc_STRVAR(gmtime_doc,
|
|
"gmtime([seconds]) -> (tm_year, tm_mon, tm_mday, tm_hour, tm_min,\n\
|
|
tm_sec, tm_wday, tm_yday, tm_isdst)\n\
|
|
\n\
|
|
Convert seconds since the Epoch to a time tuple expressing UTC (a.k.a.\n\
|
|
GMT). When 'seconds' is not passed in, convert the current time instead.\n\
|
|
\n\
|
|
If the platform supports the tm_gmtoff and tm_zone, they are available as\n\
|
|
attributes only.");
|
|
|
|
static int
|
|
pylocaltime(time_t *timep, struct tm *result)
|
|
{
|
|
struct tm *local;
|
|
|
|
assert (timep != NULL);
|
|
local = localtime(timep);
|
|
if (local == NULL) {
|
|
/* unconvertible time */
|
|
#ifdef EINVAL
|
|
if (errno == 0)
|
|
errno = EINVAL;
|
|
#endif
|
|
PyErr_SetFromErrno(PyExc_OSError);
|
|
return -1;
|
|
}
|
|
*result = *local;
|
|
return 0;
|
|
}
|
|
|
|
static PyObject *
|
|
time_localtime(PyObject *self, PyObject *args)
|
|
{
|
|
time_t when;
|
|
struct tm buf;
|
|
|
|
if (!parse_time_t_args(args, "|O:localtime", &when))
|
|
return NULL;
|
|
if (pylocaltime(&when, &buf) == -1)
|
|
return NULL;
|
|
return tmtotuple(&buf);
|
|
}
|
|
|
|
PyDoc_STRVAR(localtime_doc,
|
|
"localtime([seconds]) -> (tm_year,tm_mon,tm_mday,tm_hour,tm_min,\n\
|
|
tm_sec,tm_wday,tm_yday,tm_isdst)\n\
|
|
\n\
|
|
Convert seconds since the Epoch to a time tuple expressing local time.\n\
|
|
When 'seconds' is not passed in, convert the current time instead.");
|
|
|
|
/* Convert 9-item tuple to tm structure. Return 1 on success, set
|
|
* an exception and return 0 on error.
|
|
*/
|
|
static int
|
|
gettmarg(PyObject *args, struct tm *p)
|
|
{
|
|
int y;
|
|
|
|
memset((void *) p, '\0', sizeof(struct tm));
|
|
|
|
if (!PyTuple_Check(args)) {
|
|
PyErr_SetString(PyExc_TypeError,
|
|
"Tuple or struct_time argument required");
|
|
return 0;
|
|
}
|
|
|
|
if (!PyArg_ParseTuple(args, "iiiiiiiii",
|
|
&y, &p->tm_mon, &p->tm_mday,
|
|
&p->tm_hour, &p->tm_min, &p->tm_sec,
|
|
&p->tm_wday, &p->tm_yday, &p->tm_isdst))
|
|
return 0;
|
|
p->tm_year = y - 1900;
|
|
p->tm_mon--;
|
|
p->tm_wday = (p->tm_wday + 1) % 7;
|
|
p->tm_yday--;
|
|
#ifdef HAVE_STRUCT_TM_TM_ZONE
|
|
if (Py_TYPE(args) == &StructTimeType) {
|
|
PyObject *item;
|
|
item = PyTuple_GET_ITEM(args, 9);
|
|
p->tm_zone = item == Py_None ? NULL : _PyUnicode_AsString(item);
|
|
item = PyTuple_GET_ITEM(args, 10);
|
|
p->tm_gmtoff = item == Py_None ? 0 : PyLong_AsLong(item);
|
|
if (PyErr_Occurred())
|
|
return 0;
|
|
}
|
|
#endif /* HAVE_STRUCT_TM_TM_ZONE */
|
|
return 1;
|
|
}
|
|
|
|
/* Check values of the struct tm fields before it is passed to strftime() and
|
|
* asctime(). Return 1 if all values are valid, otherwise set an exception
|
|
* and returns 0.
|
|
*/
|
|
static int
|
|
checktm(struct tm* buf)
|
|
{
|
|
/* Checks added to make sure strftime() and asctime() does not crash Python by
|
|
indexing blindly into some array for a textual representation
|
|
by some bad index (fixes bug #897625 and #6608).
|
|
|
|
Also support values of zero from Python code for arguments in which
|
|
that is out of range by forcing that value to the lowest value that
|
|
is valid (fixed bug #1520914).
|
|
|
|
Valid ranges based on what is allowed in struct tm:
|
|
|
|
- tm_year: [0, max(int)] (1)
|
|
- tm_mon: [0, 11] (2)
|
|
- tm_mday: [1, 31]
|
|
- tm_hour: [0, 23]
|
|
- tm_min: [0, 59]
|
|
- tm_sec: [0, 60]
|
|
- tm_wday: [0, 6] (1)
|
|
- tm_yday: [0, 365] (2)
|
|
- tm_isdst: [-max(int), max(int)]
|
|
|
|
(1) gettmarg() handles bounds-checking.
|
|
(2) Python's acceptable range is one greater than the range in C,
|
|
thus need to check against automatic decrement by gettmarg().
|
|
*/
|
|
if (buf->tm_mon == -1)
|
|
buf->tm_mon = 0;
|
|
else if (buf->tm_mon < 0 || buf->tm_mon > 11) {
|
|
PyErr_SetString(PyExc_ValueError, "month out of range");
|
|
return 0;
|
|
}
|
|
if (buf->tm_mday == 0)
|
|
buf->tm_mday = 1;
|
|
else if (buf->tm_mday < 0 || buf->tm_mday > 31) {
|
|
PyErr_SetString(PyExc_ValueError, "day of month out of range");
|
|
return 0;
|
|
}
|
|
if (buf->tm_hour < 0 || buf->tm_hour > 23) {
|
|
PyErr_SetString(PyExc_ValueError, "hour out of range");
|
|
return 0;
|
|
}
|
|
if (buf->tm_min < 0 || buf->tm_min > 59) {
|
|
PyErr_SetString(PyExc_ValueError, "minute out of range");
|
|
return 0;
|
|
}
|
|
if (buf->tm_sec < 0 || buf->tm_sec > 61) {
|
|
PyErr_SetString(PyExc_ValueError, "seconds out of range");
|
|
return 0;
|
|
}
|
|
/* tm_wday does not need checking of its upper-bound since taking
|
|
``% 7`` in gettmarg() automatically restricts the range. */
|
|
if (buf->tm_wday < 0) {
|
|
PyErr_SetString(PyExc_ValueError, "day of week out of range");
|
|
return 0;
|
|
}
|
|
if (buf->tm_yday == -1)
|
|
buf->tm_yday = 0;
|
|
else if (buf->tm_yday < 0 || buf->tm_yday > 365) {
|
|
PyErr_SetString(PyExc_ValueError, "day of year out of range");
|
|
return 0;
|
|
}
|
|
return 1;
|
|
}
|
|
|
|
#ifdef MS_WINDOWS
|
|
/* wcsftime() doesn't format correctly time zones, see issue #10653 */
|
|
# undef HAVE_WCSFTIME
|
|
#endif
|
|
#define STRFTIME_FORMAT_CODES \
|
|
"Commonly used format codes:\n\
|
|
\n\
|
|
%Y Year with century as a decimal number.\n\
|
|
%m Month as a decimal number [01,12].\n\
|
|
%d Day of the month as a decimal number [01,31].\n\
|
|
%H Hour (24-hour clock) as a decimal number [00,23].\n\
|
|
%M Minute as a decimal number [00,59].\n\
|
|
%S Second as a decimal number [00,61].\n\
|
|
%z Time zone offset from UTC.\n\
|
|
%a Locale's abbreviated weekday name.\n\
|
|
%A Locale's full weekday name.\n\
|
|
%b Locale's abbreviated month name.\n\
|
|
%B Locale's full month name.\n\
|
|
%c Locale's appropriate date and time representation.\n\
|
|
%I Hour (12-hour clock) as a decimal number [01,12].\n\
|
|
%p Locale's equivalent of either AM or PM.\n\
|
|
\n\
|
|
Other codes may be available on your platform. See documentation for\n\
|
|
the C library strftime function.\n"
|
|
|
|
#ifdef HAVE_STRFTIME
|
|
#ifdef HAVE_WCSFTIME
|
|
#define time_char wchar_t
|
|
#define format_time wcsftime
|
|
#define time_strlen wcslen
|
|
#else
|
|
#define time_char char
|
|
#define format_time strftime
|
|
#define time_strlen strlen
|
|
#endif
|
|
|
|
static PyObject *
|
|
time_strftime(PyObject *self, PyObject *args)
|
|
{
|
|
PyObject *tup = NULL;
|
|
struct tm buf;
|
|
const time_char *fmt;
|
|
#ifdef HAVE_WCSFTIME
|
|
wchar_t *format;
|
|
#else
|
|
PyObject *format;
|
|
#endif
|
|
PyObject *format_arg;
|
|
size_t fmtlen, buflen;
|
|
time_char *outbuf = NULL;
|
|
size_t i;
|
|
PyObject *ret = NULL;
|
|
|
|
memset((void *) &buf, '\0', sizeof(buf));
|
|
|
|
/* Will always expect a unicode string to be passed as format.
|
|
Given that there's no str type anymore in py3k this seems safe.
|
|
*/
|
|
if (!PyArg_ParseTuple(args, "U|O:strftime", &format_arg, &tup))
|
|
return NULL;
|
|
|
|
if (tup == NULL) {
|
|
time_t tt = time(NULL);
|
|
if (pylocaltime(&tt, &buf) == -1)
|
|
return NULL;
|
|
}
|
|
else if (!gettmarg(tup, &buf) || !checktm(&buf))
|
|
return NULL;
|
|
|
|
#if defined(_MSC_VER) || defined(sun)
|
|
if (buf.tm_year + 1900 < 1 || 9999 < buf.tm_year + 1900) {
|
|
PyErr_SetString(PyExc_ValueError,
|
|
"strftime() requires year in [1; 9999]");
|
|
return NULL;
|
|
}
|
|
#endif
|
|
|
|
/* Normalize tm_isdst just in case someone foolishly implements %Z
|
|
based on the assumption that tm_isdst falls within the range of
|
|
[-1, 1] */
|
|
if (buf.tm_isdst < -1)
|
|
buf.tm_isdst = -1;
|
|
else if (buf.tm_isdst > 1)
|
|
buf.tm_isdst = 1;
|
|
|
|
#ifdef HAVE_WCSFTIME
|
|
format = PyUnicode_AsWideCharString(format_arg, NULL);
|
|
if (format == NULL)
|
|
return NULL;
|
|
fmt = format;
|
|
#else
|
|
/* Convert the unicode string to an ascii one */
|
|
format = PyUnicode_EncodeLocale(format_arg, "surrogateescape");
|
|
if (format == NULL)
|
|
return NULL;
|
|
fmt = PyBytes_AS_STRING(format);
|
|
#endif
|
|
|
|
#if defined(MS_WINDOWS) && !defined(HAVE_WCSFTIME)
|
|
/* check that the format string contains only valid directives */
|
|
for(outbuf = strchr(fmt, '%');
|
|
outbuf != NULL;
|
|
outbuf = strchr(outbuf+2, '%'))
|
|
{
|
|
if (outbuf[1]=='#')
|
|
++outbuf; /* not documented by python, */
|
|
if (outbuf[1]=='\0' ||
|
|
!strchr("aAbBcdHIjmMpSUwWxXyYzZ%", outbuf[1]))
|
|
{
|
|
PyErr_SetString(PyExc_ValueError, "Invalid format string");
|
|
Py_DECREF(format);
|
|
return NULL;
|
|
}
|
|
}
|
|
#endif
|
|
|
|
fmtlen = time_strlen(fmt);
|
|
|
|
/* I hate these functions that presume you know how big the output
|
|
* will be ahead of time...
|
|
*/
|
|
for (i = 1024; ; i += i) {
|
|
#if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
|
|
int err;
|
|
#endif
|
|
outbuf = (time_char *)PyMem_Malloc(i*sizeof(time_char));
|
|
if (outbuf == NULL) {
|
|
PyErr_NoMemory();
|
|
break;
|
|
}
|
|
buflen = format_time(outbuf, i, fmt, &buf);
|
|
#if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
|
|
err = errno;
|
|
#endif
|
|
if (buflen > 0 || i >= 256 * fmtlen) {
|
|
/* If the buffer is 256 times as long as the format,
|
|
it's probably not failing for lack of room!
|
|
More likely, the format yields an empty result,
|
|
e.g. an empty format, or %Z when the timezone
|
|
is unknown. */
|
|
#ifdef HAVE_WCSFTIME
|
|
ret = PyUnicode_FromWideChar(outbuf, buflen);
|
|
#else
|
|
ret = PyUnicode_DecodeLocaleAndSize(outbuf, buflen,
|
|
"surrogateescape");
|
|
#endif
|
|
PyMem_Free(outbuf);
|
|
break;
|
|
}
|
|
PyMem_Free(outbuf);
|
|
#if defined _MSC_VER && _MSC_VER >= 1400 && defined(__STDC_SECURE_LIB__)
|
|
/* VisualStudio .NET 2005 does this properly */
|
|
if (buflen == 0 && err == EINVAL) {
|
|
PyErr_SetString(PyExc_ValueError, "Invalid format string");
|
|
break;
|
|
}
|
|
#endif
|
|
}
|
|
#ifdef HAVE_WCSFTIME
|
|
PyMem_Free(format);
|
|
#else
|
|
Py_DECREF(format);
|
|
#endif
|
|
return ret;
|
|
}
|
|
|
|
#undef time_char
|
|
#undef format_time
|
|
PyDoc_STRVAR(strftime_doc,
|
|
"strftime(format[, tuple]) -> string\n\
|
|
\n\
|
|
Convert a time tuple to a string according to a format specification.\n\
|
|
See the library reference manual for formatting codes. When the time tuple\n\
|
|
is not present, current time as returned by localtime() is used.\n\
|
|
\n" STRFTIME_FORMAT_CODES);
|
|
#endif /* HAVE_STRFTIME */
|
|
|
|
static PyObject *
|
|
time_strptime(PyObject *self, PyObject *args)
|
|
{
|
|
PyObject *strptime_module = PyImport_ImportModuleNoBlock("_strptime");
|
|
PyObject *strptime_result;
|
|
_Py_IDENTIFIER(_strptime_time);
|
|
|
|
if (!strptime_module)
|
|
return NULL;
|
|
strptime_result = _PyObject_CallMethodId(strptime_module,
|
|
&PyId__strptime_time, "O", args);
|
|
Py_DECREF(strptime_module);
|
|
return strptime_result;
|
|
}
|
|
|
|
|
|
PyDoc_STRVAR(strptime_doc,
|
|
"strptime(string, format) -> struct_time\n\
|
|
\n\
|
|
Parse a string to a time tuple according to a format specification.\n\
|
|
See the library reference manual for formatting codes (same as\n\
|
|
strftime()).\n\
|
|
\n" STRFTIME_FORMAT_CODES);
|
|
|
|
static PyObject *
|
|
_asctime(struct tm *timeptr)
|
|
{
|
|
/* Inspired by Open Group reference implementation available at
|
|
* http://pubs.opengroup.org/onlinepubs/009695399/functions/asctime.html */
|
|
static char wday_name[7][4] = {
|
|
"Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"
|
|
};
|
|
static char mon_name[12][4] = {
|
|
"Jan", "Feb", "Mar", "Apr", "May", "Jun",
|
|
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
|
|
};
|
|
return PyUnicode_FromFormat(
|
|
"%s %s%3d %.2d:%.2d:%.2d %d",
|
|
wday_name[timeptr->tm_wday],
|
|
mon_name[timeptr->tm_mon],
|
|
timeptr->tm_mday, timeptr->tm_hour,
|
|
timeptr->tm_min, timeptr->tm_sec,
|
|
1900 + timeptr->tm_year);
|
|
}
|
|
|
|
static PyObject *
|
|
time_asctime(PyObject *self, PyObject *args)
|
|
{
|
|
PyObject *tup = NULL;
|
|
struct tm buf;
|
|
|
|
if (!PyArg_UnpackTuple(args, "asctime", 0, 1, &tup))
|
|
return NULL;
|
|
if (tup == NULL) {
|
|
time_t tt = time(NULL);
|
|
if (pylocaltime(&tt, &buf) == -1)
|
|
return NULL;
|
|
|
|
} else if (!gettmarg(tup, &buf) || !checktm(&buf))
|
|
return NULL;
|
|
return _asctime(&buf);
|
|
}
|
|
|
|
PyDoc_STRVAR(asctime_doc,
|
|
"asctime([tuple]) -> string\n\
|
|
\n\
|
|
Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'.\n\
|
|
When the time tuple is not present, current time as returned by localtime()\n\
|
|
is used.");
|
|
|
|
static PyObject *
|
|
time_ctime(PyObject *self, PyObject *args)
|
|
{
|
|
time_t tt;
|
|
struct tm buf;
|
|
if (!parse_time_t_args(args, "|O:ctime", &tt))
|
|
return NULL;
|
|
if (pylocaltime(&tt, &buf) == -1)
|
|
return NULL;
|
|
return _asctime(&buf);
|
|
}
|
|
|
|
PyDoc_STRVAR(ctime_doc,
|
|
"ctime(seconds) -> string\n\
|
|
\n\
|
|
Convert a time in seconds since the Epoch to a string in local time.\n\
|
|
This is equivalent to asctime(localtime(seconds)). When the time tuple is\n\
|
|
not present, current time as returned by localtime() is used.");
|
|
|
|
#ifdef HAVE_MKTIME
|
|
static PyObject *
|
|
time_mktime(PyObject *self, PyObject *tup)
|
|
{
|
|
struct tm buf;
|
|
time_t tt;
|
|
if (!gettmarg(tup, &buf))
|
|
return NULL;
|
|
buf.tm_wday = -1; /* sentinel; original value ignored */
|
|
tt = mktime(&buf);
|
|
/* Return value of -1 does not necessarily mean an error, but tm_wday
|
|
* cannot remain set to -1 if mktime succeeded. */
|
|
if (tt == (time_t)(-1) && buf.tm_wday == -1) {
|
|
PyErr_SetString(PyExc_OverflowError,
|
|
"mktime argument out of range");
|
|
return NULL;
|
|
}
|
|
return PyFloat_FromDouble((double)tt);
|
|
}
|
|
|
|
PyDoc_STRVAR(mktime_doc,
|
|
"mktime(tuple) -> floating point number\n\
|
|
\n\
|
|
Convert a time tuple in local time to seconds since the Epoch.\n\
|
|
Note that mktime(gmtime(0)) will not generally return zero for most\n\
|
|
time zones; instead the returned value will either be equal to that\n\
|
|
of the timezone or altzone attributes on the time module.");
|
|
#endif /* HAVE_MKTIME */
|
|
|
|
#ifdef HAVE_WORKING_TZSET
|
|
static void PyInit_timezone(PyObject *module);
|
|
|
|
static PyObject *
|
|
time_tzset(PyObject *self, PyObject *unused)
|
|
{
|
|
PyObject* m;
|
|
|
|
m = PyImport_ImportModuleNoBlock("time");
|
|
if (m == NULL) {
|
|
return NULL;
|
|
}
|
|
|
|
tzset();
|
|
|
|
/* Reset timezone, altzone, daylight and tzname */
|
|
PyInit_timezone(m);
|
|
Py_DECREF(m);
|
|
|
|
Py_INCREF(Py_None);
|
|
return Py_None;
|
|
}
|
|
|
|
PyDoc_STRVAR(tzset_doc,
|
|
"tzset()\n\
|
|
\n\
|
|
Initialize, or reinitialize, the local timezone to the value stored in\n\
|
|
os.environ['TZ']. The TZ environment variable should be specified in\n\
|
|
standard Unix timezone format as documented in the tzset man page\n\
|
|
(eg. 'US/Eastern', 'Europe/Amsterdam'). Unknown timezones will silently\n\
|
|
fall back to UTC. If the TZ environment variable is not set, the local\n\
|
|
timezone is set to the systems best guess of wallclock time.\n\
|
|
Changing the TZ environment variable without calling tzset *may* change\n\
|
|
the local timezone used by methods such as localtime, but this behaviour\n\
|
|
should not be relied on.");
|
|
#endif /* HAVE_WORKING_TZSET */
|
|
|
|
#if defined(MS_WINDOWS) || defined(__APPLE__) \
|
|
|| (defined(HAVE_CLOCK_GETTIME) \
|
|
&& (defined(CLOCK_HIGHRES) || defined(CLOCK_MONOTONIC)))
|
|
#define PYMONOTONIC
|
|
#endif
|
|
|
|
#ifdef PYMONOTONIC
|
|
static PyObject*
|
|
pymonotonic(_Py_clock_info_t *info)
|
|
{
|
|
#if defined(MS_WINDOWS)
|
|
static ULONGLONG (*GetTickCount64) (void) = NULL;
|
|
static ULONGLONG (CALLBACK *Py_GetTickCount64)(void);
|
|
static int has_getickcount64 = -1;
|
|
double result;
|
|
|
|
if (has_getickcount64 == -1) {
|
|
/* GetTickCount64() was added to Windows Vista */
|
|
if (winver.dwMajorVersion >= 6) {
|
|
HINSTANCE hKernel32;
|
|
hKernel32 = GetModuleHandleW(L"KERNEL32");
|
|
*(FARPROC*)&Py_GetTickCount64 = GetProcAddress(hKernel32,
|
|
"GetTickCount64");
|
|
has_getickcount64 = (Py_GetTickCount64 != NULL);
|
|
}
|
|
else
|
|
has_getickcount64 = 0;
|
|
}
|
|
|
|
if (has_getickcount64) {
|
|
ULONGLONG ticks;
|
|
ticks = Py_GetTickCount64();
|
|
result = (double)ticks * 1e-3;
|
|
}
|
|
else {
|
|
static DWORD last_ticks = 0;
|
|
static DWORD n_overflow = 0;
|
|
DWORD ticks;
|
|
|
|
ticks = GetTickCount();
|
|
if (ticks < last_ticks)
|
|
n_overflow++;
|
|
last_ticks = ticks;
|
|
|
|
result = ldexp(n_overflow, 32);
|
|
result += ticks;
|
|
result *= 1e-3;
|
|
}
|
|
|
|
if (info) {
|
|
DWORD timeAdjustment, timeIncrement;
|
|
BOOL isTimeAdjustmentDisabled, ok;
|
|
if (has_getickcount64)
|
|
info->implementation = "GetTickCount64()";
|
|
else
|
|
info->implementation = "GetTickCount()";
|
|
info->monotonic = 1;
|
|
ok = GetSystemTimeAdjustment(&timeAdjustment, &timeIncrement,
|
|
&isTimeAdjustmentDisabled);
|
|
if (!ok) {
|
|
PyErr_SetFromWindowsErr(0);
|
|
return NULL;
|
|
}
|
|
info->resolution = timeIncrement * 1e-7;
|
|
info->adjustable = 0;
|
|
}
|
|
return PyFloat_FromDouble(result);
|
|
|
|
#elif defined(__APPLE__)
|
|
static mach_timebase_info_data_t timebase;
|
|
uint64_t time;
|
|
double secs;
|
|
|
|
if (timebase.denom == 0) {
|
|
/* According to the Technical Q&A QA1398, mach_timebase_info() cannot
|
|
fail: https://developer.apple.com/library/mac/#qa/qa1398/ */
|
|
(void)mach_timebase_info(&timebase);
|
|
}
|
|
|
|
time = mach_absolute_time();
|
|
secs = (double)time * timebase.numer / timebase.denom * 1e-9;
|
|
if (info) {
|
|
info->implementation = "mach_absolute_time()";
|
|
info->resolution = (double)timebase.numer / timebase.denom * 1e-9;
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
}
|
|
return PyFloat_FromDouble(secs);
|
|
|
|
#elif defined(HAVE_CLOCK_GETTIME) && (defined(CLOCK_HIGHRES) || defined(CLOCK_MONOTONIC))
|
|
struct timespec tp;
|
|
#ifdef CLOCK_HIGHRES
|
|
const clockid_t clk_id = CLOCK_HIGHRES;
|
|
const char *function = "clock_gettime(CLOCK_HIGHRES)";
|
|
#else
|
|
const clockid_t clk_id = CLOCK_MONOTONIC;
|
|
const char *function = "clock_gettime(CLOCK_MONOTONIC)";
|
|
#endif
|
|
|
|
if (clock_gettime(clk_id, &tp) != 0) {
|
|
PyErr_SetFromErrno(PyExc_OSError);
|
|
return NULL;
|
|
}
|
|
|
|
if (info) {
|
|
struct timespec res;
|
|
info->monotonic = 1;
|
|
info->implementation = function;
|
|
info->adjustable = 0;
|
|
if (clock_getres(clk_id, &res) == 0)
|
|
info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
|
|
else
|
|
info->resolution = 1e-9;
|
|
}
|
|
return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
|
|
#endif
|
|
}
|
|
|
|
static PyObject *
|
|
time_monotonic(PyObject *self, PyObject *unused)
|
|
{
|
|
return pymonotonic(NULL);
|
|
}
|
|
|
|
PyDoc_STRVAR(monotonic_doc,
|
|
"monotonic() -> float\n\
|
|
\n\
|
|
Monotonic clock, cannot go backward.");
|
|
#endif /* PYMONOTONIC */
|
|
|
|
static PyObject*
|
|
perf_counter(_Py_clock_info_t *info)
|
|
{
|
|
#if defined(WIN32_PERF_COUNTER) || defined(PYMONOTONIC)
|
|
PyObject *res;
|
|
#endif
|
|
#if defined(WIN32_PERF_COUNTER)
|
|
static int use_perf_counter = 1;
|
|
#endif
|
|
#ifdef PYMONOTONIC
|
|
static int use_monotonic = 1;
|
|
#endif
|
|
|
|
#ifdef WIN32_PERF_COUNTER
|
|
if (use_perf_counter) {
|
|
if (win_perf_counter(info, &res) == 0)
|
|
return res;
|
|
use_perf_counter = 0;
|
|
}
|
|
#endif
|
|
|
|
#ifdef PYMONOTONIC
|
|
if (use_monotonic) {
|
|
res = pymonotonic(info);
|
|
if (res != NULL)
|
|
return res;
|
|
use_monotonic = 0;
|
|
PyErr_Clear();
|
|
}
|
|
#endif
|
|
|
|
return floattime(info);
|
|
}
|
|
|
|
static PyObject *
|
|
time_perf_counter(PyObject *self, PyObject *unused)
|
|
{
|
|
return perf_counter(NULL);
|
|
}
|
|
|
|
PyDoc_STRVAR(perf_counter_doc,
|
|
"perf_counter() -> float\n\
|
|
\n\
|
|
Performance counter for benchmarking.");
|
|
|
|
static PyObject*
|
|
py_process_time(_Py_clock_info_t *info)
|
|
{
|
|
#if defined(MS_WINDOWS)
|
|
HANDLE process;
|
|
FILETIME creation_time, exit_time, kernel_time, user_time;
|
|
ULARGE_INTEGER large;
|
|
double total;
|
|
BOOL ok;
|
|
|
|
process = GetCurrentProcess();
|
|
ok = GetProcessTimes(process, &creation_time, &exit_time, &kernel_time, &user_time);
|
|
if (!ok)
|
|
return PyErr_SetFromWindowsErr(0);
|
|
|
|
large.u.LowPart = kernel_time.dwLowDateTime;
|
|
large.u.HighPart = kernel_time.dwHighDateTime;
|
|
total = (double)large.QuadPart;
|
|
large.u.LowPart = user_time.dwLowDateTime;
|
|
large.u.HighPart = user_time.dwHighDateTime;
|
|
total += (double)large.QuadPart;
|
|
if (info) {
|
|
info->implementation = "GetProcessTimes()";
|
|
info->resolution = 1e-7;
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
}
|
|
return PyFloat_FromDouble(total * 1e-7);
|
|
#else
|
|
|
|
#if defined(HAVE_SYS_RESOURCE_H)
|
|
struct rusage ru;
|
|
#endif
|
|
#ifdef HAVE_TIMES
|
|
struct tms t;
|
|
static long ticks_per_second = -1;
|
|
#endif
|
|
|
|
#if defined(HAVE_CLOCK_GETTIME) \
|
|
&& (defined(CLOCK_PROCESS_CPUTIME_ID) || defined(CLOCK_PROF))
|
|
struct timespec tp;
|
|
#ifdef CLOCK_PROF
|
|
const clockid_t clk_id = CLOCK_PROF;
|
|
const char *function = "clock_gettime(CLOCK_PROF)";
|
|
#else
|
|
const clockid_t clk_id = CLOCK_PROCESS_CPUTIME_ID;
|
|
const char *function = "clock_gettime(CLOCK_PROCESS_CPUTIME_ID)";
|
|
#endif
|
|
|
|
if (clock_gettime(clk_id, &tp) == 0) {
|
|
if (info) {
|
|
struct timespec res;
|
|
info->implementation = function;
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
if (clock_getres(clk_id, &res) == 0)
|
|
info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
|
|
else
|
|
info->resolution = 1e-9;
|
|
}
|
|
return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
|
|
}
|
|
#endif
|
|
|
|
#if defined(HAVE_SYS_RESOURCE_H)
|
|
if (getrusage(RUSAGE_SELF, &ru) == 0) {
|
|
double total;
|
|
total = ru.ru_utime.tv_sec + ru.ru_utime.tv_usec * 1e-6;
|
|
total += ru.ru_stime.tv_sec + ru.ru_stime.tv_usec * 1e-6;
|
|
if (info) {
|
|
info->implementation = "getrusage(RUSAGE_SELF)";
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
info->resolution = 1e-6;
|
|
}
|
|
return PyFloat_FromDouble(total);
|
|
}
|
|
#endif
|
|
|
|
#ifdef HAVE_TIMES
|
|
if (times(&t) != (clock_t)-1) {
|
|
double total;
|
|
|
|
if (ticks_per_second == -1) {
|
|
#if defined(HAVE_SYSCONF) && defined(_SC_CLK_TCK)
|
|
ticks_per_second = sysconf(_SC_CLK_TCK);
|
|
if (ticks_per_second < 1)
|
|
ticks_per_second = -1;
|
|
#elif defined(HZ)
|
|
ticks_per_second = HZ;
|
|
#else
|
|
ticks_per_second = 60; /* magic fallback value; may be bogus */
|
|
#endif
|
|
}
|
|
|
|
if (ticks_per_second != -1) {
|
|
total = (double)t.tms_utime / ticks_per_second;
|
|
total += (double)t.tms_stime / ticks_per_second;
|
|
if (info) {
|
|
info->implementation = "times()";
|
|
info->monotonic = 1;
|
|
info->adjustable = 0;
|
|
info->resolution = 1.0 / ticks_per_second;
|
|
}
|
|
return PyFloat_FromDouble(total);
|
|
}
|
|
}
|
|
#endif
|
|
|
|
return floatclock(info);
|
|
#endif
|
|
}
|
|
|
|
static PyObject *
|
|
time_process_time(PyObject *self, PyObject *unused)
|
|
{
|
|
return py_process_time(NULL);
|
|
}
|
|
|
|
PyDoc_STRVAR(process_time_doc,
|
|
"process_time() -> float\n\
|
|
\n\
|
|
Process time for profiling: sum of the kernel and user-space CPU time.");
|
|
|
|
|
|
static PyObject *
|
|
time_get_clock_info(PyObject *self, PyObject *args)
|
|
{
|
|
char *name;
|
|
_Py_clock_info_t info;
|
|
PyObject *obj = NULL, *dict, *ns;
|
|
|
|
if (!PyArg_ParseTuple(args, "s:get_clock_info", &name))
|
|
return NULL;
|
|
|
|
#ifdef Py_DEBUG
|
|
info.implementation = NULL;
|
|
info.monotonic = -1;
|
|
info.adjustable = -1;
|
|
info.resolution = -1.0;
|
|
#else
|
|
info.implementation = "";
|
|
info.monotonic = 0;
|
|
info.adjustable = 0;
|
|
info.resolution = 1.0;
|
|
#endif
|
|
|
|
if (strcmp(name, "time") == 0)
|
|
obj = floattime(&info);
|
|
#ifdef PYCLOCK
|
|
else if (strcmp(name, "clock") == 0)
|
|
obj = pyclock(&info);
|
|
#endif
|
|
#ifdef PYMONOTONIC
|
|
else if (strcmp(name, "monotonic") == 0)
|
|
obj = pymonotonic(&info);
|
|
#endif
|
|
else if (strcmp(name, "perf_counter") == 0)
|
|
obj = perf_counter(&info);
|
|
else if (strcmp(name, "process_time") == 0)
|
|
obj = py_process_time(&info);
|
|
else {
|
|
PyErr_SetString(PyExc_ValueError, "unknown clock");
|
|
return NULL;
|
|
}
|
|
if (obj == NULL)
|
|
return NULL;
|
|
Py_DECREF(obj);
|
|
|
|
dict = PyDict_New();
|
|
if (dict == NULL)
|
|
return NULL;
|
|
|
|
assert(info.implementation != NULL);
|
|
obj = PyUnicode_FromString(info.implementation);
|
|
if (obj == NULL)
|
|
goto error;
|
|
if (PyDict_SetItemString(dict, "implementation", obj) == -1)
|
|
goto error;
|
|
Py_CLEAR(obj);
|
|
|
|
assert(info.monotonic != -1);
|
|
obj = PyBool_FromLong(info.monotonic);
|
|
if (obj == NULL)
|
|
goto error;
|
|
if (PyDict_SetItemString(dict, "monotonic", obj) == -1)
|
|
goto error;
|
|
Py_CLEAR(obj);
|
|
|
|
assert(info.adjustable != -1);
|
|
obj = PyBool_FromLong(info.adjustable);
|
|
if (obj == NULL)
|
|
goto error;
|
|
if (PyDict_SetItemString(dict, "adjustable", obj) == -1)
|
|
goto error;
|
|
Py_CLEAR(obj);
|
|
|
|
assert(info.resolution > 0.0);
|
|
assert(info.resolution <= 1.0);
|
|
obj = PyFloat_FromDouble(info.resolution);
|
|
if (obj == NULL)
|
|
goto error;
|
|
if (PyDict_SetItemString(dict, "resolution", obj) == -1)
|
|
goto error;
|
|
Py_CLEAR(obj);
|
|
|
|
ns = _PyNamespace_New(dict);
|
|
Py_DECREF(dict);
|
|
return ns;
|
|
|
|
error:
|
|
Py_DECREF(dict);
|
|
Py_XDECREF(obj);
|
|
return NULL;
|
|
}
|
|
|
|
PyDoc_STRVAR(get_clock_info_doc,
|
|
"get_clock_info(name: str) -> dict\n\
|
|
\n\
|
|
Get information of the specified clock.");
|
|
|
|
static void
|
|
PyInit_timezone(PyObject *m) {
|
|
/* This code moved from PyInit_time wholesale to allow calling it from
|
|
time_tzset. In the future, some parts of it can be moved back
|
|
(for platforms that don't HAVE_WORKING_TZSET, when we know what they
|
|
are), and the extraneous calls to tzset(3) should be removed.
|
|
I haven't done this yet, as I don't want to change this code as
|
|
little as possible when introducing the time.tzset and time.tzsetwall
|
|
methods. This should simply be a method of doing the following once,
|
|
at the top of this function and removing the call to tzset() from
|
|
time_tzset():
|
|
|
|
#ifdef HAVE_TZSET
|
|
tzset()
|
|
#endif
|
|
|
|
And I'm lazy and hate C so nyer.
|
|
*/
|
|
#if defined(HAVE_TZNAME) && !defined(__GLIBC__) && !defined(__CYGWIN__)
|
|
PyObject *otz0, *otz1;
|
|
tzset();
|
|
PyModule_AddIntConstant(m, "timezone", timezone);
|
|
#ifdef HAVE_ALTZONE
|
|
PyModule_AddIntConstant(m, "altzone", altzone);
|
|
#else
|
|
PyModule_AddIntConstant(m, "altzone", timezone-3600);
|
|
#endif
|
|
PyModule_AddIntConstant(m, "daylight", daylight);
|
|
otz0 = PyUnicode_DecodeLocale(tzname[0], "surrogateescape");
|
|
otz1 = PyUnicode_DecodeLocale(tzname[1], "surrogateescape");
|
|
PyModule_AddObject(m, "tzname", Py_BuildValue("(NN)", otz0, otz1));
|
|
#else /* !HAVE_TZNAME || __GLIBC__ || __CYGWIN__*/
|
|
#ifdef HAVE_STRUCT_TM_TM_ZONE
|
|
{
|
|
#define YEAR ((time_t)((365 * 24 + 6) * 3600))
|
|
time_t t;
|
|
struct tm *p;
|
|
long janzone, julyzone;
|
|
char janname[10], julyname[10];
|
|
t = (time((time_t *)0) / YEAR) * YEAR;
|
|
p = localtime(&t);
|
|
janzone = -p->tm_gmtoff;
|
|
strncpy(janname, p->tm_zone ? p->tm_zone : " ", 9);
|
|
janname[9] = '\0';
|
|
t += YEAR/2;
|
|
p = localtime(&t);
|
|
julyzone = -p->tm_gmtoff;
|
|
strncpy(julyname, p->tm_zone ? p->tm_zone : " ", 9);
|
|
julyname[9] = '\0';
|
|
|
|
if( janzone < julyzone ) {
|
|
/* DST is reversed in the southern hemisphere */
|
|
PyModule_AddIntConstant(m, "timezone", julyzone);
|
|
PyModule_AddIntConstant(m, "altzone", janzone);
|
|
PyModule_AddIntConstant(m, "daylight",
|
|
janzone != julyzone);
|
|
PyModule_AddObject(m, "tzname",
|
|
Py_BuildValue("(zz)",
|
|
julyname, janname));
|
|
} else {
|
|
PyModule_AddIntConstant(m, "timezone", janzone);
|
|
PyModule_AddIntConstant(m, "altzone", julyzone);
|
|
PyModule_AddIntConstant(m, "daylight",
|
|
janzone != julyzone);
|
|
PyModule_AddObject(m, "tzname",
|
|
Py_BuildValue("(zz)",
|
|
janname, julyname));
|
|
}
|
|
}
|
|
#else
|
|
#endif /* HAVE_STRUCT_TM_TM_ZONE */
|
|
#ifdef __CYGWIN__
|
|
tzset();
|
|
PyModule_AddIntConstant(m, "timezone", _timezone);
|
|
PyModule_AddIntConstant(m, "altzone", _timezone-3600);
|
|
PyModule_AddIntConstant(m, "daylight", _daylight);
|
|
PyModule_AddObject(m, "tzname",
|
|
Py_BuildValue("(zz)", _tzname[0], _tzname[1]));
|
|
#endif /* __CYGWIN__ */
|
|
#endif /* !HAVE_TZNAME || __GLIBC__ || __CYGWIN__*/
|
|
|
|
#if defined(HAVE_CLOCK_GETTIME)
|
|
PyModule_AddIntMacro(m, CLOCK_REALTIME);
|
|
#ifdef CLOCK_MONOTONIC
|
|
PyModule_AddIntMacro(m, CLOCK_MONOTONIC);
|
|
#endif
|
|
#ifdef CLOCK_MONOTONIC_RAW
|
|
PyModule_AddIntMacro(m, CLOCK_MONOTONIC_RAW);
|
|
#endif
|
|
#ifdef CLOCK_HIGHRES
|
|
PyModule_AddIntMacro(m, CLOCK_HIGHRES);
|
|
#endif
|
|
#ifdef CLOCK_PROCESS_CPUTIME_ID
|
|
PyModule_AddIntMacro(m, CLOCK_PROCESS_CPUTIME_ID);
|
|
#endif
|
|
#ifdef CLOCK_THREAD_CPUTIME_ID
|
|
PyModule_AddIntMacro(m, CLOCK_THREAD_CPUTIME_ID);
|
|
#endif
|
|
#endif /* HAVE_CLOCK_GETTIME */
|
|
}
|
|
|
|
|
|
static PyMethodDef time_methods[] = {
|
|
{"time", time_time, METH_NOARGS, time_doc},
|
|
#ifdef PYCLOCK
|
|
{"clock", time_clock, METH_NOARGS, clock_doc},
|
|
#endif
|
|
#ifdef HAVE_CLOCK_GETTIME
|
|
{"clock_gettime", time_clock_gettime, METH_VARARGS, clock_gettime_doc},
|
|
{"clock_settime", time_clock_settime, METH_VARARGS, clock_settime_doc},
|
|
{"clock_getres", time_clock_getres, METH_VARARGS, clock_getres_doc},
|
|
#endif
|
|
{"sleep", time_sleep, METH_VARARGS, sleep_doc},
|
|
{"gmtime", time_gmtime, METH_VARARGS, gmtime_doc},
|
|
{"localtime", time_localtime, METH_VARARGS, localtime_doc},
|
|
{"asctime", time_asctime, METH_VARARGS, asctime_doc},
|
|
{"ctime", time_ctime, METH_VARARGS, ctime_doc},
|
|
#ifdef HAVE_MKTIME
|
|
{"mktime", time_mktime, METH_O, mktime_doc},
|
|
#endif
|
|
#ifdef HAVE_STRFTIME
|
|
{"strftime", time_strftime, METH_VARARGS, strftime_doc},
|
|
#endif
|
|
{"strptime", time_strptime, METH_VARARGS, strptime_doc},
|
|
#ifdef HAVE_WORKING_TZSET
|
|
{"tzset", time_tzset, METH_NOARGS, tzset_doc},
|
|
#endif
|
|
#ifdef PYMONOTONIC
|
|
{"monotonic", time_monotonic, METH_NOARGS, monotonic_doc},
|
|
#endif
|
|
{"process_time", time_process_time, METH_NOARGS, process_time_doc},
|
|
{"perf_counter", time_perf_counter, METH_NOARGS, perf_counter_doc},
|
|
{"get_clock_info", time_get_clock_info, METH_VARARGS, get_clock_info_doc},
|
|
{NULL, NULL} /* sentinel */
|
|
};
|
|
|
|
|
|
PyDoc_STRVAR(module_doc,
|
|
"This module provides various functions to manipulate time values.\n\
|
|
\n\
|
|
There are two standard representations of time. One is the number\n\
|
|
of seconds since the Epoch, in UTC (a.k.a. GMT). It may be an integer\n\
|
|
or a floating point number (to represent fractions of seconds).\n\
|
|
The Epoch is system-defined; on Unix, it is generally January 1st, 1970.\n\
|
|
The actual value can be retrieved by calling gmtime(0).\n\
|
|
\n\
|
|
The other representation is a tuple of 9 integers giving local time.\n\
|
|
The tuple items are:\n\
|
|
year (including century, e.g. 1998)\n\
|
|
month (1-12)\n\
|
|
day (1-31)\n\
|
|
hours (0-23)\n\
|
|
minutes (0-59)\n\
|
|
seconds (0-59)\n\
|
|
weekday (0-6, Monday is 0)\n\
|
|
Julian day (day in the year, 1-366)\n\
|
|
DST (Daylight Savings Time) flag (-1, 0 or 1)\n\
|
|
If the DST flag is 0, the time is given in the regular time zone;\n\
|
|
if it is 1, the time is given in the DST time zone;\n\
|
|
if it is -1, mktime() should guess based on the date and time.\n\
|
|
\n\
|
|
Variables:\n\
|
|
\n\
|
|
timezone -- difference in seconds between UTC and local standard time\n\
|
|
altzone -- difference in seconds between UTC and local DST time\n\
|
|
daylight -- whether local time should reflect DST\n\
|
|
tzname -- tuple of (standard time zone name, DST time zone name)\n\
|
|
\n\
|
|
Functions:\n\
|
|
\n\
|
|
time() -- return current time in seconds since the Epoch as a float\n\
|
|
clock() -- return CPU time since process start as a float\n\
|
|
sleep() -- delay for a number of seconds given as a float\n\
|
|
gmtime() -- convert seconds since Epoch to UTC tuple\n\
|
|
localtime() -- convert seconds since Epoch to local time tuple\n\
|
|
asctime() -- convert time tuple to string\n\
|
|
ctime() -- convert time in seconds to string\n\
|
|
mktime() -- convert local time tuple to seconds since Epoch\n\
|
|
strftime() -- convert time tuple to string according to format specification\n\
|
|
strptime() -- parse string to time tuple according to format specification\n\
|
|
tzset() -- change the local timezone");
|
|
|
|
|
|
|
|
static struct PyModuleDef timemodule = {
|
|
PyModuleDef_HEAD_INIT,
|
|
"time",
|
|
module_doc,
|
|
-1,
|
|
time_methods,
|
|
NULL,
|
|
NULL,
|
|
NULL,
|
|
NULL
|
|
};
|
|
|
|
PyMODINIT_FUNC
|
|
PyInit_time(void)
|
|
{
|
|
PyObject *m;
|
|
m = PyModule_Create(&timemodule);
|
|
if (m == NULL)
|
|
return NULL;
|
|
|
|
/* Set, or reset, module variables like time.timezone */
|
|
PyInit_timezone(m);
|
|
|
|
if (!initialized) {
|
|
PyStructSequence_InitType(&StructTimeType,
|
|
&struct_time_type_desc);
|
|
|
|
#ifdef MS_WINDOWS
|
|
winver.dwOSVersionInfoSize = sizeof(winver);
|
|
if (!GetVersionEx((OSVERSIONINFO*)&winver)) {
|
|
Py_DECREF(m);
|
|
PyErr_SetFromWindowsErr(0);
|
|
return NULL;
|
|
}
|
|
#endif
|
|
}
|
|
Py_INCREF(&StructTimeType);
|
|
#ifdef HAVE_STRUCT_TM_TM_ZONE
|
|
PyModule_AddIntConstant(m, "_STRUCT_TM_ITEMS", 11);
|
|
#else
|
|
PyModule_AddIntConstant(m, "_STRUCT_TM_ITEMS", 9);
|
|
#endif
|
|
PyModule_AddObject(m, "struct_time", (PyObject*) &StructTimeType);
|
|
initialized = 1;
|
|
return m;
|
|
}
|
|
|
|
static PyObject*
|
|
floattime(_Py_clock_info_t *info)
|
|
{
|
|
_PyTime_timeval t;
|
|
#ifdef HAVE_CLOCK_GETTIME
|
|
struct timespec tp;
|
|
int ret;
|
|
|
|
/* _PyTime_gettimeofday() does not use clock_gettime()
|
|
because it would require to link Python to the rt (real-time)
|
|
library, at least on Linux */
|
|
ret = clock_gettime(CLOCK_REALTIME, &tp);
|
|
if (ret == 0) {
|
|
if (info) {
|
|
struct timespec res;
|
|
info->implementation = "clock_gettime(CLOCK_REALTIME)";
|
|
info->monotonic = 0;
|
|
info->adjustable = 1;
|
|
if (clock_getres(CLOCK_REALTIME, &res) == 0)
|
|
info->resolution = res.tv_sec + res.tv_nsec * 1e-9;
|
|
else
|
|
info->resolution = 1e-9;
|
|
}
|
|
return PyFloat_FromDouble(tp.tv_sec + tp.tv_nsec * 1e-9);
|
|
}
|
|
#endif
|
|
_PyTime_gettimeofday_info(&t, info);
|
|
return PyFloat_FromDouble((double)t.tv_sec + t.tv_usec * 1e-6);
|
|
}
|
|
|
|
|
|
/* Implement floatsleep() for various platforms.
|
|
When interrupted (or when another error occurs), return -1 and
|
|
set an exception; else return 0. */
|
|
|
|
static int
|
|
floatsleep(double secs)
|
|
{
|
|
/* XXX Should test for MS_WINDOWS first! */
|
|
#if defined(HAVE_SELECT) && !defined(__EMX__)
|
|
struct timeval t;
|
|
double frac;
|
|
int err;
|
|
|
|
frac = fmod(secs, 1.0);
|
|
secs = floor(secs);
|
|
t.tv_sec = (long)secs;
|
|
t.tv_usec = (long)(frac*1000000.0);
|
|
Py_BEGIN_ALLOW_THREADS
|
|
err = select(0, (fd_set *)0, (fd_set *)0, (fd_set *)0, &t);
|
|
Py_END_ALLOW_THREADS
|
|
if (err != 0) {
|
|
#ifdef EINTR
|
|
if (errno == EINTR) {
|
|
if (PyErr_CheckSignals())
|
|
return -1;
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
PyErr_SetFromErrno(PyExc_IOError);
|
|
return -1;
|
|
}
|
|
}
|
|
#elif defined(__WATCOMC__) && !defined(__QNX__)
|
|
/* XXX Can't interrupt this sleep */
|
|
Py_BEGIN_ALLOW_THREADS
|
|
delay((int)(secs * 1000 + 0.5)); /* delay() uses milliseconds */
|
|
Py_END_ALLOW_THREADS
|
|
#elif defined(MS_WINDOWS)
|
|
{
|
|
double millisecs = secs * 1000.0;
|
|
unsigned long ul_millis;
|
|
|
|
if (millisecs > (double)ULONG_MAX) {
|
|
PyErr_SetString(PyExc_OverflowError,
|
|
"sleep length is too large");
|
|
return -1;
|
|
}
|
|
Py_BEGIN_ALLOW_THREADS
|
|
/* Allow sleep(0) to maintain win32 semantics, and as decreed
|
|
* by Guido, only the main thread can be interrupted.
|
|
*/
|
|
ul_millis = (unsigned long)millisecs;
|
|
if (ul_millis == 0 || !_PyOS_IsMainThread())
|
|
Sleep(ul_millis);
|
|
else {
|
|
DWORD rc;
|
|
HANDLE hInterruptEvent = _PyOS_SigintEvent();
|
|
ResetEvent(hInterruptEvent);
|
|
rc = WaitForSingleObjectEx(hInterruptEvent, ul_millis, FALSE);
|
|
if (rc == WAIT_OBJECT_0) {
|
|
Py_BLOCK_THREADS
|
|
errno = EINTR;
|
|
PyErr_SetFromErrno(PyExc_IOError);
|
|
return -1;
|
|
}
|
|
}
|
|
Py_END_ALLOW_THREADS
|
|
}
|
|
#else
|
|
/* XXX Can't interrupt this sleep */
|
|
Py_BEGIN_ALLOW_THREADS
|
|
sleep((int)secs);
|
|
Py_END_ALLOW_THREADS
|
|
#endif
|
|
|
|
return 0;
|
|
}
|