Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 | /*********************************************************** |
Guido van Rossum | 524b588 | 1995-01-04 19:10:35 +0000 | [diff] [blame] | 2 | Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam, |
| 3 | The Netherlands. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 4 | |
| 5 | All Rights Reserved |
| 6 | |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 7 | Permission to use, copy, modify, and distribute this software and its |
| 8 | documentation for any purpose and without fee is hereby granted, |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 9 | provided that the above copyright notice appear in all copies and that |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 10 | both that copyright notice and this permission notice appear in |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 11 | supporting documentation, and that the names of Stichting Mathematisch |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 12 | Centrum or CWI or Corporation for National Research Initiatives or |
| 13 | CNRI not be used in advertising or publicity pertaining to |
| 14 | distribution of the software without specific, written prior |
| 15 | permission. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 16 | |
Guido van Rossum | d266eb4 | 1996-10-25 14:44:06 +0000 | [diff] [blame] | 17 | While CWI is the initial source for this software, a modified version |
| 18 | is made available by the Corporation for National Research Initiatives |
| 19 | (CNRI) at the Internet address ftp://ftp.python.org. |
| 20 | |
| 21 | STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH |
| 22 | REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF |
| 23 | MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH |
| 24 | CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL |
| 25 | DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR |
| 26 | PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| 27 | TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| 28 | PERFORMANCE OF THIS SOFTWARE. |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 29 | |
| 30 | ******************************************************************/ |
| 31 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 32 | /* Time module */ |
| 33 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 34 | #include "Python.h" |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 35 | |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 36 | #include <ctype.h> |
| 37 | |
Guido van Rossum | 99d90c0 | 1996-08-08 19:17:45 +0000 | [diff] [blame] | 38 | #ifdef HAVE_SELECT |
| 39 | #include "mymath.h" |
| 40 | #endif |
| 41 | |
Guido van Rossum | 6d946f9 | 1992-08-14 13:49:30 +0000 | [diff] [blame] | 42 | #ifdef macintosh |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 43 | #include <time.h> |
| 44 | #else |
| 45 | #include <sys/types.h> |
Guido van Rossum | 6d946f9 | 1992-08-14 13:49:30 +0000 | [diff] [blame] | 46 | #endif |
| 47 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 48 | #ifdef QUICKWIN |
| 49 | #include <io.h> |
| 50 | #endif |
| 51 | |
| 52 | #ifdef HAVE_UNISTD_H |
Guido van Rossum | 2762f25 | 1992-03-27 17:22:13 +0000 | [diff] [blame] | 53 | #include <unistd.h> |
| 54 | #endif |
| 55 | |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 56 | #if defined(HAVE_SELECT) && !defined(__BEOS__) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 57 | #include "myselect.h" |
| 58 | #else |
| 59 | #include "mytime.h" |
| 60 | #endif |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 61 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 62 | #ifdef HAVE_FTIME |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 63 | #ifndef __BEOS__ |
| 64 | /* We have ftime(), but not in the headers (PR2). - [cjh] */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 65 | #include <sys/timeb.h> |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 66 | #endif |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 67 | #if !defined(MS_WINDOWS) && !defined(PYOS_OS2) |
Guido van Rossum | 1bb126f | 1996-12-06 20:17:44 +0000 | [diff] [blame] | 68 | extern int ftime(); |
Guido van Rossum | 5217457 | 1996-12-09 18:38:52 +0000 | [diff] [blame] | 69 | #endif /* MS_WINDOWS */ |
| 70 | #endif /* HAVE_FTIME */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 71 | |
Guido van Rossum | 7bf22de | 1997-12-02 20:34:19 +0000 | [diff] [blame] | 72 | #if defined(__WATCOMC__) && !defined(__QNX__) |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 73 | #include <i86.h> |
| 74 | #else |
Guido van Rossum | cac6c72 | 1996-09-06 13:34:02 +0000 | [diff] [blame] | 75 | #ifdef MS_WINDOWS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 76 | #include <windows.h> |
Guido van Rossum | b2fb364 | 1996-09-07 00:47:35 +0000 | [diff] [blame] | 77 | #ifdef MS_WIN16 |
| 78 | /* These overrides not needed for Win32 */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 79 | #define timezone _timezone |
Guido van Rossum | cc08112 | 1995-03-14 15:05:41 +0000 | [diff] [blame] | 80 | #define tzname _tzname |
| 81 | #define daylight _daylight |
| 82 | #define altzone _altzone |
Guido van Rossum | b2fb364 | 1996-09-07 00:47:35 +0000 | [diff] [blame] | 83 | #endif /* MS_WIN16 */ |
Guido van Rossum | cac6c72 | 1996-09-06 13:34:02 +0000 | [diff] [blame] | 84 | #endif /* MS_WINDOWS */ |
Guido van Rossum | 7bf22de | 1997-12-02 20:34:19 +0000 | [diff] [blame] | 85 | #endif /* !__WATCOMC__ || __QNX__ */ |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 86 | |
Guido van Rossum | 3917c22 | 1997-04-02 05:35:28 +0000 | [diff] [blame] | 87 | #ifdef MS_WIN32 |
| 88 | /* Win32 has better clock replacement */ |
| 89 | #include <largeint.h> |
| 90 | #undef HAVE_CLOCK /* We have our own version down below */ |
| 91 | #endif /* MS_WIN32 */ |
| 92 | |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 93 | #if defined(PYOS_OS2) |
| 94 | #define INCL_DOS |
| 95 | #define INCL_DOSERRORS |
| 96 | #define INCL_NOPMAPI |
| 97 | #include <os2.h> |
| 98 | #endif |
| 99 | |
| 100 | #if defined(PYCC_VACPP) |
| 101 | #include <time.h> |
| 102 | #define timezone _timezone |
| 103 | #endif |
| 104 | |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 105 | #ifdef __BEOS__ |
| 106 | /* For bigtime_t, snooze(). - [cjh] */ |
| 107 | #include <support/SupportDefs.h> |
| 108 | #include <kernel/OS.h> |
| 109 | #endif |
| 110 | |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 111 | /* Forward declarations */ |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 112 | static int floatsleep Py_PROTO((double)); |
| 113 | static double floattime Py_PROTO(()); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 114 | |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 115 | /* For Y2K check */ |
| 116 | static PyObject *moddict; |
| 117 | |
Guido van Rossum | e6a4b7b | 1997-10-08 15:27:56 +0000 | [diff] [blame] | 118 | #ifdef macintosh |
| 119 | /* Our own timezone. We have enough information to deduce whether |
| 120 | ** DST is on currently, but unfortunately we cannot put it to good |
| 121 | ** use because we don't know the rules (and that is needed to have |
| 122 | ** localtime() return correct tm_isdst values for times other than |
| 123 | ** the current time. So, we cop out and only tell the user the current |
| 124 | ** timezone. |
| 125 | */ |
| 126 | static long timezone; |
| 127 | |
| 128 | static void |
| 129 | initmactimezone() |
| 130 | { |
| 131 | MachineLocation loc; |
| 132 | long delta; |
| 133 | |
| 134 | ReadLocation(&loc); |
| 135 | |
| 136 | if (loc.latitude == 0 && loc.longitude == 0 && loc.u.gmtDelta == 0) |
| 137 | return; |
| 138 | |
| 139 | delta = loc.u.gmtDelta & 0x00FFFFFF; |
| 140 | |
| 141 | if (delta & 0x00800000) |
| 142 | delta |= 0xFF000000; |
| 143 | |
| 144 | timezone = -delta; |
| 145 | } |
| 146 | #endif /* macintosh */ |
| 147 | |
| 148 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 149 | static PyObject * |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 150 | time_time(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 151 | PyObject *self; |
| 152 | PyObject *args; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 153 | { |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 154 | double secs; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 155 | if (!PyArg_NoArgs(args)) |
Guido van Rossum | a2b7f40 | 1993-01-04 09:09:59 +0000 | [diff] [blame] | 156 | return NULL; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 157 | secs = floattime(); |
| 158 | if (secs == 0.0) { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 159 | PyErr_SetFromErrno(PyExc_IOError); |
Guido van Rossum | a2b7f40 | 1993-01-04 09:09:59 +0000 | [diff] [blame] | 160 | return NULL; |
| 161 | } |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 162 | return PyFloat_FromDouble(secs); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 163 | } |
| 164 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 165 | static char time_doc[] = |
| 166 | "time() -> floating point number\n\ |
| 167 | \n\ |
| 168 | Return the current time in seconds since the Epoch.\n\ |
| 169 | Fractions of a second may be present if the system clock provides them."; |
| 170 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 171 | #ifdef HAVE_CLOCK |
| 172 | |
| 173 | #ifndef CLOCKS_PER_SEC |
Guido van Rossum | 1b66a4f | 1996-02-25 04:50:33 +0000 | [diff] [blame] | 174 | #ifdef CLK_TCK |
| 175 | #define CLOCKS_PER_SEC CLK_TCK |
| 176 | #else |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 177 | #define CLOCKS_PER_SEC 1000000 |
| 178 | #endif |
Guido van Rossum | 1b66a4f | 1996-02-25 04:50:33 +0000 | [diff] [blame] | 179 | #endif |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 180 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 181 | static PyObject * |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 182 | time_clock(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 183 | PyObject *self; |
| 184 | PyObject *args; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 185 | { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 186 | if (!PyArg_NoArgs(args)) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 187 | return NULL; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 188 | return PyFloat_FromDouble(((double)clock()) / CLOCKS_PER_SEC); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 189 | } |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 190 | #endif /* HAVE_CLOCK */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 191 | |
Guido van Rossum | 3917c22 | 1997-04-02 05:35:28 +0000 | [diff] [blame] | 192 | #ifdef MS_WIN32 |
| 193 | /* Due to Mark Hammond */ |
| 194 | static PyObject * |
| 195 | time_clock(self, args) |
| 196 | PyObject *self; |
| 197 | PyObject *args; |
| 198 | { |
| 199 | static LARGE_INTEGER ctrStart; |
| 200 | static LARGE_INTEGER divisor = {0,0}; |
| 201 | LARGE_INTEGER now, diff, rem; |
| 202 | |
| 203 | if (!PyArg_NoArgs(args)) |
| 204 | return NULL; |
| 205 | |
| 206 | if (LargeIntegerEqualToZero(divisor)) { |
| 207 | QueryPerformanceCounter(&ctrStart); |
| 208 | if (!QueryPerformanceFrequency(&divisor) || |
| 209 | LargeIntegerEqualToZero(divisor)) { |
| 210 | /* Unlikely to happen - |
| 211 | this works on all intel machines at least! |
| 212 | Revert to clock() */ |
| 213 | return PyFloat_FromDouble(clock()); |
| 214 | } |
| 215 | } |
| 216 | QueryPerformanceCounter(&now); |
| 217 | diff = LargeIntegerSubtract(now, ctrStart); |
| 218 | diff = LargeIntegerDivide(diff, divisor, &rem); |
| 219 | /* XXX - we assume both divide results fit in 32 bits. This is |
| 220 | true on Intels. First person who can afford a machine that |
| 221 | doesnt deserves to fix it :-) |
| 222 | */ |
| 223 | return PyFloat_FromDouble((double)diff.LowPart + |
| 224 | ((double)rem.LowPart / (double)divisor.LowPart)); |
| 225 | } |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 226 | |
Guido van Rossum | 3917c22 | 1997-04-02 05:35:28 +0000 | [diff] [blame] | 227 | #define HAVE_CLOCK /* So it gets included in the methods */ |
| 228 | #endif /* MS_WIN32 */ |
| 229 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 230 | #ifdef HAVE_CLOCK |
| 231 | static char clock_doc[] = |
| 232 | "clock() -> floating point number\n\ |
| 233 | \n\ |
| 234 | Return the CPU time or real time since the start of the process or since\n\ |
| 235 | the first call to clock(). This has as much precision as the system records."; |
| 236 | #endif |
| 237 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 238 | static PyObject * |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 239 | time_sleep(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 240 | PyObject *self; |
| 241 | PyObject *args; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 242 | { |
Guido van Rossum | 775f4da | 1993-01-09 17:18:52 +0000 | [diff] [blame] | 243 | double secs; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 244 | if (!PyArg_Parse(args, "d", &secs)) |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 245 | return NULL; |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 246 | if (floatsleep(secs) != 0) |
| 247 | return NULL; |
| 248 | Py_INCREF(Py_None); |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 249 | return Py_None; |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 250 | } |
| 251 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 252 | static char sleep_doc[] = |
| 253 | "sleep(seconds)\n\ |
| 254 | \n\ |
| 255 | Delay execution for a given number of seconds. The argument may be\n\ |
| 256 | a floating point number for subsecond precision."; |
| 257 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 258 | static PyObject * |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 259 | tmtotuple(p) |
| 260 | struct tm *p; |
| 261 | { |
| 262 | return Py_BuildValue("(iiiiiiiii)", |
| 263 | p->tm_year + 1900, |
| 264 | p->tm_mon + 1, /* Want January == 1 */ |
| 265 | p->tm_mday, |
| 266 | p->tm_hour, |
| 267 | p->tm_min, |
| 268 | p->tm_sec, |
| 269 | (p->tm_wday + 6) % 7, /* Want Monday == 0 */ |
| 270 | p->tm_yday + 1, /* Want January, 1 == 1 */ |
| 271 | p->tm_isdst); |
| 272 | } |
| 273 | |
| 274 | static PyObject * |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 275 | time_convert(when, function) |
| 276 | time_t when; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 277 | struct tm * (*function) Py_PROTO((const time_t *)); |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 278 | { |
Guido van Rossum | 6e8583d | 1996-10-08 14:19:52 +0000 | [diff] [blame] | 279 | struct tm *p; |
| 280 | errno = 0; |
| 281 | p = function(&when); |
| 282 | if (p == NULL) { |
| 283 | #ifdef EINVAL |
Guido van Rossum | 0b1ff66 | 1996-11-02 17:31:22 +0000 | [diff] [blame] | 284 | if (errno == 0) |
Guido van Rossum | 6e8583d | 1996-10-08 14:19:52 +0000 | [diff] [blame] | 285 | errno = EINVAL; |
| 286 | #endif |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 287 | return PyErr_SetFromErrno(PyExc_IOError); |
Guido van Rossum | 6e8583d | 1996-10-08 14:19:52 +0000 | [diff] [blame] | 288 | } |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 289 | return tmtotuple(p); |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 290 | } |
| 291 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 292 | static PyObject * |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 293 | time_gmtime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 294 | PyObject *self; |
| 295 | PyObject *args; |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 296 | { |
| 297 | double when; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 298 | if (!PyArg_Parse(args, "d", &when)) |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 299 | return NULL; |
| 300 | return time_convert((time_t)when, gmtime); |
| 301 | } |
| 302 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 303 | static char gmtime_doc[] = |
| 304 | "gmtime(seconds) -> tuple\n\ |
| 305 | \n\ |
| 306 | Convert seconds since the Epoch to a time tuple expressing UTC (a.k.a. GMT)."; |
| 307 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 308 | static PyObject * |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 309 | time_localtime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 310 | PyObject *self; |
| 311 | PyObject *args; |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 312 | { |
| 313 | double when; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 314 | if (!PyArg_Parse(args, "d", &when)) |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 315 | return NULL; |
| 316 | return time_convert((time_t)when, localtime); |
| 317 | } |
| 318 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 319 | static char localtime_doc[] = |
| 320 | "localtime(seconds) -> tuple\n\ |
| 321 | Convert seconds since the Epoch to a time tuple expressing local time."; |
| 322 | |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 323 | static int |
| 324 | gettmarg(args, p) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 325 | PyObject *args; |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 326 | struct tm *p; |
| 327 | { |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 328 | int y; |
| 329 | memset((ANY *) p, '\0', sizeof(struct tm)); |
| 330 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 331 | if (!PyArg_Parse(args, "(iiiiiiiii)", |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 332 | &y, |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 333 | &p->tm_mon, |
| 334 | &p->tm_mday, |
| 335 | &p->tm_hour, |
| 336 | &p->tm_min, |
| 337 | &p->tm_sec, |
| 338 | &p->tm_wday, |
| 339 | &p->tm_yday, |
| 340 | &p->tm_isdst)) |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 341 | return 0; |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 342 | if (y < 1900) { |
| 343 | PyObject *accept = PyDict_GetItemString(moddict, |
| 344 | "accept2dyear"); |
| 345 | if (accept == NULL || !PyInt_Check(accept) || |
| 346 | PyInt_AsLong(accept) == 0) { |
| 347 | PyErr_SetString(PyExc_ValueError, |
| 348 | "year >= 1900 required"); |
| 349 | return 0; |
| 350 | } |
| 351 | if (69 <= y && y <= 99) |
| 352 | y += 1900; |
| 353 | else if (0 <= y && y <= 68) |
| 354 | y += 2000; |
| 355 | else { |
| 356 | PyErr_SetString(PyExc_ValueError, |
| 357 | "year out of range (00-99, 1900-*)"); |
| 358 | return 0; |
| 359 | } |
| 360 | } |
| 361 | p->tm_year = y - 1900; |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 362 | p->tm_mon--; |
| 363 | p->tm_wday = (p->tm_wday + 1) % 7; |
| 364 | p->tm_yday--; |
| 365 | return 1; |
| 366 | } |
| 367 | |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 368 | #ifdef HAVE_STRFTIME |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 369 | static PyObject * |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 370 | time_strftime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 371 | PyObject *self; |
| 372 | PyObject *args; |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 373 | { |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 374 | PyObject *tup; |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 375 | struct tm buf; |
| 376 | const char *fmt; |
| 377 | char *outbuf = 0; |
| 378 | int i; |
| 379 | |
Guido van Rossum | 1f41f84 | 1998-04-27 19:04:26 +0000 | [diff] [blame] | 380 | memset((ANY *) &buf, '\0', sizeof(buf)); |
| 381 | |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 382 | if (!PyArg_ParseTuple(args, "sO", &fmt, &tup) || !gettmarg(tup, &buf)) |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 383 | return NULL; |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 384 | /* I hate these functions that presume you know how big the output |
| 385 | * will be ahead of time... |
| 386 | */ |
Guido van Rossum | a78bfe1 | 1997-02-14 16:35:10 +0000 | [diff] [blame] | 387 | for (i = 1024 ; i <= 8192 ; i += 1024) { |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 388 | outbuf = malloc(i); |
| 389 | if (outbuf == NULL) { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 390 | return PyErr_NoMemory(); |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 391 | } |
| 392 | if (strftime(outbuf, i-1, fmt, &buf) != 0) { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 393 | PyObject *ret; |
| 394 | ret = PyString_FromString(outbuf); |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 395 | free(outbuf); |
| 396 | return ret; |
| 397 | } |
| 398 | free(outbuf); |
| 399 | } |
Guido van Rossum | a78bfe1 | 1997-02-14 16:35:10 +0000 | [diff] [blame] | 400 | PyErr_SetString(PyExc_ValueError, |
| 401 | "bad strftime format or result too big"); |
| 402 | return NULL; |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 403 | } |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 404 | |
| 405 | static char strftime_doc[] = |
| 406 | "strftime(format, tuple) -> string\n\ |
| 407 | \n\ |
| 408 | Convert a time tuple to a string according to a format specification.\n\ |
| 409 | See the library reference manual for formatting codes."; |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 410 | #endif /* HAVE_STRFTIME */ |
| 411 | |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 412 | #ifdef HAVE_STRPTIME |
| 413 | static PyObject * |
| 414 | time_strptime(self, args) |
| 415 | PyObject *self; |
| 416 | PyObject *args; |
| 417 | { |
| 418 | struct tm tm; |
| 419 | char *fmt = "%a %b %d %H:%M:%S %Y"; |
| 420 | char *buf; |
| 421 | char *s; |
| 422 | |
| 423 | if (!PyArg_ParseTuple(args, "s|s", &buf, &fmt)) { |
| 424 | PyErr_SetString(PyExc_ValueError, "invalid argument"); |
| 425 | return NULL; |
| 426 | } |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 427 | memset((ANY *) &tm, '\0', sizeof(tm)); |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 428 | s = strptime(buf, fmt, &tm); |
| 429 | if (s == NULL) { |
| 430 | PyErr_SetString(PyExc_ValueError, "format mismatch"); |
| 431 | return NULL; |
| 432 | } |
| 433 | while (*s && isspace(*s)) |
| 434 | s++; |
| 435 | if (*s) { |
| 436 | PyErr_Format(PyExc_ValueError, |
| 437 | "unconverted data remains: '%.400s'", s); |
| 438 | return NULL; |
| 439 | } |
| 440 | return tmtotuple(&tm); |
| 441 | } |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 442 | |
| 443 | static char strptime_doc[] = |
| 444 | "strptime(format, string) -> tuple\n\ |
| 445 | Parse a string to a time tuple according to a format specification.\n\ |
| 446 | See the library reference manual for formatting codes (same as strftime())."; |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 447 | #endif /* HAVE_STRPTIME */ |
| 448 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 449 | static PyObject * |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 450 | time_asctime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 451 | PyObject *self; |
| 452 | PyObject *args; |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 453 | { |
| 454 | struct tm buf; |
| 455 | char *p; |
| 456 | if (!gettmarg(args, &buf)) |
| 457 | return NULL; |
| 458 | p = asctime(&buf); |
| 459 | if (p[24] == '\n') |
| 460 | p[24] = '\0'; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 461 | return PyString_FromString(p); |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 462 | } |
| 463 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 464 | static char asctime_doc[] = |
| 465 | "asctime(tuple) -> string\n\ |
| 466 | \n\ |
| 467 | Convert a time tuple to a string, e.g. 'Sat Jun 06 16:26:11 1998'."; |
| 468 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 469 | static PyObject * |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 470 | time_ctime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 471 | PyObject *self; |
| 472 | PyObject *args; |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 473 | { |
| 474 | double dt; |
| 475 | time_t tt; |
| 476 | char *p; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 477 | if (!PyArg_Parse(args, "d", &dt)) |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 478 | return NULL; |
Guido van Rossum | cac6c72 | 1996-09-06 13:34:02 +0000 | [diff] [blame] | 479 | tt = (time_t)dt; |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 480 | p = ctime(&tt); |
Guido van Rossum | 7853570 | 1998-03-03 22:19:10 +0000 | [diff] [blame] | 481 | if (p == NULL) { |
| 482 | PyErr_SetString(PyExc_ValueError, "unconvertible time"); |
| 483 | return NULL; |
| 484 | } |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 485 | if (p[24] == '\n') |
| 486 | p[24] = '\0'; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 487 | return PyString_FromString(p); |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 488 | } |
| 489 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 490 | static char ctime_doc[] = |
| 491 | "ctime(seconds) -> string\n\ |
| 492 | \n\ |
| 493 | Convert a time in seconds since the Epoch to a string in local time.\n\ |
| 494 | This is equivalent to asctime(localtime(seconds))."; |
| 495 | |
Guido van Rossum | 60cd813 | 1998-03-06 17:16:21 +0000 | [diff] [blame] | 496 | #ifdef HAVE_MKTIME |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 497 | static PyObject * |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 498 | time_mktime(self, args) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 499 | PyObject *self; |
| 500 | PyObject *args; |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 501 | { |
| 502 | struct tm buf; |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 503 | time_t tt; |
| 504 | tt = time(&tt); |
| 505 | buf = *localtime(&tt); |
Guido van Rossum | 9e90a67 | 1993-06-24 11:10:19 +0000 | [diff] [blame] | 506 | if (!gettmarg(args, &buf)) |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 507 | return NULL; |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 508 | tt = mktime(&buf); |
| 509 | if (tt == (time_t)(-1)) { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 510 | PyErr_SetString(PyExc_OverflowError, |
| 511 | "mktime argument out of range"); |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 512 | return NULL; |
| 513 | } |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 514 | return PyFloat_FromDouble((double)tt); |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 515 | } |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 516 | |
| 517 | static char mktime_doc[] = |
| 518 | "mktime(tuple) -> floating point number\n\ |
| 519 | \n\ |
| 520 | Convert a time tuple in local time to seconds since the Epoch."; |
Guido van Rossum | 60cd813 | 1998-03-06 17:16:21 +0000 | [diff] [blame] | 521 | #endif /* HAVE_MKTIME */ |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 522 | |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 523 | static PyMethodDef time_methods[] = { |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 524 | {"time", time_time, 0, time_doc}, |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 525 | #ifdef HAVE_CLOCK |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 526 | {"clock", time_clock, 0, clock_doc}, |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 527 | #endif |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 528 | {"sleep", time_sleep, 0, sleep_doc}, |
| 529 | {"gmtime", time_gmtime, 0, gmtime_doc}, |
| 530 | {"localtime", time_localtime, 0, localtime_doc}, |
| 531 | {"asctime", time_asctime, 0, asctime_doc}, |
| 532 | {"ctime", time_ctime, 0, ctime_doc}, |
Guido van Rossum | 60cd813 | 1998-03-06 17:16:21 +0000 | [diff] [blame] | 533 | #ifdef HAVE_MKTIME |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 534 | {"mktime", time_mktime, 0, mktime_doc}, |
Guido van Rossum | 60cd813 | 1998-03-06 17:16:21 +0000 | [diff] [blame] | 535 | #endif |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 536 | #ifdef HAVE_STRFTIME |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 537 | {"strftime", time_strftime, 1, strftime_doc}, |
Guido van Rossum | 8d8c1ee | 1995-09-13 17:38:35 +0000 | [diff] [blame] | 538 | #endif |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 539 | #ifdef HAVE_STRPTIME |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 540 | {"strptime", time_strptime, 1, strptime_doc}, |
Guido van Rossum | 87ce7bb | 1998-06-09 16:30:31 +0000 | [diff] [blame] | 541 | #endif |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 542 | {NULL, NULL} /* sentinel */ |
| 543 | }; |
| 544 | |
Guido van Rossum | 8239f0f | 1995-01-22 00:49:01 +0000 | [diff] [blame] | 545 | static void |
| 546 | ins(d, name, v) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 547 | PyObject *d; |
Guido van Rossum | 8239f0f | 1995-01-22 00:49:01 +0000 | [diff] [blame] | 548 | char *name; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 549 | PyObject *v; |
Guido van Rossum | 8239f0f | 1995-01-22 00:49:01 +0000 | [diff] [blame] | 550 | { |
| 551 | if (v == NULL) |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 552 | Py_FatalError("Can't initialize time module -- NULL value"); |
| 553 | if (PyDict_SetItemString(d, name, v) != 0) |
| 554 | Py_FatalError( |
Guido van Rossum | 5217457 | 1996-12-09 18:38:52 +0000 | [diff] [blame] | 555 | "Can't initialize time module -- PyDict_SetItemString failed"); |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 556 | Py_DECREF(v); |
Guido van Rossum | 8239f0f | 1995-01-22 00:49:01 +0000 | [diff] [blame] | 557 | } |
| 558 | |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 559 | static char module_doc[] = |
| 560 | "This module provides various functions to manipulate time values.\n\ |
| 561 | \n\ |
| 562 | There are two standard representations of time. One is the number\n\ |
| 563 | of seconds since the Epoch, in UTC (a.k.a. GMT). It may be an integer\n\ |
| 564 | or a floating point number (to represent fractions of seconds).\n\ |
| 565 | The Epoch is system-defined; on Unix, it is generally January 1st, 1970.\n\ |
| 566 | The actual value can be retrieved by calling gmtime(0).\n\ |
| 567 | \n\ |
| 568 | The other representation is a tuple of 9 integers giving local time.\n\ |
| 569 | The tuple items are:\n\ |
| 570 | year (four digits, e.g. 1998)\n\ |
| 571 | month (1-12)\n\ |
| 572 | day (1-31)\n\ |
| 573 | hours (0-23)\n\ |
| 574 | minutes (0-59)\n\ |
| 575 | seconds (0-61, to allow for leap seconds)\n\ |
| 576 | weekday (0-6, Monday is 0)\n\ |
| 577 | Julian day (day in the year, 1-366)\n\ |
| 578 | DST (Daylight Savings Time) flag (-1, 0 or 1)\n\ |
| 579 | If the DST flag is 0, the time is given in the regular time zone;\n\ |
| 580 | if it is 1, the time is given in the DST time zone;\n\ |
| 581 | if it is -1, mktime() should guess based on the date and time.\n\ |
| 582 | \n\ |
| 583 | Variables:\n\ |
| 584 | \n\ |
| 585 | timezone -- difference in seconds between UTC and local standard time\n\ |
| 586 | altzone -- difference in seconds between UTC and local DST time\n\ |
| 587 | daylight -- whether local time should reflect DST\n\ |
| 588 | tzname -- tuple of (standard time zone name, DST time zone name)\n\ |
| 589 | \n\ |
| 590 | Functions:\n\ |
| 591 | \n\ |
| 592 | time() -- return current time in seconds since the Epoch as a float\n\ |
| 593 | clock() -- return CPU time since process start as a float\n\ |
| 594 | sleep() -- delay for a number of seconds given as a float\n\ |
| 595 | gmtime() -- convert seconds since Epoch to UTC tuple\n\ |
| 596 | localtime() -- convert seconds since Epoch to local time tuple\n\ |
| 597 | asctime() -- convert time tuple to string\n\ |
| 598 | ctime() -- convert time in seconds to string\n\ |
| 599 | mktime() -- convert local time tuple to seconds since Epoch\n\ |
| 600 | strftime() -- convert time tuple to string according to format specification\n\ |
| 601 | strptime() -- parse string to time tuple according to format specification\n\ |
| 602 | "; |
| 603 | |
| 604 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 605 | void |
| 606 | inittime() |
| 607 | { |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 608 | PyObject *m, *d; |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 609 | char *p; |
Guido van Rossum | 0ef577b | 1998-06-27 20:38:36 +0000 | [diff] [blame] | 610 | m = Py_InitModule3("time", time_methods, module_doc); |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 611 | d = PyModule_GetDict(m); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 612 | #ifdef HAVE_TZNAME |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 613 | tzset(); |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 614 | ins(d, "timezone", PyInt_FromLong((long)timezone)); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 615 | #ifdef HAVE_ALTZONE |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 616 | ins(d, "altzone", PyInt_FromLong((long)altzone)); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 617 | #else |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 618 | ins(d, "altzone", PyInt_FromLong((long)timezone-3600)); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 619 | #endif |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 620 | ins(d, "daylight", PyInt_FromLong((long)daylight)); |
| 621 | ins(d, "tzname", Py_BuildValue("(zz)", tzname[0], tzname[1])); |
Guido van Rossum | cfbaecc | 1998-08-25 14:51:12 +0000 | [diff] [blame^] | 622 | /* Accept 2-digit dates unless PYTHONY2K is set and non-empty */ |
| 623 | p = getenv("PYTHONY2K"); |
| 624 | ins(d, "accept2dyear", PyInt_FromLong((long) (!p || !*p))); |
| 625 | /* Squirrel away the module's dictionary for the y2k check */ |
| 626 | Py_INCREF(d); |
| 627 | moddict = d; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 628 | #else /* !HAVE_TZNAME */ |
| 629 | #if HAVE_TM_ZONE |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 630 | { |
| 631 | #define YEAR ((time_t)((365 * 24 + 6) * 3600)) |
| 632 | time_t t; |
| 633 | struct tm *p; |
| 634 | long winterzone, summerzone; |
| 635 | char wintername[10], summername[10]; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 636 | /* XXX This won't work on the southern hemisphere. |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 637 | XXX Anybody got a better idea? */ |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 638 | t = (time((time_t *)0) / YEAR) * YEAR; |
| 639 | p = localtime(&t); |
| 640 | winterzone = -p->tm_gmtoff; |
| 641 | strncpy(wintername, p->tm_zone ? p->tm_zone : " ", 9); |
| 642 | wintername[9] = '\0'; |
| 643 | t += YEAR/2; |
| 644 | p = localtime(&t); |
| 645 | summerzone = -p->tm_gmtoff; |
| 646 | strncpy(summername, p->tm_zone ? p->tm_zone : " ", 9); |
| 647 | summername[9] = '\0'; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 648 | ins(d, "timezone", PyInt_FromLong(winterzone)); |
| 649 | ins(d, "altzone", PyInt_FromLong(summerzone)); |
| 650 | ins(d, "daylight", |
| 651 | PyInt_FromLong((long)(winterzone != summerzone))); |
| 652 | ins(d, "tzname", |
| 653 | Py_BuildValue("(zz)", wintername, summername)); |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 654 | } |
Guido van Rossum | e6a4b7b | 1997-10-08 15:27:56 +0000 | [diff] [blame] | 655 | #else |
| 656 | #ifdef macintosh |
Guido van Rossum | be1eb0d | 1997-12-08 21:56:43 +0000 | [diff] [blame] | 657 | /* The only thing we can obtain is the current timezone |
| 658 | ** (and whether dst is currently _active_, but that is not what |
| 659 | ** we're looking for:-( ) |
| 660 | */ |
Guido van Rossum | e6a4b7b | 1997-10-08 15:27:56 +0000 | [diff] [blame] | 661 | initmactimezone(); |
| 662 | ins(d, "timezone", PyInt_FromLong(timezone)); |
Guido van Rossum | be1eb0d | 1997-12-08 21:56:43 +0000 | [diff] [blame] | 663 | ins(d, "altzone", PyInt_FromLong(timezone)); |
| 664 | ins(d, "daylight", PyInt_FromLong((long)0)); |
| 665 | ins(d, "tzname", Py_BuildValue("(zz)", "", "")); |
Guido van Rossum | e6a4b7b | 1997-10-08 15:27:56 +0000 | [diff] [blame] | 666 | #endif /* macintosh */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 667 | #endif /* HAVE_TM_ZONE */ |
| 668 | #endif /* !HAVE_TZNAME */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 669 | if (PyErr_Occurred()) |
| 670 | Py_FatalError("Can't initialize time module"); |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 671 | } |
| 672 | |
| 673 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 674 | /* Implement floattime() for various platforms */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 675 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 676 | static double |
| 677 | floattime() |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 678 | { |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 679 | /* There are three ways to get the time: |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 680 | (1) gettimeofday() -- resolution in microseconds |
| 681 | (2) ftime() -- resolution in milliseconds |
| 682 | (3) time() -- resolution in seconds |
| 683 | In all cases the return value is a float in seconds. |
| 684 | Since on some systems (e.g. SCO ODT 3.0) gettimeofday() may |
| 685 | fail, so we fall back on ftime() or time(). |
| 686 | Note: clock resolution does not imply clock accuracy! */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 687 | #ifdef HAVE_GETTIMEOFDAY |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 688 | { |
| 689 | struct timeval t; |
Guido van Rossum | 3bbc62e | 1995-01-02 19:30:30 +0000 | [diff] [blame] | 690 | #ifdef GETTIMEOFDAY_NO_TZ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 691 | if (gettimeofday(&t) == 0) |
| 692 | return (double)t.tv_sec + t.tv_usec*0.000001; |
Guido van Rossum | 3bbc62e | 1995-01-02 19:30:30 +0000 | [diff] [blame] | 693 | #else /* !GETTIMEOFDAY_NO_TZ */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 694 | if (gettimeofday(&t, (struct timezone *)NULL) == 0) |
| 695 | return (double)t.tv_sec + t.tv_usec*0.000001; |
Guido van Rossum | 3bbc62e | 1995-01-02 19:30:30 +0000 | [diff] [blame] | 696 | #endif /* !GETTIMEOFDAY_NO_TZ */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 697 | } |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 698 | #endif /* !HAVE_GETTIMEOFDAY */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 699 | { |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 700 | #if defined(HAVE_FTIME) && !defined(__BEOS__) |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 701 | struct timeb t; |
| 702 | ftime(&t); |
| 703 | return (double)t.time + (double)t.millitm * (double)0.001; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 704 | #else /* !HAVE_FTIME */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 705 | time_t secs; |
| 706 | time(&secs); |
| 707 | return (double)secs; |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 708 | #endif /* !HAVE_FTIME */ |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 709 | } |
Guido van Rossum | 426035c | 1991-02-19 12:27:35 +0000 | [diff] [blame] | 710 | } |
| 711 | |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 712 | |
| 713 | /* Implement floatsleep() for various platforms. |
| 714 | When interrupted (or when another error occurs), return -1 and |
| 715 | set an exception; else return 0. */ |
| 716 | |
| 717 | static int |
Guido van Rossum | a320fd3 | 1995-03-09 12:14:15 +0000 | [diff] [blame] | 718 | #ifdef MPW |
| 719 | floatsleep(double secs) |
| 720 | #else |
Barry Warsaw | 4a6cf41 | 1997-01-13 22:44:55 +0000 | [diff] [blame] | 721 | floatsleep(secs) |
Guido van Rossum | 775f4da | 1993-01-09 17:18:52 +0000 | [diff] [blame] | 722 | double secs; |
Guido van Rossum | a320fd3 | 1995-03-09 12:14:15 +0000 | [diff] [blame] | 723 | #endif /* MPW */ |
Guido van Rossum | 426035c | 1991-02-19 12:27:35 +0000 | [diff] [blame] | 724 | { |
Guido van Rossum | a78bfe1 | 1997-02-14 16:35:10 +0000 | [diff] [blame] | 725 | /* XXX Should test for MS_WIN32 first! */ |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 726 | #if defined(HAVE_SELECT) && !defined(__BEOS__) |
Guido van Rossum | 426035c | 1991-02-19 12:27:35 +0000 | [diff] [blame] | 727 | struct timeval t; |
Guido van Rossum | 775f4da | 1993-01-09 17:18:52 +0000 | [diff] [blame] | 728 | double frac; |
Guido van Rossum | 775f4da | 1993-01-09 17:18:52 +0000 | [diff] [blame] | 729 | frac = fmod(secs, 1.0); |
| 730 | secs = floor(secs); |
| 731 | t.tv_sec = (long)secs; |
| 732 | t.tv_usec = (long)(frac*1000000.0); |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 733 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 734 | if (select(0, (fd_set *)0, (fd_set *)0, (fd_set *)0, &t) != 0) { |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 735 | Py_BLOCK_THREADS |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 736 | PyErr_SetFromErrno(PyExc_IOError); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 737 | return -1; |
| 738 | } |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 739 | Py_END_ALLOW_THREADS |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 740 | #else /* !HAVE_SELECT || __BEOS__ */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 741 | #ifdef macintosh |
| 742 | #define MacTicks (* (long *)0x16A) |
| 743 | long deadline; |
| 744 | deadline = MacTicks + (long)(secs * 60.0); |
| 745 | while (MacTicks < deadline) { |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 746 | /* XXX Should call some yielding function here */ |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 747 | if (PyErr_CheckSignals()) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 748 | return -1; |
| 749 | } |
| 750 | #else /* !macintosh */ |
Guido van Rossum | 7bf22de | 1997-12-02 20:34:19 +0000 | [diff] [blame] | 751 | #if defined(__WATCOMC__) && !defined(__QNX__) |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 752 | /* XXX Can't interrupt this sleep */ |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 753 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | bceeac8 | 1996-05-23 22:53:47 +0000 | [diff] [blame] | 754 | delay((int)(secs * 1000 + 0.5)); /* delay() uses milliseconds */ |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 755 | Py_END_ALLOW_THREADS |
Guido van Rossum | 7bf22de | 1997-12-02 20:34:19 +0000 | [diff] [blame] | 756 | #else /* !__WATCOMC__ || __QNX__ */ |
Guido van Rossum | e22e644 | 1993-07-09 10:51:31 +0000 | [diff] [blame] | 757 | #ifdef MSDOS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 758 | struct timeb t1, t2; |
| 759 | double frac; |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 760 | extern double fmod Py_PROTO((double, double)); |
| 761 | extern double floor Py_PROTO((double)); |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 762 | if (secs <= 0.0) |
| 763 | return; |
| 764 | frac = fmod(secs, 1.0); |
| 765 | secs = floor(secs); |
| 766 | ftime(&t1); |
| 767 | t2.time = t1.time + (int)secs; |
| 768 | t2.millitm = t1.millitm + (int)(frac*1000.0); |
| 769 | while (t2.millitm >= 1000) { |
| 770 | t2.time++; |
| 771 | t2.millitm -= 1000; |
| 772 | } |
| 773 | for (;;) { |
| 774 | #ifdef QUICKWIN |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 775 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 776 | _wyield(); |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 777 | Py_END_ALLOW_THREADS |
Guido van Rossum | 80c9d88 | 1991-04-16 08:47:51 +0000 | [diff] [blame] | 778 | #endif |
Barry Warsaw | 9a2a8a8 | 1996-12-06 23:32:14 +0000 | [diff] [blame] | 779 | if (PyErr_CheckSignals()) |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 780 | return -1; |
| 781 | ftime(&t1); |
| 782 | if (t1.time > t2.time || |
| 783 | t1.time == t2.time && t1.millitm >= t2.millitm) |
| 784 | break; |
| 785 | } |
| 786 | #else /* !MSDOS */ |
Guido van Rossum | b2fb364 | 1996-09-07 00:47:35 +0000 | [diff] [blame] | 787 | #ifdef MS_WIN32 |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 788 | /* XXX Can't interrupt this sleep */ |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 789 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 790 | Sleep((int)(secs*1000)); |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 791 | Py_END_ALLOW_THREADS |
Guido van Rossum | b2fb364 | 1996-09-07 00:47:35 +0000 | [diff] [blame] | 792 | #else /* !MS_WIN32 */ |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 793 | #ifdef PYOS_OS2 |
| 794 | /* This Sleep *IS* Interruptable by Exceptions */ |
Guido van Rossum | 1d0d7e4 | 1997-12-29 20:03:10 +0000 | [diff] [blame] | 795 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 796 | if (DosSleep(secs * 1000) != NO_ERROR) { |
Guido van Rossum | 1d0d7e4 | 1997-12-29 20:03:10 +0000 | [diff] [blame] | 797 | Py_BLOCK_THREADS |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 798 | PyErr_SetFromErrno(PyExc_IOError); |
| 799 | return -1; |
| 800 | } |
Guido van Rossum | 1d0d7e4 | 1997-12-29 20:03:10 +0000 | [diff] [blame] | 801 | Py_END_ALLOW_THREADS |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 802 | #else /* !PYOS_OS2 */ |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 803 | #ifdef __BEOS__ |
| 804 | /* This sleep *CAN BE* interrupted. */ |
| 805 | { |
| 806 | bigtime_t frac, seconds; |
| 807 | |
| 808 | extern double fmod Py_PROTO((double,double)); |
| 809 | extern double floor Py_PROTO((double)); |
| 810 | |
| 811 | if( secs <= 0.0 ) { |
| 812 | return; |
| 813 | } |
| 814 | |
| 815 | frac = (bigtime_t)fmod( secs, 1.0 ); |
| 816 | seconds = (bigtime_t)floor( secs ); |
| 817 | |
| 818 | Py_BEGIN_ALLOW_THREADS |
| 819 | if( snooze( seconds * (bigtime_t)1000 + frac ) == B_INTERRUPTED ) { |
| 820 | Py_BLOCK_THREADS |
| 821 | PyErr_SetFromErrno( PyExc_IOError ); |
| 822 | return -1; |
| 823 | } |
| 824 | Py_END_ALLOW_THREADS |
| 825 | } |
| 826 | #else /* !__BEOS__ */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 827 | /* XXX Can't interrupt this sleep */ |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 828 | Py_BEGIN_ALLOW_THREADS |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 829 | sleep((int)secs); |
Guido van Rossum | 8607ae2 | 1997-11-03 22:04:46 +0000 | [diff] [blame] | 830 | Py_END_ALLOW_THREADS |
Guido van Rossum | bcc2074 | 1998-08-04 22:53:56 +0000 | [diff] [blame] | 831 | #endif /* !__BEOS__ */ |
Guido van Rossum | 8e9ebfd | 1997-11-22 21:53:48 +0000 | [diff] [blame] | 832 | #endif /* !PYOS_OS2 */ |
Guido van Rossum | b2fb364 | 1996-09-07 00:47:35 +0000 | [diff] [blame] | 833 | #endif /* !MS_WIN32 */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 834 | #endif /* !MSDOS */ |
Guido van Rossum | 7bf22de | 1997-12-02 20:34:19 +0000 | [diff] [blame] | 835 | #endif /* !__WATCOMC__ || __QNX__ */ |
Guido van Rossum | b6775db | 1994-08-01 11:34:53 +0000 | [diff] [blame] | 836 | #endif /* !macintosh */ |
| 837 | #endif /* !HAVE_SELECT */ |
| 838 | return 0; |
Guido van Rossum | 80c9d88 | 1991-04-16 08:47:51 +0000 | [diff] [blame] | 839 | } |