| /* 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__ */ |
| |
| /* 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 PyObject* |
| win_perf_counter(_Py_clock_info_t *info) |
| { |
| 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) { |
| PyErr_SetFromWindowsErr(0); |
| return NULL; |
| } |
| 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; |
| } |
| return PyFloat_FromDouble(diff / (double)cpu_frequency); |
| } |
| #endif |
| |
| #if defined(WIN32_PERF_COUNTER) || defined(HAVE_CLOCK) |
| #define PYCLOCK |
| static PyObject* |
| pyclock(_Py_clock_info_t *info) |
| { |
| #ifdef WIN32_PERF_COUNTER |
| return win_perf_counter(info); |
| #else |
| return floatclock(info); |
| #endif |
| } |
| |
| 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_OSError); |
| 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; |
| time_t tv_sec; |
| long tv_nsec; |
| struct timespec tp; |
| int ret; |
| |
| if (!PyArg_ParseTuple(args, "iO:clock_settime", &clk_id, &obj)) |
| return NULL; |
| |
| if (_PyTime_ObjectToTimespec(obj, &tv_sec, &tv_nsec, _PyTime_ROUND_DOWN) == -1) |
| return NULL; |
| tp.tv_sec = tv_sec; |
| tp.tv_nsec = tv_nsec; |
| |
| ret = clock_settime((clockid_t)clk_id, &tp); |
| if (ret != 0) { |
| PyErr_SetFromErrno(PyExc_OSError); |
| 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_OSError); |
| 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, _PyTime_ROUND_DOWN) == -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) || defined(_AIX) |
| 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; |
| } |
| if ((outbuf[1] == 'y') && buf.tm_year < 0) |
| { |
| PyErr_SetString(PyExc_ValueError, |
| "format %y requires year >= 1900 on Windows"); |
| Py_DECREF(format); |
| return NULL; |
| } |
| } |
| #elif (defined(_AIX) || defined(sun)) && defined(HAVE_WCSFTIME) |
| for(outbuf = wcschr(fmt, '%'); |
| outbuf != NULL; |
| outbuf = wcschr(outbuf+2, '%')) |
| { |
| /* Issue #19634: On AIX, wcsftime("y", (1899, 1, 1, 0, 0, 0, 0, 0, 0)) |
| returns "0/" instead of "99" */ |
| if (outbuf[1] == L'y' && buf.tm_year < 0) { |
| PyErr_SetString(PyExc_ValueError, |
| "format %y requires year >= 1900 on AIX"); |
| 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; |
| #ifdef _AIX |
| /* year < 1902 or year > 2037 */ |
| if (buf.tm_year < 2 || buf.tm_year > 137) { |
| /* Issue #19748: On AIX, mktime() doesn't report overflow error for |
| * timestamp < -2^31 or timestamp > 2**31-1. */ |
| PyErr_SetString(PyExc_OverflowError, |
| "mktime argument out of range"); |
| return NULL; |
| } |
| #else |
| buf.tm_wday = -1; /* sentinel; original value ignored */ |
| #endif |
| 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) |
| #ifndef _AIX |
| /* Return value of -1 does not necessarily mean an error, but |
| * tm_wday cannot remain set to -1 if mktime succeeded. */ |
| && buf.tm_wday == -1 |
| #else |
| /* on AIX, tm_wday is always sets, even on error */ |
| #endif |
| ) |
| { |
| 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); |
| if (PyErr_Occurred()) |
| return NULL; |
| |
| 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 */ |
| |
| static PyObject * |
| pymonotonic(_Py_clock_info_t *info) |
| { |
| _PyTime_timeval tv; |
| if (_PyTime_monotonic_info(&tv, info) < 0) { |
| assert(info != NULL); |
| return NULL; |
| } |
| return PyFloat_FromDouble((double)tv.tv_sec + tv.tv_usec * 1e-6); |
| } |
| |
| static PyObject * |
| time_monotonic(PyObject *self, PyObject *unused) |
| { |
| return pymonotonic(NULL); |
| } |
| |
| PyDoc_STRVAR(monotonic_doc, |
| "monotonic() -> float\n\ |
| \n\ |
| Monotonic clock, cannot go backward."); |
| |
| static PyObject* |
| perf_counter(_Py_clock_info_t *info) |
| { |
| #ifdef WIN32_PERF_COUNTER |
| return win_perf_counter(info); |
| #else |
| return pymonotonic(info); |
| #endif |
| } |
| |
| 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 |
| else if (strcmp(name, "monotonic") == 0) |
| obj = pymonotonic(&info); |
| 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 |
| {"monotonic", time_monotonic, METH_NOARGS, monotonic_doc}, |
| {"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) { |
| if (PyStructSequence_InitType2(&StructTimeType, |
| &struct_time_type_desc) < 0) |
| return NULL; |
| |
| #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; |
| if (_PyTime_gettimeofday_info(&t, info) < 0) { |
| assert(info != NULL); |
| return NULL; |
| } |
| 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_OSError); |
| 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_OSError); |
| 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; |
| } |