blob: aa037c27d7bca05ac102ec0a6fa706737631e1b2 [file] [log] [blame]
Tim Peters2a799bf2002-12-16 20:18:38 +00001/* C implementation for the date/time type documented at
2 * http://www.zope.org/Members/fdrake/DateTimeWiki/FrontPage
3 */
4
5#include "Python.h"
6#include "modsupport.h"
7#include "structmember.h"
8
9#include <time.h>
10
Tim Peters1b6f7a92004-06-20 02:50:16 +000011#include "timefuncs.h"
Tim Peters9ddf40b2004-06-20 22:41:32 +000012
13/* Differentiate between building the core module and building extension
14 * modules.
15 */
Guido van Rossum360e4b82007-05-14 22:51:27 +000016#ifndef Py_BUILD_CORE
Tim Peters9ddf40b2004-06-20 22:41:32 +000017#define Py_BUILD_CORE
Guido van Rossum360e4b82007-05-14 22:51:27 +000018#endif
Tim Peters2a799bf2002-12-16 20:18:38 +000019#include "datetime.h"
Tim Peters9ddf40b2004-06-20 22:41:32 +000020#undef Py_BUILD_CORE
Tim Peters2a799bf2002-12-16 20:18:38 +000021
22/* We require that C int be at least 32 bits, and use int virtually
23 * everywhere. In just a few cases we use a temp long, where a Python
24 * API returns a C long. In such cases, we have to ensure that the
25 * final result fits in a C int (this can be an issue on 64-bit boxes).
26 */
27#if SIZEOF_INT < 4
28# error "datetime.c requires that C int have at least 32 bits"
29#endif
30
31#define MINYEAR 1
32#define MAXYEAR 9999
33
34/* Nine decimal digits is easy to communicate, and leaves enough room
35 * so that two delta days can be added w/o fear of overflowing a signed
36 * 32-bit int, and with plenty of room left over to absorb any possible
37 * carries from adding seconds.
38 */
39#define MAX_DELTA_DAYS 999999999
40
41/* Rename the long macros in datetime.h to more reasonable short names. */
42#define GET_YEAR PyDateTime_GET_YEAR
43#define GET_MONTH PyDateTime_GET_MONTH
44#define GET_DAY PyDateTime_GET_DAY
45#define DATE_GET_HOUR PyDateTime_DATE_GET_HOUR
46#define DATE_GET_MINUTE PyDateTime_DATE_GET_MINUTE
47#define DATE_GET_SECOND PyDateTime_DATE_GET_SECOND
48#define DATE_GET_MICROSECOND PyDateTime_DATE_GET_MICROSECOND
49
50/* Date accessors for date and datetime. */
51#define SET_YEAR(o, v) (((o)->data[0] = ((v) & 0xff00) >> 8), \
52 ((o)->data[1] = ((v) & 0x00ff)))
53#define SET_MONTH(o, v) (PyDateTime_GET_MONTH(o) = (v))
54#define SET_DAY(o, v) (PyDateTime_GET_DAY(o) = (v))
55
56/* Date/Time accessors for datetime. */
57#define DATE_SET_HOUR(o, v) (PyDateTime_DATE_GET_HOUR(o) = (v))
58#define DATE_SET_MINUTE(o, v) (PyDateTime_DATE_GET_MINUTE(o) = (v))
59#define DATE_SET_SECOND(o, v) (PyDateTime_DATE_GET_SECOND(o) = (v))
60#define DATE_SET_MICROSECOND(o, v) \
61 (((o)->data[7] = ((v) & 0xff0000) >> 16), \
62 ((o)->data[8] = ((v) & 0x00ff00) >> 8), \
63 ((o)->data[9] = ((v) & 0x0000ff)))
64
65/* Time accessors for time. */
66#define TIME_GET_HOUR PyDateTime_TIME_GET_HOUR
67#define TIME_GET_MINUTE PyDateTime_TIME_GET_MINUTE
68#define TIME_GET_SECOND PyDateTime_TIME_GET_SECOND
69#define TIME_GET_MICROSECOND PyDateTime_TIME_GET_MICROSECOND
70#define TIME_SET_HOUR(o, v) (PyDateTime_TIME_GET_HOUR(o) = (v))
71#define TIME_SET_MINUTE(o, v) (PyDateTime_TIME_GET_MINUTE(o) = (v))
72#define TIME_SET_SECOND(o, v) (PyDateTime_TIME_GET_SECOND(o) = (v))
73#define TIME_SET_MICROSECOND(o, v) \
74 (((o)->data[3] = ((v) & 0xff0000) >> 16), \
75 ((o)->data[4] = ((v) & 0x00ff00) >> 8), \
76 ((o)->data[5] = ((v) & 0x0000ff)))
77
78/* Delta accessors for timedelta. */
79#define GET_TD_DAYS(o) (((PyDateTime_Delta *)(o))->days)
80#define GET_TD_SECONDS(o) (((PyDateTime_Delta *)(o))->seconds)
81#define GET_TD_MICROSECONDS(o) (((PyDateTime_Delta *)(o))->microseconds)
82
83#define SET_TD_DAYS(o, v) ((o)->days = (v))
84#define SET_TD_SECONDS(o, v) ((o)->seconds = (v))
85#define SET_TD_MICROSECONDS(o, v) ((o)->microseconds = (v))
86
Tim Petersa032d2e2003-01-11 00:15:54 +000087/* p is a pointer to a time or a datetime object; HASTZINFO(p) returns
88 * p->hastzinfo.
89 */
90#define HASTZINFO(p) (((_PyDateTime_BaseTZInfo *)(p))->hastzinfo)
91
Tim Peters3f606292004-03-21 23:38:41 +000092/* M is a char or int claiming to be a valid month. The macro is equivalent
93 * to the two-sided Python test
94 * 1 <= M <= 12
95 */
96#define MONTH_IS_SANE(M) ((unsigned int)(M) - 1 < 12)
97
Tim Peters2a799bf2002-12-16 20:18:38 +000098/* Forward declarations. */
99static PyTypeObject PyDateTime_DateType;
100static PyTypeObject PyDateTime_DateTimeType;
Tim Peters2a799bf2002-12-16 20:18:38 +0000101static PyTypeObject PyDateTime_DeltaType;
102static PyTypeObject PyDateTime_TimeType;
103static PyTypeObject PyDateTime_TZInfoType;
Tim Peters2a799bf2002-12-16 20:18:38 +0000104
105/* ---------------------------------------------------------------------------
106 * Math utilities.
107 */
108
109/* k = i+j overflows iff k differs in sign from both inputs,
110 * iff k^i has sign bit set and k^j has sign bit set,
111 * iff (k^i)&(k^j) has sign bit set.
112 */
113#define SIGNED_ADD_OVERFLOWED(RESULT, I, J) \
114 ((((RESULT) ^ (I)) & ((RESULT) ^ (J))) < 0)
115
116/* Compute Python divmod(x, y), returning the quotient and storing the
117 * remainder into *r. The quotient is the floor of x/y, and that's
118 * the real point of this. C will probably truncate instead (C99
119 * requires truncation; C89 left it implementation-defined).
120 * Simplification: we *require* that y > 0 here. That's appropriate
121 * for all the uses made of it. This simplifies the code and makes
122 * the overflow case impossible (divmod(LONG_MIN, -1) is the only
123 * overflow case).
124 */
125static int
126divmod(int x, int y, int *r)
127{
128 int quo;
129
130 assert(y > 0);
131 quo = x / y;
132 *r = x - quo * y;
133 if (*r < 0) {
134 --quo;
135 *r += y;
136 }
137 assert(0 <= *r && *r < y);
138 return quo;
139}
140
Tim Peters5d644dd2003-01-02 16:32:54 +0000141/* Round a double to the nearest long. |x| must be small enough to fit
142 * in a C long; this is not checked.
143 */
144static long
145round_to_long(double x)
146{
147 if (x >= 0.0)
148 x = floor(x + 0.5);
149 else
150 x = ceil(x - 0.5);
151 return (long)x;
152}
153
Tim Peters2a799bf2002-12-16 20:18:38 +0000154/* ---------------------------------------------------------------------------
155 * General calendrical helper functions
156 */
157
158/* For each month ordinal in 1..12, the number of days in that month,
159 * and the number of days before that month in the same year. These
160 * are correct for non-leap years only.
161 */
162static int _days_in_month[] = {
163 0, /* unused; this vector uses 1-based indexing */
164 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31
165};
166
167static int _days_before_month[] = {
168 0, /* unused; this vector uses 1-based indexing */
169 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334
170};
171
172/* year -> 1 if leap year, else 0. */
173static int
174is_leap(int year)
175{
176 /* Cast year to unsigned. The result is the same either way, but
177 * C can generate faster code for unsigned mod than for signed
178 * mod (especially for % 4 -- a good compiler should just grab
179 * the last 2 bits when the LHS is unsigned).
180 */
181 const unsigned int ayear = (unsigned int)year;
182 return ayear % 4 == 0 && (ayear % 100 != 0 || ayear % 400 == 0);
183}
184
185/* year, month -> number of days in that month in that year */
186static int
187days_in_month(int year, int month)
188{
189 assert(month >= 1);
190 assert(month <= 12);
191 if (month == 2 && is_leap(year))
192 return 29;
193 else
194 return _days_in_month[month];
195}
196
197/* year, month -> number of days in year preceeding first day of month */
198static int
199days_before_month(int year, int month)
200{
201 int days;
202
203 assert(month >= 1);
204 assert(month <= 12);
205 days = _days_before_month[month];
206 if (month > 2 && is_leap(year))
207 ++days;
208 return days;
209}
210
211/* year -> number of days before January 1st of year. Remember that we
212 * start with year 1, so days_before_year(1) == 0.
213 */
214static int
215days_before_year(int year)
216{
217 int y = year - 1;
218 /* This is incorrect if year <= 0; we really want the floor
219 * here. But so long as MINYEAR is 1, the smallest year this
220 * can see is 0 (this can happen in some normalization endcases),
221 * so we'll just special-case that.
222 */
223 assert (year >= 0);
224 if (y >= 0)
225 return y*365 + y/4 - y/100 + y/400;
226 else {
227 assert(y == -1);
228 return -366;
229 }
230}
231
232/* Number of days in 4, 100, and 400 year cycles. That these have
233 * the correct values is asserted in the module init function.
234 */
235#define DI4Y 1461 /* days_before_year(5); days in 4 years */
236#define DI100Y 36524 /* days_before_year(101); days in 100 years */
237#define DI400Y 146097 /* days_before_year(401); days in 400 years */
238
239/* ordinal -> year, month, day, considering 01-Jan-0001 as day 1. */
240static void
241ord_to_ymd(int ordinal, int *year, int *month, int *day)
242{
243 int n, n1, n4, n100, n400, leapyear, preceding;
244
245 /* ordinal is a 1-based index, starting at 1-Jan-1. The pattern of
246 * leap years repeats exactly every 400 years. The basic strategy is
247 * to find the closest 400-year boundary at or before ordinal, then
248 * work with the offset from that boundary to ordinal. Life is much
249 * clearer if we subtract 1 from ordinal first -- then the values
250 * of ordinal at 400-year boundaries are exactly those divisible
251 * by DI400Y:
252 *
253 * D M Y n n-1
254 * -- --- ---- ---------- ----------------
255 * 31 Dec -400 -DI400Y -DI400Y -1
256 * 1 Jan -399 -DI400Y +1 -DI400Y 400-year boundary
257 * ...
258 * 30 Dec 000 -1 -2
259 * 31 Dec 000 0 -1
260 * 1 Jan 001 1 0 400-year boundary
261 * 2 Jan 001 2 1
262 * 3 Jan 001 3 2
263 * ...
264 * 31 Dec 400 DI400Y DI400Y -1
265 * 1 Jan 401 DI400Y +1 DI400Y 400-year boundary
266 */
267 assert(ordinal >= 1);
268 --ordinal;
269 n400 = ordinal / DI400Y;
270 n = ordinal % DI400Y;
271 *year = n400 * 400 + 1;
272
273 /* Now n is the (non-negative) offset, in days, from January 1 of
274 * year, to the desired date. Now compute how many 100-year cycles
275 * precede n.
276 * Note that it's possible for n100 to equal 4! In that case 4 full
277 * 100-year cycles precede the desired day, which implies the
278 * desired day is December 31 at the end of a 400-year cycle.
279 */
280 n100 = n / DI100Y;
281 n = n % DI100Y;
282
283 /* Now compute how many 4-year cycles precede it. */
284 n4 = n / DI4Y;
285 n = n % DI4Y;
286
287 /* And now how many single years. Again n1 can be 4, and again
288 * meaning that the desired day is December 31 at the end of the
289 * 4-year cycle.
290 */
291 n1 = n / 365;
292 n = n % 365;
293
294 *year += n100 * 100 + n4 * 4 + n1;
295 if (n1 == 4 || n100 == 4) {
296 assert(n == 0);
297 *year -= 1;
298 *month = 12;
299 *day = 31;
300 return;
301 }
302
303 /* Now the year is correct, and n is the offset from January 1. We
304 * find the month via an estimate that's either exact or one too
305 * large.
306 */
307 leapyear = n1 == 3 && (n4 != 24 || n100 == 3);
308 assert(leapyear == is_leap(*year));
309 *month = (n + 50) >> 5;
310 preceding = (_days_before_month[*month] + (*month > 2 && leapyear));
311 if (preceding > n) {
312 /* estimate is too large */
313 *month -= 1;
314 preceding -= days_in_month(*year, *month);
315 }
316 n -= preceding;
317 assert(0 <= n);
318 assert(n < days_in_month(*year, *month));
319
320 *day = n + 1;
321}
322
323/* year, month, day -> ordinal, considering 01-Jan-0001 as day 1. */
324static int
325ymd_to_ord(int year, int month, int day)
326{
327 return days_before_year(year) + days_before_month(year, month) + day;
328}
329
330/* Day of week, where Monday==0, ..., Sunday==6. 1/1/1 was a Monday. */
331static int
332weekday(int year, int month, int day)
333{
334 return (ymd_to_ord(year, month, day) + 6) % 7;
335}
336
337/* Ordinal of the Monday starting week 1 of the ISO year. Week 1 is the
338 * first calendar week containing a Thursday.
339 */
340static int
341iso_week1_monday(int year)
342{
343 int first_day = ymd_to_ord(year, 1, 1); /* ord of 1/1 */
344 /* 0 if 1/1 is a Monday, 1 if a Tue, etc. */
345 int first_weekday = (first_day + 6) % 7;
346 /* ordinal of closest Monday at or before 1/1 */
347 int week1_monday = first_day - first_weekday;
348
349 if (first_weekday > 3) /* if 1/1 was Fri, Sat, Sun */
350 week1_monday += 7;
351 return week1_monday;
352}
353
354/* ---------------------------------------------------------------------------
355 * Range checkers.
356 */
357
358/* Check that -MAX_DELTA_DAYS <= days <= MAX_DELTA_DAYS. If so, return 0.
359 * If not, raise OverflowError and return -1.
360 */
361static int
362check_delta_day_range(int days)
363{
364 if (-MAX_DELTA_DAYS <= days && days <= MAX_DELTA_DAYS)
365 return 0;
366 PyErr_Format(PyExc_OverflowError,
367 "days=%d; must have magnitude <= %d",
Guido van Rossumbd43e912002-12-16 20:34:55 +0000368 days, MAX_DELTA_DAYS);
Tim Peters2a799bf2002-12-16 20:18:38 +0000369 return -1;
370}
371
372/* Check that date arguments are in range. Return 0 if they are. If they
373 * aren't, raise ValueError and return -1.
374 */
375static int
376check_date_args(int year, int month, int day)
377{
378
379 if (year < MINYEAR || year > MAXYEAR) {
380 PyErr_SetString(PyExc_ValueError,
381 "year is out of range");
382 return -1;
383 }
384 if (month < 1 || month > 12) {
385 PyErr_SetString(PyExc_ValueError,
386 "month must be in 1..12");
387 return -1;
388 }
389 if (day < 1 || day > days_in_month(year, month)) {
390 PyErr_SetString(PyExc_ValueError,
391 "day is out of range for month");
392 return -1;
393 }
394 return 0;
395}
396
397/* Check that time arguments are in range. Return 0 if they are. If they
398 * aren't, raise ValueError and return -1.
399 */
400static int
401check_time_args(int h, int m, int s, int us)
402{
403 if (h < 0 || h > 23) {
404 PyErr_SetString(PyExc_ValueError,
405 "hour must be in 0..23");
406 return -1;
407 }
408 if (m < 0 || m > 59) {
409 PyErr_SetString(PyExc_ValueError,
410 "minute must be in 0..59");
411 return -1;
412 }
413 if (s < 0 || s > 59) {
414 PyErr_SetString(PyExc_ValueError,
415 "second must be in 0..59");
416 return -1;
417 }
418 if (us < 0 || us > 999999) {
419 PyErr_SetString(PyExc_ValueError,
420 "microsecond must be in 0..999999");
421 return -1;
422 }
423 return 0;
424}
425
426/* ---------------------------------------------------------------------------
427 * Normalization utilities.
428 */
429
430/* One step of a mixed-radix conversion. A "hi" unit is equivalent to
431 * factor "lo" units. factor must be > 0. If *lo is less than 0, or
432 * at least factor, enough of *lo is converted into "hi" units so that
433 * 0 <= *lo < factor. The input values must be such that int overflow
434 * is impossible.
435 */
436static void
437normalize_pair(int *hi, int *lo, int factor)
438{
439 assert(factor > 0);
440 assert(lo != hi);
441 if (*lo < 0 || *lo >= factor) {
442 const int num_hi = divmod(*lo, factor, lo);
443 const int new_hi = *hi + num_hi;
444 assert(! SIGNED_ADD_OVERFLOWED(new_hi, *hi, num_hi));
445 *hi = new_hi;
446 }
447 assert(0 <= *lo && *lo < factor);
448}
449
450/* Fiddle days (d), seconds (s), and microseconds (us) so that
451 * 0 <= *s < 24*3600
452 * 0 <= *us < 1000000
453 * The input values must be such that the internals don't overflow.
454 * The way this routine is used, we don't get close.
455 */
456static void
457normalize_d_s_us(int *d, int *s, int *us)
458{
459 if (*us < 0 || *us >= 1000000) {
460 normalize_pair(s, us, 1000000);
461 /* |s| can't be bigger than about
462 * |original s| + |original us|/1000000 now.
463 */
464
465 }
466 if (*s < 0 || *s >= 24*3600) {
467 normalize_pair(d, s, 24*3600);
468 /* |d| can't be bigger than about
469 * |original d| +
470 * (|original s| + |original us|/1000000) / (24*3600) now.
471 */
472 }
473 assert(0 <= *s && *s < 24*3600);
474 assert(0 <= *us && *us < 1000000);
475}
476
477/* Fiddle years (y), months (m), and days (d) so that
478 * 1 <= *m <= 12
479 * 1 <= *d <= days_in_month(*y, *m)
480 * The input values must be such that the internals don't overflow.
481 * The way this routine is used, we don't get close.
482 */
483static void
484normalize_y_m_d(int *y, int *m, int *d)
485{
486 int dim; /* # of days in month */
487
488 /* This gets muddy: the proper range for day can't be determined
489 * without knowing the correct month and year, but if day is, e.g.,
490 * plus or minus a million, the current month and year values make
491 * no sense (and may also be out of bounds themselves).
492 * Saying 12 months == 1 year should be non-controversial.
493 */
494 if (*m < 1 || *m > 12) {
495 --*m;
496 normalize_pair(y, m, 12);
497 ++*m;
498 /* |y| can't be bigger than about
499 * |original y| + |original m|/12 now.
500 */
501 }
502 assert(1 <= *m && *m <= 12);
503
504 /* Now only day can be out of bounds (year may also be out of bounds
505 * for a datetime object, but we don't care about that here).
506 * If day is out of bounds, what to do is arguable, but at least the
507 * method here is principled and explainable.
508 */
509 dim = days_in_month(*y, *m);
510 if (*d < 1 || *d > dim) {
511 /* Move day-1 days from the first of the month. First try to
512 * get off cheap if we're only one day out of range
513 * (adjustments for timezone alone can't be worse than that).
514 */
515 if (*d == 0) {
516 --*m;
517 if (*m > 0)
518 *d = days_in_month(*y, *m);
519 else {
520 --*y;
521 *m = 12;
522 *d = 31;
523 }
524 }
525 else if (*d == dim + 1) {
526 /* move forward a day */
527 ++*m;
528 *d = 1;
529 if (*m > 12) {
530 *m = 1;
531 ++*y;
532 }
533 }
534 else {
535 int ordinal = ymd_to_ord(*y, *m, 1) +
536 *d - 1;
537 ord_to_ymd(ordinal, y, m, d);
538 }
539 }
540 assert(*m > 0);
541 assert(*d > 0);
542}
543
544/* Fiddle out-of-bounds months and days so that the result makes some kind
545 * of sense. The parameters are both inputs and outputs. Returns < 0 on
546 * failure, where failure means the adjusted year is out of bounds.
547 */
548static int
549normalize_date(int *year, int *month, int *day)
550{
551 int result;
552
553 normalize_y_m_d(year, month, day);
554 if (MINYEAR <= *year && *year <= MAXYEAR)
555 result = 0;
556 else {
557 PyErr_SetString(PyExc_OverflowError,
558 "date value out of range");
559 result = -1;
560 }
561 return result;
562}
563
564/* Force all the datetime fields into range. The parameters are both
565 * inputs and outputs. Returns < 0 on error.
566 */
567static int
568normalize_datetime(int *year, int *month, int *day,
569 int *hour, int *minute, int *second,
570 int *microsecond)
571{
572 normalize_pair(second, microsecond, 1000000);
573 normalize_pair(minute, second, 60);
574 normalize_pair(hour, minute, 60);
575 normalize_pair(day, hour, 24);
576 return normalize_date(year, month, day);
577}
578
579/* ---------------------------------------------------------------------------
Tim Petersb0c854d2003-05-17 15:57:00 +0000580 * Basic object allocation: tp_alloc implementations. These allocate
581 * Python objects of the right size and type, and do the Python object-
582 * initialization bit. If there's not enough memory, they return NULL after
583 * setting MemoryError. All data members remain uninitialized trash.
584 *
585 * We abuse the tp_alloc "nitems" argument to communicate whether a tzinfo
Tim Peters03eaf8b2003-05-18 02:24:46 +0000586 * member is needed. This is ugly, imprecise, and possibly insecure.
587 * tp_basicsize for the time and datetime types is set to the size of the
588 * struct that has room for the tzinfo member, so subclasses in Python will
589 * allocate enough space for a tzinfo member whether or not one is actually
590 * needed. That's the "ugly and imprecise" parts. The "possibly insecure"
591 * part is that PyType_GenericAlloc() (which subclasses in Python end up
592 * using) just happens today to effectively ignore the nitems argument
593 * when tp_itemsize is 0, which it is for these type objects. If that
594 * changes, perhaps the callers of tp_alloc slots in this file should
595 * be changed to force a 0 nitems argument unless the type being allocated
596 * is a base type implemented in this file (so that tp_alloc is time_alloc
597 * or datetime_alloc below, which know about the nitems abuse).
Tim Petersb0c854d2003-05-17 15:57:00 +0000598 */
599
600static PyObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000601time_alloc(PyTypeObject *type, Py_ssize_t aware)
Tim Petersb0c854d2003-05-17 15:57:00 +0000602{
603 PyObject *self;
604
605 self = (PyObject *)
606 PyObject_MALLOC(aware ?
607 sizeof(PyDateTime_Time) :
608 sizeof(_PyDateTime_BaseTime));
609 if (self == NULL)
610 return (PyObject *)PyErr_NoMemory();
611 PyObject_INIT(self, type);
612 return self;
613}
614
615static PyObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000616datetime_alloc(PyTypeObject *type, Py_ssize_t aware)
Tim Petersb0c854d2003-05-17 15:57:00 +0000617{
618 PyObject *self;
619
620 self = (PyObject *)
621 PyObject_MALLOC(aware ?
622 sizeof(PyDateTime_DateTime) :
623 sizeof(_PyDateTime_BaseDateTime));
624 if (self == NULL)
625 return (PyObject *)PyErr_NoMemory();
626 PyObject_INIT(self, type);
627 return self;
628}
629
630/* ---------------------------------------------------------------------------
631 * Helpers for setting object fields. These work on pointers to the
632 * appropriate base class.
633 */
634
635/* For date and datetime. */
636static void
637set_date_fields(PyDateTime_Date *self, int y, int m, int d)
638{
639 self->hashcode = -1;
640 SET_YEAR(self, y);
641 SET_MONTH(self, m);
642 SET_DAY(self, d);
643}
644
645/* ---------------------------------------------------------------------------
646 * Create various objects, mostly without range checking.
647 */
648
649/* Create a date instance with no range checking. */
650static PyObject *
651new_date_ex(int year, int month, int day, PyTypeObject *type)
652{
653 PyDateTime_Date *self;
654
655 self = (PyDateTime_Date *) (type->tp_alloc(type, 0));
656 if (self != NULL)
657 set_date_fields(self, year, month, day);
658 return (PyObject *) self;
659}
660
661#define new_date(year, month, day) \
662 new_date_ex(year, month, day, &PyDateTime_DateType)
663
664/* Create a datetime instance with no range checking. */
665static PyObject *
666new_datetime_ex(int year, int month, int day, int hour, int minute,
667 int second, int usecond, PyObject *tzinfo, PyTypeObject *type)
668{
669 PyDateTime_DateTime *self;
670 char aware = tzinfo != Py_None;
671
672 self = (PyDateTime_DateTime *) (type->tp_alloc(type, aware));
673 if (self != NULL) {
674 self->hastzinfo = aware;
675 set_date_fields((PyDateTime_Date *)self, year, month, day);
676 DATE_SET_HOUR(self, hour);
677 DATE_SET_MINUTE(self, minute);
678 DATE_SET_SECOND(self, second);
679 DATE_SET_MICROSECOND(self, usecond);
680 if (aware) {
681 Py_INCREF(tzinfo);
682 self->tzinfo = tzinfo;
683 }
684 }
685 return (PyObject *)self;
686}
687
688#define new_datetime(y, m, d, hh, mm, ss, us, tzinfo) \
689 new_datetime_ex(y, m, d, hh, mm, ss, us, tzinfo, \
690 &PyDateTime_DateTimeType)
691
692/* Create a time instance with no range checking. */
693static PyObject *
694new_time_ex(int hour, int minute, int second, int usecond,
695 PyObject *tzinfo, PyTypeObject *type)
696{
697 PyDateTime_Time *self;
698 char aware = tzinfo != Py_None;
699
700 self = (PyDateTime_Time *) (type->tp_alloc(type, aware));
701 if (self != NULL) {
702 self->hastzinfo = aware;
703 self->hashcode = -1;
704 TIME_SET_HOUR(self, hour);
705 TIME_SET_MINUTE(self, minute);
706 TIME_SET_SECOND(self, second);
707 TIME_SET_MICROSECOND(self, usecond);
708 if (aware) {
709 Py_INCREF(tzinfo);
710 self->tzinfo = tzinfo;
711 }
712 }
713 return (PyObject *)self;
714}
715
716#define new_time(hh, mm, ss, us, tzinfo) \
717 new_time_ex(hh, mm, ss, us, tzinfo, &PyDateTime_TimeType)
718
719/* Create a timedelta instance. Normalize the members iff normalize is
720 * true. Passing false is a speed optimization, if you know for sure
721 * that seconds and microseconds are already in their proper ranges. In any
722 * case, raises OverflowError and returns NULL if the normalized days is out
723 * of range).
724 */
725static PyObject *
726new_delta_ex(int days, int seconds, int microseconds, int normalize,
727 PyTypeObject *type)
728{
729 PyDateTime_Delta *self;
730
731 if (normalize)
732 normalize_d_s_us(&days, &seconds, &microseconds);
733 assert(0 <= seconds && seconds < 24*3600);
734 assert(0 <= microseconds && microseconds < 1000000);
735
736 if (check_delta_day_range(days) < 0)
737 return NULL;
738
739 self = (PyDateTime_Delta *) (type->tp_alloc(type, 0));
740 if (self != NULL) {
741 self->hashcode = -1;
742 SET_TD_DAYS(self, days);
743 SET_TD_SECONDS(self, seconds);
744 SET_TD_MICROSECONDS(self, microseconds);
745 }
746 return (PyObject *) self;
747}
748
749#define new_delta(d, s, us, normalize) \
750 new_delta_ex(d, s, us, normalize, &PyDateTime_DeltaType)
751
752/* ---------------------------------------------------------------------------
Tim Peters2a799bf2002-12-16 20:18:38 +0000753 * tzinfo helpers.
754 */
755
Tim Peters855fe882002-12-22 03:43:39 +0000756/* Ensure that p is None or of a tzinfo subclass. Return 0 if OK; if not
757 * raise TypeError and return -1.
758 */
759static int
760check_tzinfo_subclass(PyObject *p)
761{
762 if (p == Py_None || PyTZInfo_Check(p))
763 return 0;
764 PyErr_Format(PyExc_TypeError,
765 "tzinfo argument must be None or of a tzinfo subclass, "
766 "not type '%s'",
767 p->ob_type->tp_name);
768 return -1;
769}
770
Tim Petersbad8ff02002-12-30 20:52:32 +0000771/* Return tzinfo.methname(tzinfoarg), without any checking of results.
Tim Peters855fe882002-12-22 03:43:39 +0000772 * If tzinfo is None, returns None.
773 */
774static PyObject *
Tim Petersbad8ff02002-12-30 20:52:32 +0000775call_tzinfo_method(PyObject *tzinfo, char *methname, PyObject *tzinfoarg)
Tim Peters855fe882002-12-22 03:43:39 +0000776{
777 PyObject *result;
778
Tim Petersbad8ff02002-12-30 20:52:32 +0000779 assert(tzinfo && methname && tzinfoarg);
Tim Peters855fe882002-12-22 03:43:39 +0000780 assert(check_tzinfo_subclass(tzinfo) >= 0);
781 if (tzinfo == Py_None) {
782 result = Py_None;
783 Py_INCREF(result);
784 }
785 else
Tim Petersbad8ff02002-12-30 20:52:32 +0000786 result = PyObject_CallMethod(tzinfo, methname, "O", tzinfoarg);
Tim Peters855fe882002-12-22 03:43:39 +0000787 return result;
788}
789
Tim Peters2a799bf2002-12-16 20:18:38 +0000790/* If self has a tzinfo member, return a BORROWED reference to it. Else
791 * return NULL, which is NOT AN ERROR. There are no error returns here,
792 * and the caller must not decref the result.
793 */
794static PyObject *
795get_tzinfo_member(PyObject *self)
796{
797 PyObject *tzinfo = NULL;
798
Tim Petersa9bc1682003-01-11 03:39:11 +0000799 if (PyDateTime_Check(self) && HASTZINFO(self))
800 tzinfo = ((PyDateTime_DateTime *)self)->tzinfo;
Tim Petersa032d2e2003-01-11 00:15:54 +0000801 else if (PyTime_Check(self) && HASTZINFO(self))
Tim Peters37f39822003-01-10 03:49:02 +0000802 tzinfo = ((PyDateTime_Time *)self)->tzinfo;
Tim Peters2a799bf2002-12-16 20:18:38 +0000803
804 return tzinfo;
805}
806
Tim Petersbad8ff02002-12-30 20:52:32 +0000807/* Call getattr(tzinfo, name)(tzinfoarg), and extract an int from the
Tim Peters2a799bf2002-12-16 20:18:38 +0000808 * result. tzinfo must be an instance of the tzinfo class. If the method
809 * returns None, this returns 0 and sets *none to 1. If the method doesn't
Tim Peters397301e2003-01-02 21:28:08 +0000810 * return None or timedelta, TypeError is raised and this returns -1. If it
811 * returnsa timedelta and the value is out of range or isn't a whole number
812 * of minutes, ValueError is raised and this returns -1.
Tim Peters2a799bf2002-12-16 20:18:38 +0000813 * Else *none is set to 0 and the integer method result is returned.
814 */
815static int
816call_utc_tzinfo_method(PyObject *tzinfo, char *name, PyObject *tzinfoarg,
817 int *none)
818{
819 PyObject *u;
Tim Peters397301e2003-01-02 21:28:08 +0000820 int result = -1;
Tim Peters2a799bf2002-12-16 20:18:38 +0000821
822 assert(tzinfo != NULL);
823 assert(PyTZInfo_Check(tzinfo));
824 assert(tzinfoarg != NULL);
825
826 *none = 0;
Tim Petersbad8ff02002-12-30 20:52:32 +0000827 u = call_tzinfo_method(tzinfo, name, tzinfoarg);
Tim Peters2a799bf2002-12-16 20:18:38 +0000828 if (u == NULL)
829 return -1;
830
Tim Peters27362852002-12-23 16:17:39 +0000831 else if (u == Py_None) {
Tim Peters2a799bf2002-12-16 20:18:38 +0000832 result = 0;
833 *none = 1;
Tim Peters2a799bf2002-12-16 20:18:38 +0000834 }
Tim Peters855fe882002-12-22 03:43:39 +0000835 else if (PyDelta_Check(u)) {
836 const int days = GET_TD_DAYS(u);
837 if (days < -1 || days > 0)
838 result = 24*60; /* trigger ValueError below */
839 else {
840 /* next line can't overflow because we know days
841 * is -1 or 0 now
842 */
843 int ss = days * 24 * 3600 + GET_TD_SECONDS(u);
844 result = divmod(ss, 60, &ss);
845 if (ss || GET_TD_MICROSECONDS(u)) {
846 PyErr_Format(PyExc_ValueError,
847 "tzinfo.%s() must return a "
848 "whole number of minutes",
849 name);
850 result = -1;
Tim Peters855fe882002-12-22 03:43:39 +0000851 }
852 }
853 }
Tim Peters2a799bf2002-12-16 20:18:38 +0000854 else {
855 PyErr_Format(PyExc_TypeError,
Tim Peters397301e2003-01-02 21:28:08 +0000856 "tzinfo.%s() must return None or "
Tim Peters855fe882002-12-22 03:43:39 +0000857 "timedelta, not '%s'",
858 name, u->ob_type->tp_name);
Tim Peters2a799bf2002-12-16 20:18:38 +0000859 }
860
Tim Peters2a799bf2002-12-16 20:18:38 +0000861 Py_DECREF(u);
862 if (result < -1439 || result > 1439) {
863 PyErr_Format(PyExc_ValueError,
Neal Norwitz506a2242003-01-04 01:02:25 +0000864 "tzinfo.%s() returned %d; must be in "
Tim Peters2a799bf2002-12-16 20:18:38 +0000865 "-1439 .. 1439",
866 name, result);
867 result = -1;
868 }
Tim Peters397301e2003-01-02 21:28:08 +0000869 return result;
Tim Peters2a799bf2002-12-16 20:18:38 +0000870}
871
872/* Call tzinfo.utcoffset(tzinfoarg), and extract an integer from the
873 * result. tzinfo must be an instance of the tzinfo class. If utcoffset()
874 * returns None, call_utcoffset returns 0 and sets *none to 1. If uctoffset()
Tim Peters397301e2003-01-02 21:28:08 +0000875 * doesn't return None or timedelta, TypeError is raised and this returns -1.
876 * If utcoffset() returns an invalid timedelta (out of range, or not a whole
877 * # of minutes), ValueError is raised and this returns -1. Else *none is
878 * set to 0 and the offset is returned (as int # of minutes east of UTC).
Tim Peters2a799bf2002-12-16 20:18:38 +0000879 */
880static int
881call_utcoffset(PyObject *tzinfo, PyObject *tzinfoarg, int *none)
882{
883 return call_utc_tzinfo_method(tzinfo, "utcoffset", tzinfoarg, none);
884}
885
Tim Petersbad8ff02002-12-30 20:52:32 +0000886/* Call tzinfo.name(tzinfoarg), and return the offset as a timedelta or None.
887 */
Tim Peters855fe882002-12-22 03:43:39 +0000888static PyObject *
Tim Petersbad8ff02002-12-30 20:52:32 +0000889offset_as_timedelta(PyObject *tzinfo, char *name, PyObject *tzinfoarg) {
Tim Peters855fe882002-12-22 03:43:39 +0000890 PyObject *result;
891
Tim Petersbad8ff02002-12-30 20:52:32 +0000892 assert(tzinfo && name && tzinfoarg);
Tim Peters855fe882002-12-22 03:43:39 +0000893 if (tzinfo == Py_None) {
894 result = Py_None;
895 Py_INCREF(result);
896 }
897 else {
898 int none;
Tim Petersbad8ff02002-12-30 20:52:32 +0000899 int offset = call_utc_tzinfo_method(tzinfo, name, tzinfoarg,
900 &none);
Tim Peters855fe882002-12-22 03:43:39 +0000901 if (offset < 0 && PyErr_Occurred())
902 return NULL;
903 if (none) {
904 result = Py_None;
905 Py_INCREF(result);
906 }
907 else
908 result = new_delta(0, offset * 60, 0, 1);
909 }
910 return result;
911}
912
Tim Peters2a799bf2002-12-16 20:18:38 +0000913/* Call tzinfo.dst(tzinfoarg), and extract an integer from the
914 * result. tzinfo must be an instance of the tzinfo class. If dst()
915 * returns None, call_dst returns 0 and sets *none to 1. If dst()
Tim Peters397301e2003-01-02 21:28:08 +0000916 & doesn't return None or timedelta, TypeError is raised and this
Walter Dörwaldf0dfc7a2003-10-20 14:01:56 +0000917 * returns -1. If dst() returns an invalid timedelta for a UTC offset,
Tim Peters397301e2003-01-02 21:28:08 +0000918 * ValueError is raised and this returns -1. Else *none is set to 0 and
919 * the offset is returned (as an int # of minutes east of UTC).
Tim Peters2a799bf2002-12-16 20:18:38 +0000920 */
921static int
922call_dst(PyObject *tzinfo, PyObject *tzinfoarg, int *none)
923{
924 return call_utc_tzinfo_method(tzinfo, "dst", tzinfoarg, none);
925}
926
Tim Petersbad8ff02002-12-30 20:52:32 +0000927/* Call tzinfo.tzname(tzinfoarg), and return the result. tzinfo must be
Tim Peters855fe882002-12-22 03:43:39 +0000928 * an instance of the tzinfo class or None. If tzinfo isn't None, and
Tim Petersbad8ff02002-12-30 20:52:32 +0000929 * tzname() doesn't return None or a string, TypeError is raised and this
Guido van Rossume3d1d412007-05-23 21:24:35 +0000930 * returns NULL. If the result is a string, we ensure it is a Unicode
931 * string.
Tim Peters2a799bf2002-12-16 20:18:38 +0000932 */
933static PyObject *
Tim Petersbad8ff02002-12-30 20:52:32 +0000934call_tzname(PyObject *tzinfo, PyObject *tzinfoarg)
Tim Peters2a799bf2002-12-16 20:18:38 +0000935{
936 PyObject *result;
937
938 assert(tzinfo != NULL);
Tim Peters855fe882002-12-22 03:43:39 +0000939 assert(check_tzinfo_subclass(tzinfo) >= 0);
Tim Petersbad8ff02002-12-30 20:52:32 +0000940 assert(tzinfoarg != NULL);
Tim Peters2a799bf2002-12-16 20:18:38 +0000941
Tim Peters855fe882002-12-22 03:43:39 +0000942 if (tzinfo == Py_None) {
943 result = Py_None;
944 Py_INCREF(result);
945 }
946 else
Tim Petersbad8ff02002-12-30 20:52:32 +0000947 result = PyObject_CallMethod(tzinfo, "tzname", "O", tzinfoarg);
Tim Peters855fe882002-12-22 03:43:39 +0000948
Guido van Rossume3d1d412007-05-23 21:24:35 +0000949 if (result != NULL && result != Py_None) {
950 if (!PyString_Check(result) && !PyUnicode_Check(result)) {
951 PyErr_Format(PyExc_TypeError, "tzinfo.tzname() must "
952 "return None or a string, not '%s'",
953 result->ob_type->tp_name);
954 Py_DECREF(result);
955 result = NULL;
956 }
957 else if (!PyUnicode_Check(result)) {
958 PyObject *temp = PyUnicode_FromObject(result);
959 Py_DECREF(result);
960 result = temp;
961 }
Tim Peters2a799bf2002-12-16 20:18:38 +0000962 }
963 return result;
964}
965
966typedef enum {
967 /* an exception has been set; the caller should pass it on */
968 OFFSET_ERROR,
969
Tim Petersa9bc1682003-01-11 03:39:11 +0000970 /* type isn't date, datetime, or time subclass */
Tim Peters2a799bf2002-12-16 20:18:38 +0000971 OFFSET_UNKNOWN,
972
973 /* date,
Tim Petersa9bc1682003-01-11 03:39:11 +0000974 * datetime with !hastzinfo
975 * datetime with None tzinfo,
976 * datetime where utcoffset() returns None
Tim Peters37f39822003-01-10 03:49:02 +0000977 * time with !hastzinfo
978 * time with None tzinfo,
979 * time where utcoffset() returns None
Tim Peters2a799bf2002-12-16 20:18:38 +0000980 */
981 OFFSET_NAIVE,
982
Tim Petersa9bc1682003-01-11 03:39:11 +0000983 /* time or datetime where utcoffset() doesn't return None */
Georg Brandle810fe22006-02-19 15:28:47 +0000984 OFFSET_AWARE
Tim Peters2a799bf2002-12-16 20:18:38 +0000985} naivety;
986
Tim Peters14b69412002-12-22 18:10:22 +0000987/* Classify an object as to whether it's naive or offset-aware. See
Tim Peters2a799bf2002-12-16 20:18:38 +0000988 * the "naivety" typedef for details. If the type is aware, *offset is set
989 * to minutes east of UTC (as returned by the tzinfo.utcoffset() method).
Tim Peters14b69412002-12-22 18:10:22 +0000990 * If the type is offset-naive (or unknown, or error), *offset is set to 0.
Tim Peterse39a80c2002-12-30 21:28:52 +0000991 * tzinfoarg is the argument to pass to the tzinfo.utcoffset() method.
Tim Peters2a799bf2002-12-16 20:18:38 +0000992 */
993static naivety
Tim Peterse39a80c2002-12-30 21:28:52 +0000994classify_utcoffset(PyObject *op, PyObject *tzinfoarg, int *offset)
Tim Peters2a799bf2002-12-16 20:18:38 +0000995{
996 int none;
997 PyObject *tzinfo;
998
Tim Peterse39a80c2002-12-30 21:28:52 +0000999 assert(tzinfoarg != NULL);
Tim Peters2a799bf2002-12-16 20:18:38 +00001000 *offset = 0;
Tim Peters14b69412002-12-22 18:10:22 +00001001 tzinfo = get_tzinfo_member(op); /* NULL means no tzinfo, not error */
Tim Peters2a799bf2002-12-16 20:18:38 +00001002 if (tzinfo == Py_None)
1003 return OFFSET_NAIVE;
Tim Peters14b69412002-12-22 18:10:22 +00001004 if (tzinfo == NULL) {
1005 /* note that a datetime passes the PyDate_Check test */
1006 return (PyTime_Check(op) || PyDate_Check(op)) ?
1007 OFFSET_NAIVE : OFFSET_UNKNOWN;
1008 }
Tim Peterse39a80c2002-12-30 21:28:52 +00001009 *offset = call_utcoffset(tzinfo, tzinfoarg, &none);
Tim Peters2a799bf2002-12-16 20:18:38 +00001010 if (*offset == -1 && PyErr_Occurred())
1011 return OFFSET_ERROR;
1012 return none ? OFFSET_NAIVE : OFFSET_AWARE;
1013}
1014
Tim Peters00237032002-12-27 02:21:51 +00001015/* Classify two objects as to whether they're naive or offset-aware.
1016 * This isn't quite the same as calling classify_utcoffset() twice: for
1017 * binary operations (comparison and subtraction), we generally want to
1018 * ignore the tzinfo members if they're identical. This is by design,
1019 * so that results match "naive" expectations when mixing objects from a
1020 * single timezone. So in that case, this sets both offsets to 0 and
1021 * both naiveties to OFFSET_NAIVE.
1022 * The function returns 0 if everything's OK, and -1 on error.
1023 */
1024static int
1025classify_two_utcoffsets(PyObject *o1, int *offset1, naivety *n1,
Tim Peterse39a80c2002-12-30 21:28:52 +00001026 PyObject *tzinfoarg1,
1027 PyObject *o2, int *offset2, naivety *n2,
1028 PyObject *tzinfoarg2)
Tim Peters00237032002-12-27 02:21:51 +00001029{
1030 if (get_tzinfo_member(o1) == get_tzinfo_member(o2)) {
1031 *offset1 = *offset2 = 0;
1032 *n1 = *n2 = OFFSET_NAIVE;
1033 }
1034 else {
Tim Peterse39a80c2002-12-30 21:28:52 +00001035 *n1 = classify_utcoffset(o1, tzinfoarg1, offset1);
Tim Peters00237032002-12-27 02:21:51 +00001036 if (*n1 == OFFSET_ERROR)
1037 return -1;
Tim Peterse39a80c2002-12-30 21:28:52 +00001038 *n2 = classify_utcoffset(o2, tzinfoarg2, offset2);
Tim Peters00237032002-12-27 02:21:51 +00001039 if (*n2 == OFFSET_ERROR)
1040 return -1;
1041 }
1042 return 0;
1043}
1044
Tim Peters2a799bf2002-12-16 20:18:38 +00001045/* repr is like "someclass(arg1, arg2)". If tzinfo isn't None,
1046 * stuff
1047 * ", tzinfo=" + repr(tzinfo)
1048 * before the closing ")".
1049 */
1050static PyObject *
1051append_keyword_tzinfo(PyObject *repr, PyObject *tzinfo)
1052{
1053 PyObject *temp;
1054
Walter Dörwald1ab83302007-05-18 17:15:44 +00001055 assert(PyUnicode_Check(repr));
Tim Peters2a799bf2002-12-16 20:18:38 +00001056 assert(tzinfo);
1057 if (tzinfo == Py_None)
1058 return repr;
1059 /* Get rid of the trailing ')'. */
Walter Dörwald1ab83302007-05-18 17:15:44 +00001060 assert(PyUnicode_AS_UNICODE(repr)[PyUnicode_GET_SIZE(repr)-1] == ')');
1061 temp = PyUnicode_FromUnicode(PyUnicode_AS_UNICODE(repr),
1062 PyUnicode_GET_SIZE(repr) - 1);
Tim Peters2a799bf2002-12-16 20:18:38 +00001063 Py_DECREF(repr);
1064 if (temp == NULL)
1065 return NULL;
Walter Dörwald517bcfe2007-05-23 20:45:05 +00001066 repr = PyUnicode_FromFormat("%U, tzinfo=%R)", temp, tzinfo);
1067 Py_DECREF(temp);
Tim Peters2a799bf2002-12-16 20:18:38 +00001068 return repr;
1069}
1070
1071/* ---------------------------------------------------------------------------
1072 * String format helpers.
1073 */
1074
1075static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00001076format_ctime(PyDateTime_Date *date, int hours, int minutes, int seconds)
Tim Peters2a799bf2002-12-16 20:18:38 +00001077{
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001078 static const char *DayNames[] = {
Tim Peters2a799bf2002-12-16 20:18:38 +00001079 "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"
1080 };
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001081 static const char *MonthNames[] = {
Tim Peters2a799bf2002-12-16 20:18:38 +00001082 "Jan", "Feb", "Mar", "Apr", "May", "Jun",
1083 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
1084 };
1085
Tim Peters2a799bf2002-12-16 20:18:38 +00001086 int wday = weekday(GET_YEAR(date), GET_MONTH(date), GET_DAY(date));
1087
Walter Dörwald4af32b32007-05-31 16:19:50 +00001088 return PyUnicode_FromFormat("%s %s %2d %02d:%02d:%02d %04d",
1089 DayNames[wday], MonthNames[GET_MONTH(date)-1],
1090 GET_DAY(date), hours, minutes, seconds,
1091 GET_YEAR(date));
Tim Peters2a799bf2002-12-16 20:18:38 +00001092}
1093
1094/* Add an hours & minutes UTC offset string to buf. buf has no more than
1095 * buflen bytes remaining. The UTC offset is gotten by calling
1096 * tzinfo.uctoffset(tzinfoarg). If that returns None, \0 is stored into
1097 * *buf, and that's all. Else the returned value is checked for sanity (an
1098 * integer in range), and if that's OK it's converted to an hours & minutes
1099 * string of the form
1100 * sign HH sep MM
1101 * Returns 0 if everything is OK. If the return value from utcoffset() is
1102 * bogus, an appropriate exception is set and -1 is returned.
1103 */
1104static int
Tim Peters328fff72002-12-20 01:31:27 +00001105format_utcoffset(char *buf, size_t buflen, const char *sep,
Tim Peters2a799bf2002-12-16 20:18:38 +00001106 PyObject *tzinfo, PyObject *tzinfoarg)
1107{
1108 int offset;
1109 int hours;
1110 int minutes;
1111 char sign;
1112 int none;
1113
1114 offset = call_utcoffset(tzinfo, tzinfoarg, &none);
1115 if (offset == -1 && PyErr_Occurred())
1116 return -1;
1117 if (none) {
1118 *buf = '\0';
1119 return 0;
1120 }
1121 sign = '+';
1122 if (offset < 0) {
1123 sign = '-';
1124 offset = - offset;
1125 }
1126 hours = divmod(offset, 60, &minutes);
1127 PyOS_snprintf(buf, buflen, "%c%02d%s%02d", sign, hours, sep, minutes);
1128 return 0;
1129}
1130
Guido van Rossumd8595fe2007-05-23 21:36:49 +00001131static PyObject *
1132make_Zreplacement(PyObject *object, PyObject *tzinfoarg)
1133{
1134 PyObject *tzinfo = get_tzinfo_member(object);
1135 PyObject *Zreplacement = PyString_FromString("");
1136 if (Zreplacement == NULL)
1137 return NULL;
1138 if (tzinfo != Py_None && tzinfo != NULL) {
1139 PyObject *temp;
1140 assert(tzinfoarg != NULL);
1141 temp = call_tzname(tzinfo, tzinfoarg);
1142 if (temp == NULL)
1143 goto Error;
1144 if (temp != Py_None) {
1145 assert(PyUnicode_Check(temp));
1146 /* Since the tzname is getting stuffed into the
1147 * format, we have to double any % signs so that
1148 * strftime doesn't treat them as format codes.
1149 */
1150 Py_DECREF(Zreplacement);
1151 Zreplacement = PyObject_CallMethod(temp, "replace",
1152 "ss", "%", "%%");
1153 Py_DECREF(temp);
1154 if (Zreplacement == NULL)
1155 return NULL;
1156 if (PyUnicode_Check(Zreplacement)) {
1157 Zreplacement =
1158 _PyUnicode_AsDefaultEncodedString(
1159 Zreplacement, NULL);
1160 if (Zreplacement == NULL)
1161 return NULL;
1162 }
1163 if (!PyString_Check(Zreplacement)) {
1164 PyErr_SetString(PyExc_TypeError,
1165 "tzname.replace() did not return a string");
1166 goto Error;
1167 }
1168 }
1169 else
1170 Py_DECREF(temp);
1171 }
1172 return Zreplacement;
1173
1174 Error:
1175 Py_DECREF(Zreplacement);
1176 return NULL;
1177}
1178
Tim Peters2a799bf2002-12-16 20:18:38 +00001179/* I sure don't want to reproduce the strftime code from the time module,
1180 * so this imports the module and calls it. All the hair is due to
1181 * giving special meanings to the %z and %Z format codes via a preprocessing
1182 * step on the format string.
Tim Petersbad8ff02002-12-30 20:52:32 +00001183 * tzinfoarg is the argument to pass to the object's tzinfo method, if
1184 * needed.
Tim Peters2a799bf2002-12-16 20:18:38 +00001185 */
1186static PyObject *
Tim Petersbad8ff02002-12-30 20:52:32 +00001187wrap_strftime(PyObject *object, PyObject *format, PyObject *timetuple,
1188 PyObject *tzinfoarg)
Tim Peters2a799bf2002-12-16 20:18:38 +00001189{
1190 PyObject *result = NULL; /* guilty until proved innocent */
1191
1192 PyObject *zreplacement = NULL; /* py string, replacement for %z */
1193 PyObject *Zreplacement = NULL; /* py string, replacement for %Z */
1194
Guido van Rossumbce56a62007-05-10 18:04:33 +00001195 const char *pin;/* pointer to next char in input format */
1196 Py_ssize_t flen;/* length of input format */
Tim Peters2a799bf2002-12-16 20:18:38 +00001197 char ch; /* next char in input format */
1198
1199 PyObject *newfmt = NULL; /* py string, the output format */
1200 char *pnew; /* pointer to available byte in output format */
Thomas Wouters89f507f2006-12-13 04:49:30 +00001201 int totalnew; /* number bytes total in output format buffer,
Tim Peters2a799bf2002-12-16 20:18:38 +00001202 exclusive of trailing \0 */
Thomas Wouters89f507f2006-12-13 04:49:30 +00001203 int usednew; /* number bytes used so far in output format buffer */
Tim Peters2a799bf2002-12-16 20:18:38 +00001204
Guido van Rossumbce56a62007-05-10 18:04:33 +00001205 const char *ptoappend;/* pointer to string to append to output buffer */
Tim Peters2a799bf2002-12-16 20:18:38 +00001206 int ntoappend; /* # of bytes to append to output buffer */
1207
Tim Peters2a799bf2002-12-16 20:18:38 +00001208 assert(object && format && timetuple);
Guido van Rossumbce56a62007-05-10 18:04:33 +00001209 assert(PyString_Check(format) || PyUnicode_Check(format));
1210
1211 /* Convert the input format to a C string and size */
1212 if (PyObject_AsCharBuffer(format, &pin, &flen) < 0)
1213 return NULL;
Tim Peters2a799bf2002-12-16 20:18:38 +00001214
Tim Petersd6844152002-12-22 20:58:42 +00001215 /* Give up if the year is before 1900.
1216 * Python strftime() plays games with the year, and different
1217 * games depending on whether envar PYTHON2K is set. This makes
1218 * years before 1900 a nightmare, even if the platform strftime
1219 * supports them (and not all do).
1220 * We could get a lot farther here by avoiding Python's strftime
1221 * wrapper and calling the C strftime() directly, but that isn't
1222 * an option in the Python implementation of this module.
1223 */
1224 {
1225 long year;
1226 PyObject *pyyear = PySequence_GetItem(timetuple, 0);
1227 if (pyyear == NULL) return NULL;
1228 assert(PyInt_Check(pyyear));
1229 year = PyInt_AsLong(pyyear);
1230 Py_DECREF(pyyear);
1231 if (year < 1900) {
1232 PyErr_Format(PyExc_ValueError, "year=%ld is before "
1233 "1900; the datetime strftime() "
1234 "methods require year >= 1900",
1235 year);
1236 return NULL;
1237 }
1238 }
1239
Tim Peters2a799bf2002-12-16 20:18:38 +00001240 /* Scan the input format, looking for %z and %Z escapes, building
Tim Peters328fff72002-12-20 01:31:27 +00001241 * a new format. Since computing the replacements for those codes
1242 * is expensive, don't unless they're actually used.
Tim Peters2a799bf2002-12-16 20:18:38 +00001243 */
Guido van Rossumbce56a62007-05-10 18:04:33 +00001244 totalnew = flen + 1; /* realistic if no %z/%Z */
Tim Peters2a799bf2002-12-16 20:18:38 +00001245 newfmt = PyString_FromStringAndSize(NULL, totalnew);
1246 if (newfmt == NULL) goto Done;
1247 pnew = PyString_AsString(newfmt);
1248 usednew = 0;
1249
Tim Peters2a799bf2002-12-16 20:18:38 +00001250 while ((ch = *pin++) != '\0') {
1251 if (ch != '%') {
Tim Peters328fff72002-12-20 01:31:27 +00001252 ptoappend = pin - 1;
Tim Peters2a799bf2002-12-16 20:18:38 +00001253 ntoappend = 1;
1254 }
1255 else if ((ch = *pin++) == '\0') {
1256 /* There's a lone trailing %; doesn't make sense. */
1257 PyErr_SetString(PyExc_ValueError, "strftime format "
1258 "ends with raw %");
1259 goto Done;
1260 }
1261 /* A % has been seen and ch is the character after it. */
1262 else if (ch == 'z') {
1263 if (zreplacement == NULL) {
1264 /* format utcoffset */
Tim Peters328fff72002-12-20 01:31:27 +00001265 char buf[100];
Tim Peters2a799bf2002-12-16 20:18:38 +00001266 PyObject *tzinfo = get_tzinfo_member(object);
1267 zreplacement = PyString_FromString("");
1268 if (zreplacement == NULL) goto Done;
1269 if (tzinfo != Py_None && tzinfo != NULL) {
Tim Petersbad8ff02002-12-30 20:52:32 +00001270 assert(tzinfoarg != NULL);
Tim Peters2a799bf2002-12-16 20:18:38 +00001271 if (format_utcoffset(buf,
Tim Peters328fff72002-12-20 01:31:27 +00001272 sizeof(buf),
Tim Peters2a799bf2002-12-16 20:18:38 +00001273 "",
1274 tzinfo,
Tim Petersbad8ff02002-12-30 20:52:32 +00001275 tzinfoarg) < 0)
Tim Peters2a799bf2002-12-16 20:18:38 +00001276 goto Done;
1277 Py_DECREF(zreplacement);
1278 zreplacement = PyString_FromString(buf);
1279 if (zreplacement == NULL) goto Done;
1280 }
1281 }
1282 assert(zreplacement != NULL);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001283 ptoappend = PyString_AS_STRING(zreplacement);
1284 ntoappend = PyString_GET_SIZE(zreplacement);
Tim Peters2a799bf2002-12-16 20:18:38 +00001285 }
1286 else if (ch == 'Z') {
1287 /* format tzname */
1288 if (Zreplacement == NULL) {
Guido van Rossumd8595fe2007-05-23 21:36:49 +00001289 Zreplacement = make_Zreplacement(object,
1290 tzinfoarg);
1291 if (Zreplacement == NULL)
1292 goto Done;
Tim Peters2a799bf2002-12-16 20:18:38 +00001293 }
1294 assert(Zreplacement != NULL);
Guido van Rossumd8595fe2007-05-23 21:36:49 +00001295 assert(PyString_Check(Zreplacement));
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001296 ptoappend = PyString_AS_STRING(Zreplacement);
1297 ntoappend = PyString_GET_SIZE(Zreplacement);
Tim Peters2a799bf2002-12-16 20:18:38 +00001298 }
1299 else {
Tim Peters328fff72002-12-20 01:31:27 +00001300 /* percent followed by neither z nor Z */
1301 ptoappend = pin - 2;
Tim Peters2a799bf2002-12-16 20:18:38 +00001302 ntoappend = 2;
1303 }
1304
1305 /* Append the ntoappend chars starting at ptoappend to
1306 * the new format.
1307 */
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001308 assert(ptoappend != NULL);
Tim Peters2a799bf2002-12-16 20:18:38 +00001309 assert(ntoappend >= 0);
1310 if (ntoappend == 0)
1311 continue;
1312 while (usednew + ntoappend > totalnew) {
1313 int bigger = totalnew << 1;
1314 if ((bigger >> 1) != totalnew) { /* overflow */
1315 PyErr_NoMemory();
1316 goto Done;
1317 }
1318 if (_PyString_Resize(&newfmt, bigger) < 0)
1319 goto Done;
1320 totalnew = bigger;
1321 pnew = PyString_AsString(newfmt) + usednew;
1322 }
1323 memcpy(pnew, ptoappend, ntoappend);
1324 pnew += ntoappend;
1325 usednew += ntoappend;
1326 assert(usednew <= totalnew);
1327 } /* end while() */
1328
1329 if (_PyString_Resize(&newfmt, usednew) < 0)
1330 goto Done;
1331 {
1332 PyObject *time = PyImport_ImportModule("time");
1333 if (time == NULL)
1334 goto Done;
1335 result = PyObject_CallMethod(time, "strftime", "OO",
1336 newfmt, timetuple);
1337 Py_DECREF(time);
1338 }
1339 Done:
1340 Py_XDECREF(zreplacement);
1341 Py_XDECREF(Zreplacement);
1342 Py_XDECREF(newfmt);
1343 return result;
1344}
1345
Tim Peters2a799bf2002-12-16 20:18:38 +00001346/* ---------------------------------------------------------------------------
1347 * Wrap functions from the time module. These aren't directly available
1348 * from C. Perhaps they should be.
1349 */
1350
1351/* Call time.time() and return its result (a Python float). */
1352static PyObject *
Guido van Rossumbd43e912002-12-16 20:34:55 +00001353time_time(void)
Tim Peters2a799bf2002-12-16 20:18:38 +00001354{
1355 PyObject *result = NULL;
1356 PyObject *time = PyImport_ImportModule("time");
1357
1358 if (time != NULL) {
1359 result = PyObject_CallMethod(time, "time", "()");
1360 Py_DECREF(time);
1361 }
1362 return result;
1363}
1364
1365/* Build a time.struct_time. The weekday and day number are automatically
1366 * computed from the y,m,d args.
1367 */
1368static PyObject *
1369build_struct_time(int y, int m, int d, int hh, int mm, int ss, int dstflag)
1370{
1371 PyObject *time;
1372 PyObject *result = NULL;
1373
1374 time = PyImport_ImportModule("time");
1375 if (time != NULL) {
1376 result = PyObject_CallMethod(time, "struct_time",
1377 "((iiiiiiiii))",
1378 y, m, d,
1379 hh, mm, ss,
1380 weekday(y, m, d),
1381 days_before_month(y, m) + d,
1382 dstflag);
1383 Py_DECREF(time);
1384 }
1385 return result;
1386}
1387
1388/* ---------------------------------------------------------------------------
1389 * Miscellaneous helpers.
1390 */
1391
Guido van Rossum19960592006-08-24 17:29:38 +00001392/* For various reasons, we need to use tp_richcompare instead of tp_compare.
Tim Peters2a799bf2002-12-16 20:18:38 +00001393 * The comparisons here all most naturally compute a cmp()-like result.
1394 * This little helper turns that into a bool result for rich comparisons.
1395 */
1396static PyObject *
1397diff_to_bool(int diff, int op)
1398{
1399 PyObject *result;
1400 int istrue;
1401
1402 switch (op) {
1403 case Py_EQ: istrue = diff == 0; break;
1404 case Py_NE: istrue = diff != 0; break;
1405 case Py_LE: istrue = diff <= 0; break;
1406 case Py_GE: istrue = diff >= 0; break;
1407 case Py_LT: istrue = diff < 0; break;
1408 case Py_GT: istrue = diff > 0; break;
1409 default:
1410 assert(! "op unknown");
1411 istrue = 0; /* To shut up compiler */
1412 }
1413 result = istrue ? Py_True : Py_False;
1414 Py_INCREF(result);
1415 return result;
1416}
1417
Tim Peters07534a62003-02-07 22:50:28 +00001418/* Raises a "can't compare" TypeError and returns NULL. */
1419static PyObject *
1420cmperror(PyObject *a, PyObject *b)
1421{
1422 PyErr_Format(PyExc_TypeError,
1423 "can't compare %s to %s",
1424 a->ob_type->tp_name, b->ob_type->tp_name);
1425 return NULL;
1426}
1427
Tim Peters2a799bf2002-12-16 20:18:38 +00001428/* ---------------------------------------------------------------------------
Tim Peters2a799bf2002-12-16 20:18:38 +00001429 * Cached Python objects; these are set by the module init function.
1430 */
1431
1432/* Conversion factors. */
1433static PyObject *us_per_us = NULL; /* 1 */
1434static PyObject *us_per_ms = NULL; /* 1000 */
1435static PyObject *us_per_second = NULL; /* 1000000 */
1436static PyObject *us_per_minute = NULL; /* 1e6 * 60 as Python int */
1437static PyObject *us_per_hour = NULL; /* 1e6 * 3600 as Python long */
1438static PyObject *us_per_day = NULL; /* 1e6 * 3600 * 24 as Python long */
1439static PyObject *us_per_week = NULL; /* 1e6*3600*24*7 as Python long */
1440static PyObject *seconds_per_day = NULL; /* 3600*24 as Python int */
1441
Tim Peters2a799bf2002-12-16 20:18:38 +00001442/* ---------------------------------------------------------------------------
1443 * Class implementations.
1444 */
1445
1446/*
1447 * PyDateTime_Delta implementation.
1448 */
1449
1450/* Convert a timedelta to a number of us,
1451 * (24*3600*self.days + self.seconds)*1000000 + self.microseconds
1452 * as a Python int or long.
1453 * Doing mixed-radix arithmetic by hand instead is excruciating in C,
1454 * due to ubiquitous overflow possibilities.
1455 */
1456static PyObject *
1457delta_to_microseconds(PyDateTime_Delta *self)
1458{
1459 PyObject *x1 = NULL;
1460 PyObject *x2 = NULL;
1461 PyObject *x3 = NULL;
1462 PyObject *result = NULL;
1463
1464 x1 = PyInt_FromLong(GET_TD_DAYS(self));
1465 if (x1 == NULL)
1466 goto Done;
1467 x2 = PyNumber_Multiply(x1, seconds_per_day); /* days in seconds */
1468 if (x2 == NULL)
1469 goto Done;
1470 Py_DECREF(x1);
1471 x1 = NULL;
1472
1473 /* x2 has days in seconds */
1474 x1 = PyInt_FromLong(GET_TD_SECONDS(self)); /* seconds */
1475 if (x1 == NULL)
1476 goto Done;
1477 x3 = PyNumber_Add(x1, x2); /* days and seconds in seconds */
1478 if (x3 == NULL)
1479 goto Done;
1480 Py_DECREF(x1);
1481 Py_DECREF(x2);
1482 x1 = x2 = NULL;
1483
1484 /* x3 has days+seconds in seconds */
1485 x1 = PyNumber_Multiply(x3, us_per_second); /* us */
1486 if (x1 == NULL)
1487 goto Done;
1488 Py_DECREF(x3);
1489 x3 = NULL;
1490
1491 /* x1 has days+seconds in us */
1492 x2 = PyInt_FromLong(GET_TD_MICROSECONDS(self));
1493 if (x2 == NULL)
1494 goto Done;
1495 result = PyNumber_Add(x1, x2);
1496
1497Done:
1498 Py_XDECREF(x1);
1499 Py_XDECREF(x2);
1500 Py_XDECREF(x3);
1501 return result;
1502}
1503
1504/* Convert a number of us (as a Python int or long) to a timedelta.
1505 */
1506static PyObject *
Tim Petersb0c854d2003-05-17 15:57:00 +00001507microseconds_to_delta_ex(PyObject *pyus, PyTypeObject *type)
Tim Peters2a799bf2002-12-16 20:18:38 +00001508{
1509 int us;
1510 int s;
1511 int d;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001512 long temp;
Tim Peters2a799bf2002-12-16 20:18:38 +00001513
1514 PyObject *tuple = NULL;
1515 PyObject *num = NULL;
1516 PyObject *result = NULL;
1517
1518 tuple = PyNumber_Divmod(pyus, us_per_second);
1519 if (tuple == NULL)
1520 goto Done;
1521
1522 num = PyTuple_GetItem(tuple, 1); /* us */
1523 if (num == NULL)
1524 goto Done;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001525 temp = PyLong_AsLong(num);
Tim Peters2a799bf2002-12-16 20:18:38 +00001526 num = NULL;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001527 if (temp == -1 && PyErr_Occurred())
1528 goto Done;
1529 assert(0 <= temp && temp < 1000000);
1530 us = (int)temp;
Tim Peters2a799bf2002-12-16 20:18:38 +00001531 if (us < 0) {
1532 /* The divisor was positive, so this must be an error. */
1533 assert(PyErr_Occurred());
1534 goto Done;
1535 }
1536
1537 num = PyTuple_GetItem(tuple, 0); /* leftover seconds */
1538 if (num == NULL)
1539 goto Done;
1540 Py_INCREF(num);
1541 Py_DECREF(tuple);
1542
1543 tuple = PyNumber_Divmod(num, seconds_per_day);
1544 if (tuple == NULL)
1545 goto Done;
1546 Py_DECREF(num);
1547
1548 num = PyTuple_GetItem(tuple, 1); /* seconds */
1549 if (num == NULL)
1550 goto Done;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001551 temp = PyLong_AsLong(num);
Tim Peters2a799bf2002-12-16 20:18:38 +00001552 num = NULL;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001553 if (temp == -1 && PyErr_Occurred())
1554 goto Done;
1555 assert(0 <= temp && temp < 24*3600);
1556 s = (int)temp;
1557
Tim Peters2a799bf2002-12-16 20:18:38 +00001558 if (s < 0) {
1559 /* The divisor was positive, so this must be an error. */
1560 assert(PyErr_Occurred());
1561 goto Done;
1562 }
1563
1564 num = PyTuple_GetItem(tuple, 0); /* leftover days */
1565 if (num == NULL)
1566 goto Done;
1567 Py_INCREF(num);
Tim Peters0b0f41c2002-12-19 01:44:38 +00001568 temp = PyLong_AsLong(num);
1569 if (temp == -1 && PyErr_Occurred())
Tim Peters2a799bf2002-12-16 20:18:38 +00001570 goto Done;
Tim Peters0b0f41c2002-12-19 01:44:38 +00001571 d = (int)temp;
1572 if ((long)d != temp) {
1573 PyErr_SetString(PyExc_OverflowError, "normalized days too "
1574 "large to fit in a C int");
1575 goto Done;
1576 }
Tim Petersb0c854d2003-05-17 15:57:00 +00001577 result = new_delta_ex(d, s, us, 0, type);
Tim Peters2a799bf2002-12-16 20:18:38 +00001578
1579Done:
1580 Py_XDECREF(tuple);
1581 Py_XDECREF(num);
1582 return result;
1583}
1584
Tim Petersb0c854d2003-05-17 15:57:00 +00001585#define microseconds_to_delta(pymicros) \
1586 microseconds_to_delta_ex(pymicros, &PyDateTime_DeltaType)
1587
Tim Peters2a799bf2002-12-16 20:18:38 +00001588static PyObject *
1589multiply_int_timedelta(PyObject *intobj, PyDateTime_Delta *delta)
1590{
1591 PyObject *pyus_in;
1592 PyObject *pyus_out;
1593 PyObject *result;
1594
1595 pyus_in = delta_to_microseconds(delta);
1596 if (pyus_in == NULL)
1597 return NULL;
1598
1599 pyus_out = PyNumber_Multiply(pyus_in, intobj);
1600 Py_DECREF(pyus_in);
1601 if (pyus_out == NULL)
1602 return NULL;
1603
1604 result = microseconds_to_delta(pyus_out);
1605 Py_DECREF(pyus_out);
1606 return result;
1607}
1608
1609static PyObject *
1610divide_timedelta_int(PyDateTime_Delta *delta, PyObject *intobj)
1611{
1612 PyObject *pyus_in;
1613 PyObject *pyus_out;
1614 PyObject *result;
1615
1616 pyus_in = delta_to_microseconds(delta);
1617 if (pyus_in == NULL)
1618 return NULL;
1619
1620 pyus_out = PyNumber_FloorDivide(pyus_in, intobj);
1621 Py_DECREF(pyus_in);
1622 if (pyus_out == NULL)
1623 return NULL;
1624
1625 result = microseconds_to_delta(pyus_out);
1626 Py_DECREF(pyus_out);
1627 return result;
1628}
1629
1630static PyObject *
1631delta_add(PyObject *left, PyObject *right)
1632{
1633 PyObject *result = Py_NotImplemented;
1634
1635 if (PyDelta_Check(left) && PyDelta_Check(right)) {
1636 /* delta + delta */
1637 /* The C-level additions can't overflow because of the
1638 * invariant bounds.
1639 */
1640 int days = GET_TD_DAYS(left) + GET_TD_DAYS(right);
1641 int seconds = GET_TD_SECONDS(left) + GET_TD_SECONDS(right);
1642 int microseconds = GET_TD_MICROSECONDS(left) +
1643 GET_TD_MICROSECONDS(right);
1644 result = new_delta(days, seconds, microseconds, 1);
1645 }
1646
1647 if (result == Py_NotImplemented)
1648 Py_INCREF(result);
1649 return result;
1650}
1651
1652static PyObject *
1653delta_negative(PyDateTime_Delta *self)
1654{
1655 return new_delta(-GET_TD_DAYS(self),
1656 -GET_TD_SECONDS(self),
1657 -GET_TD_MICROSECONDS(self),
1658 1);
1659}
1660
1661static PyObject *
1662delta_positive(PyDateTime_Delta *self)
1663{
1664 /* Could optimize this (by returning self) if this isn't a
1665 * subclass -- but who uses unary + ? Approximately nobody.
1666 */
1667 return new_delta(GET_TD_DAYS(self),
1668 GET_TD_SECONDS(self),
1669 GET_TD_MICROSECONDS(self),
1670 0);
1671}
1672
1673static PyObject *
1674delta_abs(PyDateTime_Delta *self)
1675{
1676 PyObject *result;
1677
1678 assert(GET_TD_MICROSECONDS(self) >= 0);
1679 assert(GET_TD_SECONDS(self) >= 0);
1680
1681 if (GET_TD_DAYS(self) < 0)
1682 result = delta_negative(self);
1683 else
1684 result = delta_positive(self);
1685
1686 return result;
1687}
1688
1689static PyObject *
1690delta_subtract(PyObject *left, PyObject *right)
1691{
1692 PyObject *result = Py_NotImplemented;
1693
1694 if (PyDelta_Check(left) && PyDelta_Check(right)) {
1695 /* delta - delta */
1696 PyObject *minus_right = PyNumber_Negative(right);
1697 if (minus_right) {
1698 result = delta_add(left, minus_right);
1699 Py_DECREF(minus_right);
1700 }
1701 else
1702 result = NULL;
1703 }
1704
1705 if (result == Py_NotImplemented)
1706 Py_INCREF(result);
1707 return result;
1708}
1709
Tim Peters2a799bf2002-12-16 20:18:38 +00001710static PyObject *
Guido van Rossum19960592006-08-24 17:29:38 +00001711delta_richcompare(PyObject *self, PyObject *other, int op)
Tim Peters2a799bf2002-12-16 20:18:38 +00001712{
Tim Petersaa7d8492003-02-08 03:28:59 +00001713 if (PyDelta_Check(other)) {
Guido van Rossum19960592006-08-24 17:29:38 +00001714 int diff = GET_TD_DAYS(self) - GET_TD_DAYS(other);
Tim Peters07534a62003-02-07 22:50:28 +00001715 if (diff == 0) {
1716 diff = GET_TD_SECONDS(self) - GET_TD_SECONDS(other);
1717 if (diff == 0)
1718 diff = GET_TD_MICROSECONDS(self) -
1719 GET_TD_MICROSECONDS(other);
1720 }
Guido van Rossum19960592006-08-24 17:29:38 +00001721 return diff_to_bool(diff, op);
Tim Peters2a799bf2002-12-16 20:18:38 +00001722 }
Guido van Rossum19960592006-08-24 17:29:38 +00001723 else {
1724 Py_INCREF(Py_NotImplemented);
1725 return Py_NotImplemented;
1726 }
Tim Peters2a799bf2002-12-16 20:18:38 +00001727}
1728
1729static PyObject *delta_getstate(PyDateTime_Delta *self);
1730
1731static long
1732delta_hash(PyDateTime_Delta *self)
1733{
1734 if (self->hashcode == -1) {
1735 PyObject *temp = delta_getstate(self);
1736 if (temp != NULL) {
1737 self->hashcode = PyObject_Hash(temp);
1738 Py_DECREF(temp);
1739 }
1740 }
1741 return self->hashcode;
1742}
1743
1744static PyObject *
1745delta_multiply(PyObject *left, PyObject *right)
1746{
1747 PyObject *result = Py_NotImplemented;
1748
1749 if (PyDelta_Check(left)) {
1750 /* delta * ??? */
1751 if (PyInt_Check(right) || PyLong_Check(right))
1752 result = multiply_int_timedelta(right,
1753 (PyDateTime_Delta *) left);
1754 }
1755 else if (PyInt_Check(left) || PyLong_Check(left))
1756 result = multiply_int_timedelta(left,
1757 (PyDateTime_Delta *) right);
1758
1759 if (result == Py_NotImplemented)
1760 Py_INCREF(result);
1761 return result;
1762}
1763
1764static PyObject *
1765delta_divide(PyObject *left, PyObject *right)
1766{
1767 PyObject *result = Py_NotImplemented;
1768
1769 if (PyDelta_Check(left)) {
1770 /* delta * ??? */
1771 if (PyInt_Check(right) || PyLong_Check(right))
1772 result = divide_timedelta_int(
1773 (PyDateTime_Delta *)left,
1774 right);
1775 }
1776
1777 if (result == Py_NotImplemented)
1778 Py_INCREF(result);
1779 return result;
1780}
1781
1782/* Fold in the value of the tag ("seconds", "weeks", etc) component of a
1783 * timedelta constructor. sofar is the # of microseconds accounted for
1784 * so far, and there are factor microseconds per current unit, the number
1785 * of which is given by num. num * factor is added to sofar in a
1786 * numerically careful way, and that's the result. Any fractional
1787 * microseconds left over (this can happen if num is a float type) are
1788 * added into *leftover.
1789 * Note that there are many ways this can give an error (NULL) return.
1790 */
1791static PyObject *
1792accum(const char* tag, PyObject *sofar, PyObject *num, PyObject *factor,
1793 double *leftover)
1794{
1795 PyObject *prod;
1796 PyObject *sum;
1797
1798 assert(num != NULL);
1799
1800 if (PyInt_Check(num) || PyLong_Check(num)) {
1801 prod = PyNumber_Multiply(num, factor);
1802 if (prod == NULL)
1803 return NULL;
1804 sum = PyNumber_Add(sofar, prod);
1805 Py_DECREF(prod);
1806 return sum;
1807 }
1808
1809 if (PyFloat_Check(num)) {
1810 double dnum;
1811 double fracpart;
1812 double intpart;
1813 PyObject *x;
1814 PyObject *y;
1815
1816 /* The Plan: decompose num into an integer part and a
1817 * fractional part, num = intpart + fracpart.
1818 * Then num * factor ==
1819 * intpart * factor + fracpart * factor
1820 * and the LHS can be computed exactly in long arithmetic.
1821 * The RHS is again broken into an int part and frac part.
1822 * and the frac part is added into *leftover.
1823 */
1824 dnum = PyFloat_AsDouble(num);
1825 if (dnum == -1.0 && PyErr_Occurred())
1826 return NULL;
1827 fracpart = modf(dnum, &intpart);
1828 x = PyLong_FromDouble(intpart);
1829 if (x == NULL)
1830 return NULL;
1831
1832 prod = PyNumber_Multiply(x, factor);
1833 Py_DECREF(x);
1834 if (prod == NULL)
1835 return NULL;
1836
1837 sum = PyNumber_Add(sofar, prod);
1838 Py_DECREF(prod);
1839 if (sum == NULL)
1840 return NULL;
1841
1842 if (fracpart == 0.0)
1843 return sum;
1844 /* So far we've lost no information. Dealing with the
1845 * fractional part requires float arithmetic, and may
1846 * lose a little info.
1847 */
1848 assert(PyInt_Check(factor) || PyLong_Check(factor));
Guido van Rossumddefaf32007-01-14 03:31:43 +00001849 dnum = PyLong_AsDouble(factor);
Tim Peters2a799bf2002-12-16 20:18:38 +00001850
1851 dnum *= fracpart;
1852 fracpart = modf(dnum, &intpart);
1853 x = PyLong_FromDouble(intpart);
1854 if (x == NULL) {
1855 Py_DECREF(sum);
1856 return NULL;
1857 }
1858
1859 y = PyNumber_Add(sum, x);
1860 Py_DECREF(sum);
1861 Py_DECREF(x);
1862 *leftover += fracpart;
1863 return y;
1864 }
1865
1866 PyErr_Format(PyExc_TypeError,
1867 "unsupported type for timedelta %s component: %s",
1868 tag, num->ob_type->tp_name);
1869 return NULL;
1870}
1871
1872static PyObject *
1873delta_new(PyTypeObject *type, PyObject *args, PyObject *kw)
1874{
1875 PyObject *self = NULL;
1876
1877 /* Argument objects. */
1878 PyObject *day = NULL;
1879 PyObject *second = NULL;
1880 PyObject *us = NULL;
1881 PyObject *ms = NULL;
1882 PyObject *minute = NULL;
1883 PyObject *hour = NULL;
1884 PyObject *week = NULL;
1885
1886 PyObject *x = NULL; /* running sum of microseconds */
1887 PyObject *y = NULL; /* temp sum of microseconds */
1888 double leftover_us = 0.0;
1889
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00001890 static char *keywords[] = {
Tim Peters2a799bf2002-12-16 20:18:38 +00001891 "days", "seconds", "microseconds", "milliseconds",
1892 "minutes", "hours", "weeks", NULL
1893 };
1894
1895 if (PyArg_ParseTupleAndKeywords(args, kw, "|OOOOOOO:__new__",
1896 keywords,
1897 &day, &second, &us,
1898 &ms, &minute, &hour, &week) == 0)
1899 goto Done;
1900
1901 x = PyInt_FromLong(0);
1902 if (x == NULL)
1903 goto Done;
1904
1905#define CLEANUP \
1906 Py_DECREF(x); \
1907 x = y; \
1908 if (x == NULL) \
1909 goto Done
1910
1911 if (us) {
1912 y = accum("microseconds", x, us, us_per_us, &leftover_us);
1913 CLEANUP;
1914 }
1915 if (ms) {
1916 y = accum("milliseconds", x, ms, us_per_ms, &leftover_us);
1917 CLEANUP;
1918 }
1919 if (second) {
1920 y = accum("seconds", x, second, us_per_second, &leftover_us);
1921 CLEANUP;
1922 }
1923 if (minute) {
1924 y = accum("minutes", x, minute, us_per_minute, &leftover_us);
1925 CLEANUP;
1926 }
1927 if (hour) {
1928 y = accum("hours", x, hour, us_per_hour, &leftover_us);
1929 CLEANUP;
1930 }
1931 if (day) {
1932 y = accum("days", x, day, us_per_day, &leftover_us);
1933 CLEANUP;
1934 }
1935 if (week) {
1936 y = accum("weeks", x, week, us_per_week, &leftover_us);
1937 CLEANUP;
1938 }
1939 if (leftover_us) {
1940 /* Round to nearest whole # of us, and add into x. */
Tim Peters5d644dd2003-01-02 16:32:54 +00001941 PyObject *temp = PyLong_FromLong(round_to_long(leftover_us));
Tim Peters2a799bf2002-12-16 20:18:38 +00001942 if (temp == NULL) {
1943 Py_DECREF(x);
1944 goto Done;
1945 }
1946 y = PyNumber_Add(x, temp);
1947 Py_DECREF(temp);
1948 CLEANUP;
1949 }
1950
Tim Petersb0c854d2003-05-17 15:57:00 +00001951 self = microseconds_to_delta_ex(x, type);
Tim Peters2a799bf2002-12-16 20:18:38 +00001952 Py_DECREF(x);
1953Done:
1954 return self;
1955
1956#undef CLEANUP
1957}
1958
1959static int
Jack Diederich4dafcc42006-11-28 19:15:13 +00001960delta_bool(PyDateTime_Delta *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00001961{
1962 return (GET_TD_DAYS(self) != 0
1963 || GET_TD_SECONDS(self) != 0
1964 || GET_TD_MICROSECONDS(self) != 0);
1965}
1966
1967static PyObject *
1968delta_repr(PyDateTime_Delta *self)
1969{
1970 if (GET_TD_MICROSECONDS(self) != 0)
Walter Dörwald1ab83302007-05-18 17:15:44 +00001971 return PyUnicode_FromFormat("%s(%d, %d, %d)",
Walter Dörwald7569dfe2007-05-19 21:49:49 +00001972 self->ob_type->tp_name,
1973 GET_TD_DAYS(self),
1974 GET_TD_SECONDS(self),
1975 GET_TD_MICROSECONDS(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00001976 if (GET_TD_SECONDS(self) != 0)
Walter Dörwald1ab83302007-05-18 17:15:44 +00001977 return PyUnicode_FromFormat("%s(%d, %d)",
Walter Dörwald7569dfe2007-05-19 21:49:49 +00001978 self->ob_type->tp_name,
1979 GET_TD_DAYS(self),
1980 GET_TD_SECONDS(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00001981
Walter Dörwald1ab83302007-05-18 17:15:44 +00001982 return PyUnicode_FromFormat("%s(%d)",
Walter Dörwald7569dfe2007-05-19 21:49:49 +00001983 self->ob_type->tp_name,
1984 GET_TD_DAYS(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00001985}
1986
1987static PyObject *
1988delta_str(PyDateTime_Delta *self)
1989{
Tim Peters2a799bf2002-12-16 20:18:38 +00001990 int us = GET_TD_MICROSECONDS(self);
Walter Dörwaldbaf853c2007-05-31 18:42:47 +00001991 int seconds = GET_TD_SECONDS(self);
1992 int minutes = divmod(seconds, 60, &seconds);
1993 int hours = divmod(minutes, 60, &minutes);
1994 int days = GET_TD_DAYS(self);
Tim Peters2a799bf2002-12-16 20:18:38 +00001995
1996 if (days) {
Walter Dörwaldbaf853c2007-05-31 18:42:47 +00001997 if (us)
1998 return PyUnicode_FromFormat("%d day%s, %d:%02d:%02d.%06d",
1999 days, (days == 1 || days == -1) ? "" : "s",
2000 hours, minutes, seconds, us);
2001 else
2002 return PyUnicode_FromFormat("%d day%s, %d:%02d:%02d",
2003 days, (days == 1 || days == -1) ? "" : "s",
2004 hours, minutes, seconds);
2005 } else {
2006 if (us)
2007 return PyUnicode_FromFormat("%d:%02d:%02d.%06d",
2008 hours, minutes, seconds, us);
2009 else
2010 return PyUnicode_FromFormat("%d:%02d:%02d",
2011 hours, minutes, seconds);
Tim Peters2a799bf2002-12-16 20:18:38 +00002012 }
2013
Tim Peters2a799bf2002-12-16 20:18:38 +00002014}
2015
Tim Peters371935f2003-02-01 01:52:50 +00002016/* Pickle support, a simple use of __reduce__. */
2017
Tim Petersb57f8f02003-02-01 02:54:15 +00002018/* __getstate__ isn't exposed */
Tim Peters2a799bf2002-12-16 20:18:38 +00002019static PyObject *
2020delta_getstate(PyDateTime_Delta *self)
2021{
2022 return Py_BuildValue("iii", GET_TD_DAYS(self),
2023 GET_TD_SECONDS(self),
2024 GET_TD_MICROSECONDS(self));
2025}
2026
Tim Peters2a799bf2002-12-16 20:18:38 +00002027static PyObject *
2028delta_reduce(PyDateTime_Delta* self)
2029{
Tim Peters8a60c222003-02-01 01:47:29 +00002030 return Py_BuildValue("ON", self->ob_type, delta_getstate(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00002031}
2032
2033#define OFFSET(field) offsetof(PyDateTime_Delta, field)
2034
2035static PyMemberDef delta_members[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00002036
Neal Norwitzdfb80862002-12-19 02:30:56 +00002037 {"days", T_INT, OFFSET(days), READONLY,
Tim Peters2a799bf2002-12-16 20:18:38 +00002038 PyDoc_STR("Number of days.")},
2039
Neal Norwitzdfb80862002-12-19 02:30:56 +00002040 {"seconds", T_INT, OFFSET(seconds), READONLY,
Tim Peters2a799bf2002-12-16 20:18:38 +00002041 PyDoc_STR("Number of seconds (>= 0 and less than 1 day).")},
2042
Neal Norwitzdfb80862002-12-19 02:30:56 +00002043 {"microseconds", T_INT, OFFSET(microseconds), READONLY,
Tim Peters2a799bf2002-12-16 20:18:38 +00002044 PyDoc_STR("Number of microseconds (>= 0 and less than 1 second).")},
2045 {NULL}
2046};
2047
2048static PyMethodDef delta_methods[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00002049 {"__reduce__", (PyCFunction)delta_reduce, METH_NOARGS,
2050 PyDoc_STR("__reduce__() -> (cls, state)")},
2051
Tim Peters2a799bf2002-12-16 20:18:38 +00002052 {NULL, NULL},
2053};
2054
2055static char delta_doc[] =
2056PyDoc_STR("Difference between two datetime values.");
2057
2058static PyNumberMethods delta_as_number = {
2059 delta_add, /* nb_add */
2060 delta_subtract, /* nb_subtract */
2061 delta_multiply, /* nb_multiply */
Tim Peters2a799bf2002-12-16 20:18:38 +00002062 0, /* nb_remainder */
2063 0, /* nb_divmod */
2064 0, /* nb_power */
2065 (unaryfunc)delta_negative, /* nb_negative */
2066 (unaryfunc)delta_positive, /* nb_positive */
2067 (unaryfunc)delta_abs, /* nb_absolute */
Jack Diederich4dafcc42006-11-28 19:15:13 +00002068 (inquiry)delta_bool, /* nb_bool */
Tim Peters2a799bf2002-12-16 20:18:38 +00002069 0, /*nb_invert*/
2070 0, /*nb_lshift*/
2071 0, /*nb_rshift*/
2072 0, /*nb_and*/
2073 0, /*nb_xor*/
2074 0, /*nb_or*/
2075 0, /*nb_coerce*/
2076 0, /*nb_int*/
2077 0, /*nb_long*/
2078 0, /*nb_float*/
2079 0, /*nb_oct*/
2080 0, /*nb_hex*/
2081 0, /*nb_inplace_add*/
2082 0, /*nb_inplace_subtract*/
2083 0, /*nb_inplace_multiply*/
Tim Peters2a799bf2002-12-16 20:18:38 +00002084 0, /*nb_inplace_remainder*/
2085 0, /*nb_inplace_power*/
2086 0, /*nb_inplace_lshift*/
2087 0, /*nb_inplace_rshift*/
2088 0, /*nb_inplace_and*/
2089 0, /*nb_inplace_xor*/
2090 0, /*nb_inplace_or*/
2091 delta_divide, /* nb_floor_divide */
2092 0, /* nb_true_divide */
2093 0, /* nb_inplace_floor_divide */
2094 0, /* nb_inplace_true_divide */
2095};
2096
2097static PyTypeObject PyDateTime_DeltaType = {
2098 PyObject_HEAD_INIT(NULL)
2099 0, /* ob_size */
2100 "datetime.timedelta", /* tp_name */
2101 sizeof(PyDateTime_Delta), /* tp_basicsize */
2102 0, /* tp_itemsize */
2103 0, /* tp_dealloc */
2104 0, /* tp_print */
2105 0, /* tp_getattr */
2106 0, /* tp_setattr */
2107 0, /* tp_compare */
2108 (reprfunc)delta_repr, /* tp_repr */
2109 &delta_as_number, /* tp_as_number */
2110 0, /* tp_as_sequence */
2111 0, /* tp_as_mapping */
2112 (hashfunc)delta_hash, /* tp_hash */
2113 0, /* tp_call */
2114 (reprfunc)delta_str, /* tp_str */
2115 PyObject_GenericGetAttr, /* tp_getattro */
2116 0, /* tp_setattro */
2117 0, /* tp_as_buffer */
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00002118 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
Tim Peters2a799bf2002-12-16 20:18:38 +00002119 delta_doc, /* tp_doc */
2120 0, /* tp_traverse */
2121 0, /* tp_clear */
Guido van Rossum19960592006-08-24 17:29:38 +00002122 delta_richcompare, /* tp_richcompare */
Tim Peters2a799bf2002-12-16 20:18:38 +00002123 0, /* tp_weaklistoffset */
2124 0, /* tp_iter */
2125 0, /* tp_iternext */
2126 delta_methods, /* tp_methods */
2127 delta_members, /* tp_members */
2128 0, /* tp_getset */
2129 0, /* tp_base */
2130 0, /* tp_dict */
2131 0, /* tp_descr_get */
2132 0, /* tp_descr_set */
2133 0, /* tp_dictoffset */
2134 0, /* tp_init */
2135 0, /* tp_alloc */
2136 delta_new, /* tp_new */
Tim Peters4c530132003-05-16 22:44:06 +00002137 0, /* tp_free */
Tim Peters2a799bf2002-12-16 20:18:38 +00002138};
2139
2140/*
2141 * PyDateTime_Date implementation.
2142 */
2143
2144/* Accessor properties. */
2145
2146static PyObject *
2147date_year(PyDateTime_Date *self, void *unused)
2148{
2149 return PyInt_FromLong(GET_YEAR(self));
2150}
2151
2152static PyObject *
2153date_month(PyDateTime_Date *self, void *unused)
2154{
2155 return PyInt_FromLong(GET_MONTH(self));
2156}
2157
2158static PyObject *
2159date_day(PyDateTime_Date *self, void *unused)
2160{
2161 return PyInt_FromLong(GET_DAY(self));
2162}
2163
2164static PyGetSetDef date_getset[] = {
2165 {"year", (getter)date_year},
2166 {"month", (getter)date_month},
2167 {"day", (getter)date_day},
2168 {NULL}
2169};
2170
2171/* Constructors. */
2172
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00002173static char *date_kws[] = {"year", "month", "day", NULL};
Tim Peters12bf3392002-12-24 05:41:27 +00002174
Tim Peters2a799bf2002-12-16 20:18:38 +00002175static PyObject *
2176date_new(PyTypeObject *type, PyObject *args, PyObject *kw)
2177{
2178 PyObject *self = NULL;
Tim Peters70533e22003-02-01 04:40:04 +00002179 PyObject *state;
Tim Peters2a799bf2002-12-16 20:18:38 +00002180 int year;
2181 int month;
2182 int day;
2183
Guido van Rossum177e41a2003-01-30 22:06:23 +00002184 /* Check for invocation from pickle with __getstate__ state */
2185 if (PyTuple_GET_SIZE(args) == 1 &&
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002186 PyBytes_Check(state = PyTuple_GET_ITEM(args, 0)) &&
2187 PyBytes_GET_SIZE(state) == _PyDateTime_DATE_DATASIZE &&
2188 MONTH_IS_SANE(PyBytes_AS_STRING(state)[2]))
Guido van Rossum177e41a2003-01-30 22:06:23 +00002189 {
Tim Peters70533e22003-02-01 04:40:04 +00002190 PyDateTime_Date *me;
2191
Tim Peters604c0132004-06-07 23:04:33 +00002192 me = (PyDateTime_Date *) (type->tp_alloc(type, 0));
Tim Peters70533e22003-02-01 04:40:04 +00002193 if (me != NULL) {
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002194 char *pdata = PyBytes_AS_STRING(state);
Tim Peters70533e22003-02-01 04:40:04 +00002195 memcpy(me->data, pdata, _PyDateTime_DATE_DATASIZE);
2196 me->hashcode = -1;
Guido van Rossum177e41a2003-01-30 22:06:23 +00002197 }
Tim Peters70533e22003-02-01 04:40:04 +00002198 return (PyObject *)me;
Guido van Rossum177e41a2003-01-30 22:06:23 +00002199 }
2200
Tim Peters12bf3392002-12-24 05:41:27 +00002201 if (PyArg_ParseTupleAndKeywords(args, kw, "iii", date_kws,
Tim Peters2a799bf2002-12-16 20:18:38 +00002202 &year, &month, &day)) {
2203 if (check_date_args(year, month, day) < 0)
2204 return NULL;
Guido van Rossum8b7a9a32003-04-14 22:01:58 +00002205 self = new_date_ex(year, month, day, type);
Tim Peters2a799bf2002-12-16 20:18:38 +00002206 }
2207 return self;
2208}
2209
2210/* Return new date from localtime(t). */
2211static PyObject *
Tim Peters1b6f7a92004-06-20 02:50:16 +00002212date_local_from_time_t(PyObject *cls, double ts)
Tim Peters2a799bf2002-12-16 20:18:38 +00002213{
2214 struct tm *tm;
Tim Peters1b6f7a92004-06-20 02:50:16 +00002215 time_t t;
Tim Peters2a799bf2002-12-16 20:18:38 +00002216 PyObject *result = NULL;
2217
Tim Peters1b6f7a92004-06-20 02:50:16 +00002218 t = _PyTime_DoubleToTimet(ts);
2219 if (t == (time_t)-1 && PyErr_Occurred())
2220 return NULL;
Tim Peters2a799bf2002-12-16 20:18:38 +00002221 tm = localtime(&t);
2222 if (tm)
2223 result = PyObject_CallFunction(cls, "iii",
2224 tm->tm_year + 1900,
2225 tm->tm_mon + 1,
2226 tm->tm_mday);
2227 else
2228 PyErr_SetString(PyExc_ValueError,
2229 "timestamp out of range for "
2230 "platform localtime() function");
2231 return result;
2232}
2233
2234/* Return new date from current time.
2235 * We say this is equivalent to fromtimestamp(time.time()), and the
2236 * only way to be sure of that is to *call* time.time(). That's not
2237 * generally the same as calling C's time.
2238 */
2239static PyObject *
2240date_today(PyObject *cls, PyObject *dummy)
2241{
2242 PyObject *time;
2243 PyObject *result;
2244
2245 time = time_time();
2246 if (time == NULL)
2247 return NULL;
2248
2249 /* Note well: today() is a class method, so this may not call
2250 * date.fromtimestamp. For example, it may call
2251 * datetime.fromtimestamp. That's why we need all the accuracy
2252 * time.time() delivers; if someone were gonzo about optimization,
2253 * date.today() could get away with plain C time().
2254 */
2255 result = PyObject_CallMethod(cls, "fromtimestamp", "O", time);
2256 Py_DECREF(time);
2257 return result;
2258}
2259
2260/* Return new date from given timestamp (Python timestamp -- a double). */
2261static PyObject *
2262date_fromtimestamp(PyObject *cls, PyObject *args)
2263{
2264 double timestamp;
2265 PyObject *result = NULL;
2266
2267 if (PyArg_ParseTuple(args, "d:fromtimestamp", &timestamp))
Tim Peters1b6f7a92004-06-20 02:50:16 +00002268 result = date_local_from_time_t(cls, timestamp);
Tim Peters2a799bf2002-12-16 20:18:38 +00002269 return result;
2270}
2271
2272/* Return new date from proleptic Gregorian ordinal. Raises ValueError if
2273 * the ordinal is out of range.
2274 */
2275static PyObject *
2276date_fromordinal(PyObject *cls, PyObject *args)
2277{
2278 PyObject *result = NULL;
2279 int ordinal;
2280
2281 if (PyArg_ParseTuple(args, "i:fromordinal", &ordinal)) {
2282 int year;
2283 int month;
2284 int day;
2285
2286 if (ordinal < 1)
2287 PyErr_SetString(PyExc_ValueError, "ordinal must be "
2288 ">= 1");
2289 else {
2290 ord_to_ymd(ordinal, &year, &month, &day);
2291 result = PyObject_CallFunction(cls, "iii",
2292 year, month, day);
2293 }
2294 }
2295 return result;
2296}
2297
2298/*
2299 * Date arithmetic.
2300 */
2301
2302/* date + timedelta -> date. If arg negate is true, subtract the timedelta
2303 * instead.
2304 */
2305static PyObject *
2306add_date_timedelta(PyDateTime_Date *date, PyDateTime_Delta *delta, int negate)
2307{
2308 PyObject *result = NULL;
2309 int year = GET_YEAR(date);
2310 int month = GET_MONTH(date);
2311 int deltadays = GET_TD_DAYS(delta);
2312 /* C-level overflow is impossible because |deltadays| < 1e9. */
2313 int day = GET_DAY(date) + (negate ? -deltadays : deltadays);
2314
2315 if (normalize_date(&year, &month, &day) >= 0)
2316 result = new_date(year, month, day);
2317 return result;
2318}
2319
2320static PyObject *
2321date_add(PyObject *left, PyObject *right)
2322{
2323 if (PyDateTime_Check(left) || PyDateTime_Check(right)) {
2324 Py_INCREF(Py_NotImplemented);
2325 return Py_NotImplemented;
2326 }
Tim Petersaa7d8492003-02-08 03:28:59 +00002327 if (PyDate_Check(left)) {
Tim Peters2a799bf2002-12-16 20:18:38 +00002328 /* date + ??? */
2329 if (PyDelta_Check(right))
2330 /* date + delta */
2331 return add_date_timedelta((PyDateTime_Date *) left,
2332 (PyDateTime_Delta *) right,
2333 0);
2334 }
2335 else {
2336 /* ??? + date
2337 * 'right' must be one of us, or we wouldn't have been called
2338 */
2339 if (PyDelta_Check(left))
2340 /* delta + date */
2341 return add_date_timedelta((PyDateTime_Date *) right,
2342 (PyDateTime_Delta *) left,
2343 0);
2344 }
2345 Py_INCREF(Py_NotImplemented);
2346 return Py_NotImplemented;
2347}
2348
2349static PyObject *
2350date_subtract(PyObject *left, PyObject *right)
2351{
2352 if (PyDateTime_Check(left) || PyDateTime_Check(right)) {
2353 Py_INCREF(Py_NotImplemented);
2354 return Py_NotImplemented;
2355 }
Tim Petersaa7d8492003-02-08 03:28:59 +00002356 if (PyDate_Check(left)) {
2357 if (PyDate_Check(right)) {
Tim Peters2a799bf2002-12-16 20:18:38 +00002358 /* date - date */
2359 int left_ord = ymd_to_ord(GET_YEAR(left),
2360 GET_MONTH(left),
2361 GET_DAY(left));
2362 int right_ord = ymd_to_ord(GET_YEAR(right),
2363 GET_MONTH(right),
2364 GET_DAY(right));
2365 return new_delta(left_ord - right_ord, 0, 0, 0);
2366 }
2367 if (PyDelta_Check(right)) {
2368 /* date - delta */
2369 return add_date_timedelta((PyDateTime_Date *) left,
2370 (PyDateTime_Delta *) right,
2371 1);
2372 }
2373 }
2374 Py_INCREF(Py_NotImplemented);
2375 return Py_NotImplemented;
2376}
2377
2378
2379/* Various ways to turn a date into a string. */
2380
2381static PyObject *
2382date_repr(PyDateTime_Date *self)
2383{
Walter Dörwald7569dfe2007-05-19 21:49:49 +00002384 return PyUnicode_FromFormat("%s(%d, %d, %d)",
2385 self->ob_type->tp_name,
2386 GET_YEAR(self), GET_MONTH(self), GET_DAY(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00002387}
2388
2389static PyObject *
2390date_isoformat(PyDateTime_Date *self)
2391{
Walter Dörwaldbafa1372007-05-31 17:50:48 +00002392 return PyUnicode_FromFormat("%04d-%02d-%02d",
2393 GET_YEAR(self), GET_MONTH(self), GET_DAY(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00002394}
2395
Tim Peterse2df5ff2003-05-02 18:39:55 +00002396/* str() calls the appropriate isoformat() method. */
Tim Peters2a799bf2002-12-16 20:18:38 +00002397static PyObject *
2398date_str(PyDateTime_Date *self)
2399{
2400 return PyObject_CallMethod((PyObject *)self, "isoformat", "()");
2401}
2402
2403
2404static PyObject *
2405date_ctime(PyDateTime_Date *self)
2406{
2407 return format_ctime(self, 0, 0, 0);
2408}
2409
2410static PyObject *
2411date_strftime(PyDateTime_Date *self, PyObject *args, PyObject *kw)
2412{
2413 /* This method can be inherited, and needs to call the
2414 * timetuple() method appropriate to self's class.
2415 */
2416 PyObject *result;
2417 PyObject *format;
2418 PyObject *tuple;
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00002419 static char *keywords[] = {"format", NULL};
Tim Peters2a799bf2002-12-16 20:18:38 +00002420
Guido van Rossumbce56a62007-05-10 18:04:33 +00002421 if (! PyArg_ParseTupleAndKeywords(args, kw, "S:strftime", keywords,
2422 &format))
Tim Peters2a799bf2002-12-16 20:18:38 +00002423 return NULL;
2424
2425 tuple = PyObject_CallMethod((PyObject *)self, "timetuple", "()");
2426 if (tuple == NULL)
2427 return NULL;
Tim Petersbad8ff02002-12-30 20:52:32 +00002428 result = wrap_strftime((PyObject *)self, format, tuple,
2429 (PyObject *)self);
Tim Peters2a799bf2002-12-16 20:18:38 +00002430 Py_DECREF(tuple);
2431 return result;
2432}
2433
2434/* ISO methods. */
2435
2436static PyObject *
2437date_isoweekday(PyDateTime_Date *self)
2438{
2439 int dow = weekday(GET_YEAR(self), GET_MONTH(self), GET_DAY(self));
2440
2441 return PyInt_FromLong(dow + 1);
2442}
2443
2444static PyObject *
2445date_isocalendar(PyDateTime_Date *self)
2446{
2447 int year = GET_YEAR(self);
2448 int week1_monday = iso_week1_monday(year);
2449 int today = ymd_to_ord(year, GET_MONTH(self), GET_DAY(self));
2450 int week;
2451 int day;
2452
2453 week = divmod(today - week1_monday, 7, &day);
2454 if (week < 0) {
2455 --year;
2456 week1_monday = iso_week1_monday(year);
2457 week = divmod(today - week1_monday, 7, &day);
2458 }
2459 else if (week >= 52 && today >= iso_week1_monday(year + 1)) {
2460 ++year;
2461 week = 0;
2462 }
2463 return Py_BuildValue("iii", year, week + 1, day + 1);
2464}
2465
2466/* Miscellaneous methods. */
2467
Tim Peters2a799bf2002-12-16 20:18:38 +00002468static PyObject *
Guido van Rossum19960592006-08-24 17:29:38 +00002469date_richcompare(PyObject *self, PyObject *other, int op)
Tim Peters2a799bf2002-12-16 20:18:38 +00002470{
Guido van Rossum19960592006-08-24 17:29:38 +00002471 if (PyDate_Check(other)) {
2472 int diff = memcmp(((PyDateTime_Date *)self)->data,
2473 ((PyDateTime_Date *)other)->data,
2474 _PyDateTime_DATE_DATASIZE);
2475 return diff_to_bool(diff, op);
2476 }
2477 else {
Tim Peters07534a62003-02-07 22:50:28 +00002478 Py_INCREF(Py_NotImplemented);
2479 return Py_NotImplemented;
Tim Peters2a799bf2002-12-16 20:18:38 +00002480 }
Tim Peters2a799bf2002-12-16 20:18:38 +00002481}
2482
2483static PyObject *
2484date_timetuple(PyDateTime_Date *self)
2485{
2486 return build_struct_time(GET_YEAR(self),
2487 GET_MONTH(self),
2488 GET_DAY(self),
2489 0, 0, 0, -1);
2490}
2491
Tim Peters12bf3392002-12-24 05:41:27 +00002492static PyObject *
2493date_replace(PyDateTime_Date *self, PyObject *args, PyObject *kw)
2494{
2495 PyObject *clone;
2496 PyObject *tuple;
2497 int year = GET_YEAR(self);
2498 int month = GET_MONTH(self);
2499 int day = GET_DAY(self);
2500
2501 if (! PyArg_ParseTupleAndKeywords(args, kw, "|iii:replace", date_kws,
2502 &year, &month, &day))
2503 return NULL;
2504 tuple = Py_BuildValue("iii", year, month, day);
2505 if (tuple == NULL)
2506 return NULL;
2507 clone = date_new(self->ob_type, tuple, NULL);
2508 Py_DECREF(tuple);
2509 return clone;
2510}
2511
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002512static PyObject *date_getstate(PyDateTime_Date *self, int hashable);
Tim Peters2a799bf2002-12-16 20:18:38 +00002513
2514static long
2515date_hash(PyDateTime_Date *self)
2516{
2517 if (self->hashcode == -1) {
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002518 PyObject *temp = date_getstate(self, 1);
Tim Peters2a799bf2002-12-16 20:18:38 +00002519 if (temp != NULL) {
2520 self->hashcode = PyObject_Hash(temp);
2521 Py_DECREF(temp);
2522 }
2523 }
2524 return self->hashcode;
2525}
2526
2527static PyObject *
2528date_toordinal(PyDateTime_Date *self)
2529{
2530 return PyInt_FromLong(ymd_to_ord(GET_YEAR(self), GET_MONTH(self),
2531 GET_DAY(self)));
2532}
2533
2534static PyObject *
2535date_weekday(PyDateTime_Date *self)
2536{
2537 int dow = weekday(GET_YEAR(self), GET_MONTH(self), GET_DAY(self));
2538
2539 return PyInt_FromLong(dow);
2540}
2541
Tim Peters371935f2003-02-01 01:52:50 +00002542/* Pickle support, a simple use of __reduce__. */
Tim Peters2a799bf2002-12-16 20:18:38 +00002543
Tim Petersb57f8f02003-02-01 02:54:15 +00002544/* __getstate__ isn't exposed */
Tim Peters2a799bf2002-12-16 20:18:38 +00002545static PyObject *
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002546date_getstate(PyDateTime_Date *self, int hashable)
Tim Peters2a799bf2002-12-16 20:18:38 +00002547{
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002548 PyObject* field;
2549 if (hashable)
2550 field = PyString_FromStringAndSize(
2551 (char*)self->data, _PyDateTime_DATE_DATASIZE);
2552 else
2553 field = PyBytes_FromStringAndSize(
2554 (char*)self->data, _PyDateTime_DATE_DATASIZE);
2555 return Py_BuildValue("(N)", field);
Tim Peters2a799bf2002-12-16 20:18:38 +00002556}
2557
2558static PyObject *
Guido van Rossum177e41a2003-01-30 22:06:23 +00002559date_reduce(PyDateTime_Date *self, PyObject *arg)
Tim Peters2a799bf2002-12-16 20:18:38 +00002560{
Martin v. Löwis10a60b32007-07-18 02:28:27 +00002561 return Py_BuildValue("(ON)", self->ob_type, date_getstate(self, 0));
Tim Peters2a799bf2002-12-16 20:18:38 +00002562}
2563
2564static PyMethodDef date_methods[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00002565
Tim Peters2a799bf2002-12-16 20:18:38 +00002566 /* Class methods: */
Guido van Rossum177e41a2003-01-30 22:06:23 +00002567
Tim Peters2a799bf2002-12-16 20:18:38 +00002568 {"fromtimestamp", (PyCFunction)date_fromtimestamp, METH_VARARGS |
2569 METH_CLASS,
2570 PyDoc_STR("timestamp -> local date from a POSIX timestamp (like "
2571 "time.time()).")},
2572
2573 {"fromordinal", (PyCFunction)date_fromordinal, METH_VARARGS |
2574 METH_CLASS,
2575 PyDoc_STR("int -> date corresponding to a proleptic Gregorian "
2576 "ordinal.")},
2577
2578 {"today", (PyCFunction)date_today, METH_NOARGS | METH_CLASS,
2579 PyDoc_STR("Current date or datetime: same as "
2580 "self.__class__.fromtimestamp(time.time()).")},
2581
2582 /* Instance methods: */
2583
2584 {"ctime", (PyCFunction)date_ctime, METH_NOARGS,
2585 PyDoc_STR("Return ctime() style string.")},
2586
Guido van Rossumd59da4b2007-05-22 18:11:13 +00002587 {"strftime", (PyCFunction)date_strftime, METH_VARARGS | METH_KEYWORDS,
Tim Peters2a799bf2002-12-16 20:18:38 +00002588 PyDoc_STR("format -> strftime() style string.")},
2589
2590 {"timetuple", (PyCFunction)date_timetuple, METH_NOARGS,
2591 PyDoc_STR("Return time tuple, compatible with time.localtime().")},
2592
2593 {"isocalendar", (PyCFunction)date_isocalendar, METH_NOARGS,
2594 PyDoc_STR("Return a 3-tuple containing ISO year, week number, and "
2595 "weekday.")},
2596
2597 {"isoformat", (PyCFunction)date_isoformat, METH_NOARGS,
2598 PyDoc_STR("Return string in ISO 8601 format, YYYY-MM-DD.")},
2599
2600 {"isoweekday", (PyCFunction)date_isoweekday, METH_NOARGS,
2601 PyDoc_STR("Return the day of the week represented by the date.\n"
2602 "Monday == 1 ... Sunday == 7")},
2603
2604 {"toordinal", (PyCFunction)date_toordinal, METH_NOARGS,
2605 PyDoc_STR("Return proleptic Gregorian ordinal. January 1 of year "
2606 "1 is day 1.")},
2607
2608 {"weekday", (PyCFunction)date_weekday, METH_NOARGS,
2609 PyDoc_STR("Return the day of the week represented by the date.\n"
2610 "Monday == 0 ... Sunday == 6")},
2611
Guido van Rossumd59da4b2007-05-22 18:11:13 +00002612 {"replace", (PyCFunction)date_replace, METH_VARARGS | METH_KEYWORDS,
Tim Peters12bf3392002-12-24 05:41:27 +00002613 PyDoc_STR("Return date with new specified fields.")},
2614
Guido van Rossum177e41a2003-01-30 22:06:23 +00002615 {"__reduce__", (PyCFunction)date_reduce, METH_NOARGS,
2616 PyDoc_STR("__reduce__() -> (cls, state)")},
2617
Tim Peters2a799bf2002-12-16 20:18:38 +00002618 {NULL, NULL}
2619};
2620
2621static char date_doc[] =
Raymond Hettinger3a4231d2004-12-19 20:13:24 +00002622PyDoc_STR("date(year, month, day) --> date object");
Tim Peters2a799bf2002-12-16 20:18:38 +00002623
2624static PyNumberMethods date_as_number = {
2625 date_add, /* nb_add */
2626 date_subtract, /* nb_subtract */
2627 0, /* nb_multiply */
Tim Peters2a799bf2002-12-16 20:18:38 +00002628 0, /* nb_remainder */
2629 0, /* nb_divmod */
2630 0, /* nb_power */
2631 0, /* nb_negative */
2632 0, /* nb_positive */
2633 0, /* nb_absolute */
Jack Diederich4dafcc42006-11-28 19:15:13 +00002634 0, /* nb_bool */
Tim Peters2a799bf2002-12-16 20:18:38 +00002635};
2636
2637static PyTypeObject PyDateTime_DateType = {
2638 PyObject_HEAD_INIT(NULL)
2639 0, /* ob_size */
2640 "datetime.date", /* tp_name */
2641 sizeof(PyDateTime_Date), /* tp_basicsize */
2642 0, /* tp_itemsize */
Guido van Rossum8b7a9a32003-04-14 22:01:58 +00002643 0, /* tp_dealloc */
Tim Peters2a799bf2002-12-16 20:18:38 +00002644 0, /* tp_print */
2645 0, /* tp_getattr */
2646 0, /* tp_setattr */
2647 0, /* tp_compare */
2648 (reprfunc)date_repr, /* tp_repr */
2649 &date_as_number, /* tp_as_number */
2650 0, /* tp_as_sequence */
2651 0, /* tp_as_mapping */
2652 (hashfunc)date_hash, /* tp_hash */
2653 0, /* tp_call */
2654 (reprfunc)date_str, /* tp_str */
2655 PyObject_GenericGetAttr, /* tp_getattro */
2656 0, /* tp_setattro */
2657 0, /* tp_as_buffer */
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00002658 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
Tim Peters2a799bf2002-12-16 20:18:38 +00002659 date_doc, /* tp_doc */
2660 0, /* tp_traverse */
2661 0, /* tp_clear */
Guido van Rossum19960592006-08-24 17:29:38 +00002662 date_richcompare, /* tp_richcompare */
Tim Peters2a799bf2002-12-16 20:18:38 +00002663 0, /* tp_weaklistoffset */
2664 0, /* tp_iter */
2665 0, /* tp_iternext */
2666 date_methods, /* tp_methods */
2667 0, /* tp_members */
2668 date_getset, /* tp_getset */
2669 0, /* tp_base */
2670 0, /* tp_dict */
2671 0, /* tp_descr_get */
2672 0, /* tp_descr_set */
2673 0, /* tp_dictoffset */
2674 0, /* tp_init */
2675 0, /* tp_alloc */
2676 date_new, /* tp_new */
Tim Peters4c530132003-05-16 22:44:06 +00002677 0, /* tp_free */
Tim Peters2a799bf2002-12-16 20:18:38 +00002678};
2679
2680/*
Tim Peters2a799bf2002-12-16 20:18:38 +00002681 * PyDateTime_TZInfo implementation.
2682 */
2683
2684/* This is a pure abstract base class, so doesn't do anything beyond
2685 * raising NotImplemented exceptions. Real tzinfo classes need
2686 * to derive from this. This is mostly for clarity, and for efficiency in
Tim Petersa9bc1682003-01-11 03:39:11 +00002687 * datetime and time constructors (their tzinfo arguments need to
Tim Peters2a799bf2002-12-16 20:18:38 +00002688 * be subclasses of this tzinfo class, which is easy and quick to check).
2689 *
2690 * Note: For reasons having to do with pickling of subclasses, we have
2691 * to allow tzinfo objects to be instantiated. This wasn't an issue
2692 * in the Python implementation (__init__() could raise NotImplementedError
2693 * there without ill effect), but doing so in the C implementation hit a
2694 * brick wall.
2695 */
2696
2697static PyObject *
2698tzinfo_nogo(const char* methodname)
2699{
2700 PyErr_Format(PyExc_NotImplementedError,
2701 "a tzinfo subclass must implement %s()",
2702 methodname);
2703 return NULL;
2704}
2705
2706/* Methods. A subclass must implement these. */
2707
Tim Peters52dcce22003-01-23 16:36:11 +00002708static PyObject *
Tim Peters2a799bf2002-12-16 20:18:38 +00002709tzinfo_tzname(PyDateTime_TZInfo *self, PyObject *dt)
2710{
2711 return tzinfo_nogo("tzname");
2712}
2713
Tim Peters52dcce22003-01-23 16:36:11 +00002714static PyObject *
Tim Peters2a799bf2002-12-16 20:18:38 +00002715tzinfo_utcoffset(PyDateTime_TZInfo *self, PyObject *dt)
2716{
2717 return tzinfo_nogo("utcoffset");
2718}
2719
Tim Peters52dcce22003-01-23 16:36:11 +00002720static PyObject *
Tim Peters2a799bf2002-12-16 20:18:38 +00002721tzinfo_dst(PyDateTime_TZInfo *self, PyObject *dt)
2722{
2723 return tzinfo_nogo("dst");
2724}
2725
Tim Peters52dcce22003-01-23 16:36:11 +00002726static PyObject *
2727tzinfo_fromutc(PyDateTime_TZInfo *self, PyDateTime_DateTime *dt)
2728{
2729 int y, m, d, hh, mm, ss, us;
2730
2731 PyObject *result;
2732 int off, dst;
2733 int none;
2734 int delta;
2735
2736 if (! PyDateTime_Check(dt)) {
2737 PyErr_SetString(PyExc_TypeError,
2738 "fromutc: argument must be a datetime");
2739 return NULL;
2740 }
2741 if (! HASTZINFO(dt) || dt->tzinfo != (PyObject *)self) {
2742 PyErr_SetString(PyExc_ValueError, "fromutc: dt.tzinfo "
2743 "is not self");
2744 return NULL;
2745 }
2746
2747 off = call_utcoffset(dt->tzinfo, (PyObject *)dt, &none);
2748 if (off == -1 && PyErr_Occurred())
2749 return NULL;
2750 if (none) {
2751 PyErr_SetString(PyExc_ValueError, "fromutc: non-None "
2752 "utcoffset() result required");
2753 return NULL;
2754 }
2755
2756 dst = call_dst(dt->tzinfo, (PyObject *)dt, &none);
2757 if (dst == -1 && PyErr_Occurred())
2758 return NULL;
2759 if (none) {
2760 PyErr_SetString(PyExc_ValueError, "fromutc: non-None "
2761 "dst() result required");
2762 return NULL;
2763 }
2764
2765 y = GET_YEAR(dt);
2766 m = GET_MONTH(dt);
2767 d = GET_DAY(dt);
2768 hh = DATE_GET_HOUR(dt);
2769 mm = DATE_GET_MINUTE(dt);
2770 ss = DATE_GET_SECOND(dt);
2771 us = DATE_GET_MICROSECOND(dt);
2772
2773 delta = off - dst;
2774 mm += delta;
2775 if ((mm < 0 || mm >= 60) &&
2776 normalize_datetime(&y, &m, &d, &hh, &mm, &ss, &us) < 0)
Tim Petersb1049e82003-01-23 17:20:36 +00002777 return NULL;
Tim Peters52dcce22003-01-23 16:36:11 +00002778 result = new_datetime(y, m, d, hh, mm, ss, us, dt->tzinfo);
2779 if (result == NULL)
2780 return result;
2781
2782 dst = call_dst(dt->tzinfo, result, &none);
2783 if (dst == -1 && PyErr_Occurred())
2784 goto Fail;
2785 if (none)
2786 goto Inconsistent;
2787 if (dst == 0)
2788 return result;
2789
2790 mm += dst;
2791 if ((mm < 0 || mm >= 60) &&
2792 normalize_datetime(&y, &m, &d, &hh, &mm, &ss, &us) < 0)
2793 goto Fail;
2794 Py_DECREF(result);
2795 result = new_datetime(y, m, d, hh, mm, ss, us, dt->tzinfo);
2796 return result;
2797
2798Inconsistent:
2799 PyErr_SetString(PyExc_ValueError, "fromutc: tz.dst() gave"
2800 "inconsistent results; cannot convert");
2801
2802 /* fall thru to failure */
2803Fail:
2804 Py_DECREF(result);
2805 return NULL;
2806}
2807
Tim Peters2a799bf2002-12-16 20:18:38 +00002808/*
2809 * Pickle support. This is solely so that tzinfo subclasses can use
Guido van Rossum177e41a2003-01-30 22:06:23 +00002810 * pickling -- tzinfo itself is supposed to be uninstantiable.
Tim Peters2a799bf2002-12-16 20:18:38 +00002811 */
2812
Guido van Rossum177e41a2003-01-30 22:06:23 +00002813static PyObject *
2814tzinfo_reduce(PyObject *self)
2815{
2816 PyObject *args, *state, *tmp;
2817 PyObject *getinitargs, *getstate;
Tim Peters2a799bf2002-12-16 20:18:38 +00002818
Guido van Rossum177e41a2003-01-30 22:06:23 +00002819 tmp = PyTuple_New(0);
2820 if (tmp == NULL)
2821 return NULL;
Tim Peters2a799bf2002-12-16 20:18:38 +00002822
Guido van Rossum177e41a2003-01-30 22:06:23 +00002823 getinitargs = PyObject_GetAttrString(self, "__getinitargs__");
2824 if (getinitargs != NULL) {
2825 args = PyObject_CallObject(getinitargs, tmp);
2826 Py_DECREF(getinitargs);
2827 if (args == NULL) {
2828 Py_DECREF(tmp);
2829 return NULL;
2830 }
2831 }
2832 else {
2833 PyErr_Clear();
2834 args = tmp;
2835 Py_INCREF(args);
2836 }
2837
2838 getstate = PyObject_GetAttrString(self, "__getstate__");
2839 if (getstate != NULL) {
2840 state = PyObject_CallObject(getstate, tmp);
2841 Py_DECREF(getstate);
2842 if (state == NULL) {
2843 Py_DECREF(args);
2844 Py_DECREF(tmp);
2845 return NULL;
2846 }
2847 }
2848 else {
2849 PyObject **dictptr;
2850 PyErr_Clear();
2851 state = Py_None;
2852 dictptr = _PyObject_GetDictPtr(self);
2853 if (dictptr && *dictptr && PyDict_Size(*dictptr))
2854 state = *dictptr;
2855 Py_INCREF(state);
2856 }
2857
2858 Py_DECREF(tmp);
2859
2860 if (state == Py_None) {
2861 Py_DECREF(state);
2862 return Py_BuildValue("(ON)", self->ob_type, args);
2863 }
2864 else
2865 return Py_BuildValue("(ONN)", self->ob_type, args, state);
2866}
Tim Peters2a799bf2002-12-16 20:18:38 +00002867
2868static PyMethodDef tzinfo_methods[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00002869
Tim Peters2a799bf2002-12-16 20:18:38 +00002870 {"tzname", (PyCFunction)tzinfo_tzname, METH_O,
2871 PyDoc_STR("datetime -> string name of time zone.")},
2872
2873 {"utcoffset", (PyCFunction)tzinfo_utcoffset, METH_O,
2874 PyDoc_STR("datetime -> minutes east of UTC (negative for "
2875 "west of UTC).")},
2876
2877 {"dst", (PyCFunction)tzinfo_dst, METH_O,
2878 PyDoc_STR("datetime -> DST offset in minutes east of UTC.")},
2879
Tim Peters52dcce22003-01-23 16:36:11 +00002880 {"fromutc", (PyCFunction)tzinfo_fromutc, METH_O,
2881 PyDoc_STR("datetime in UTC -> datetime in local time.")},
2882
Guido van Rossum177e41a2003-01-30 22:06:23 +00002883 {"__reduce__", (PyCFunction)tzinfo_reduce, METH_NOARGS,
2884 PyDoc_STR("-> (cls, state)")},
2885
Tim Peters2a799bf2002-12-16 20:18:38 +00002886 {NULL, NULL}
2887};
2888
2889static char tzinfo_doc[] =
2890PyDoc_STR("Abstract base class for time zone info objects.");
2891
Neal Norwitz227b5332006-03-22 09:28:35 +00002892static PyTypeObject PyDateTime_TZInfoType = {
Tim Peters2a799bf2002-12-16 20:18:38 +00002893 PyObject_HEAD_INIT(NULL)
2894 0, /* ob_size */
2895 "datetime.tzinfo", /* tp_name */
2896 sizeof(PyDateTime_TZInfo), /* tp_basicsize */
2897 0, /* tp_itemsize */
2898 0, /* tp_dealloc */
2899 0, /* tp_print */
2900 0, /* tp_getattr */
2901 0, /* tp_setattr */
2902 0, /* tp_compare */
2903 0, /* tp_repr */
2904 0, /* tp_as_number */
2905 0, /* tp_as_sequence */
2906 0, /* tp_as_mapping */
2907 0, /* tp_hash */
2908 0, /* tp_call */
2909 0, /* tp_str */
2910 PyObject_GenericGetAttr, /* tp_getattro */
2911 0, /* tp_setattro */
2912 0, /* tp_as_buffer */
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00002913 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
Tim Peters2a799bf2002-12-16 20:18:38 +00002914 tzinfo_doc, /* tp_doc */
2915 0, /* tp_traverse */
2916 0, /* tp_clear */
2917 0, /* tp_richcompare */
2918 0, /* tp_weaklistoffset */
2919 0, /* tp_iter */
2920 0, /* tp_iternext */
2921 tzinfo_methods, /* tp_methods */
2922 0, /* tp_members */
2923 0, /* tp_getset */
2924 0, /* tp_base */
2925 0, /* tp_dict */
2926 0, /* tp_descr_get */
2927 0, /* tp_descr_set */
2928 0, /* tp_dictoffset */
2929 0, /* tp_init */
2930 0, /* tp_alloc */
2931 PyType_GenericNew, /* tp_new */
2932 0, /* tp_free */
2933};
2934
2935/*
Tim Peters37f39822003-01-10 03:49:02 +00002936 * PyDateTime_Time implementation.
Tim Peters2a799bf2002-12-16 20:18:38 +00002937 */
2938
Tim Peters37f39822003-01-10 03:49:02 +00002939/* Accessor properties.
Tim Peters2a799bf2002-12-16 20:18:38 +00002940 */
2941
2942static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00002943time_hour(PyDateTime_Time *self, void *unused)
Tim Peters2a799bf2002-12-16 20:18:38 +00002944{
Tim Peters37f39822003-01-10 03:49:02 +00002945 return PyInt_FromLong(TIME_GET_HOUR(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00002946}
2947
Tim Peters37f39822003-01-10 03:49:02 +00002948static PyObject *
2949time_minute(PyDateTime_Time *self, void *unused)
2950{
2951 return PyInt_FromLong(TIME_GET_MINUTE(self));
2952}
2953
2954/* The name time_second conflicted with some platform header file. */
2955static PyObject *
2956py_time_second(PyDateTime_Time *self, void *unused)
2957{
2958 return PyInt_FromLong(TIME_GET_SECOND(self));
2959}
2960
2961static PyObject *
2962time_microsecond(PyDateTime_Time *self, void *unused)
2963{
2964 return PyInt_FromLong(TIME_GET_MICROSECOND(self));
2965}
2966
2967static PyObject *
2968time_tzinfo(PyDateTime_Time *self, void *unused)
2969{
Tim Petersa032d2e2003-01-11 00:15:54 +00002970 PyObject *result = HASTZINFO(self) ? self->tzinfo : Py_None;
Tim Peters37f39822003-01-10 03:49:02 +00002971 Py_INCREF(result);
2972 return result;
2973}
2974
2975static PyGetSetDef time_getset[] = {
2976 {"hour", (getter)time_hour},
2977 {"minute", (getter)time_minute},
2978 {"second", (getter)py_time_second},
2979 {"microsecond", (getter)time_microsecond},
2980 {"tzinfo", (getter)time_tzinfo},
Tim Peters2a799bf2002-12-16 20:18:38 +00002981 {NULL}
2982};
2983
2984/*
2985 * Constructors.
2986 */
2987
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00002988static char *time_kws[] = {"hour", "minute", "second", "microsecond",
Tim Peters37f39822003-01-10 03:49:02 +00002989 "tzinfo", NULL};
Tim Peters12bf3392002-12-24 05:41:27 +00002990
Tim Peters2a799bf2002-12-16 20:18:38 +00002991static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00002992time_new(PyTypeObject *type, PyObject *args, PyObject *kw)
Tim Peters2a799bf2002-12-16 20:18:38 +00002993{
2994 PyObject *self = NULL;
Tim Peters70533e22003-02-01 04:40:04 +00002995 PyObject *state;
Tim Peters2a799bf2002-12-16 20:18:38 +00002996 int hour = 0;
2997 int minute = 0;
2998 int second = 0;
2999 int usecond = 0;
3000 PyObject *tzinfo = Py_None;
3001
Guido van Rossum177e41a2003-01-30 22:06:23 +00003002 /* Check for invocation from pickle with __getstate__ state */
3003 if (PyTuple_GET_SIZE(args) >= 1 &&
3004 PyTuple_GET_SIZE(args) <= 2 &&
Martin v. Löwis10a60b32007-07-18 02:28:27 +00003005 PyBytes_Check(state = PyTuple_GET_ITEM(args, 0)) &&
3006 PyBytes_GET_SIZE(state) == _PyDateTime_TIME_DATASIZE &&
3007 ((unsigned char) (PyBytes_AS_STRING(state)[0])) < 24)
Guido van Rossum177e41a2003-01-30 22:06:23 +00003008 {
Tim Peters70533e22003-02-01 04:40:04 +00003009 PyDateTime_Time *me;
3010 char aware;
3011
3012 if (PyTuple_GET_SIZE(args) == 2) {
Guido van Rossum177e41a2003-01-30 22:06:23 +00003013 tzinfo = PyTuple_GET_ITEM(args, 1);
Tim Peters70533e22003-02-01 04:40:04 +00003014 if (check_tzinfo_subclass(tzinfo) < 0) {
3015 PyErr_SetString(PyExc_TypeError, "bad "
3016 "tzinfo state arg");
3017 return NULL;
Guido van Rossum177e41a2003-01-30 22:06:23 +00003018 }
3019 }
Tim Peters70533e22003-02-01 04:40:04 +00003020 aware = (char)(tzinfo != Py_None);
Tim Peters604c0132004-06-07 23:04:33 +00003021 me = (PyDateTime_Time *) (type->tp_alloc(type, aware));
Tim Peters70533e22003-02-01 04:40:04 +00003022 if (me != NULL) {
Martin v. Löwis10a60b32007-07-18 02:28:27 +00003023 char *pdata = PyBytes_AS_STRING(state);
Tim Peters70533e22003-02-01 04:40:04 +00003024
3025 memcpy(me->data, pdata, _PyDateTime_TIME_DATASIZE);
3026 me->hashcode = -1;
3027 me->hastzinfo = aware;
3028 if (aware) {
3029 Py_INCREF(tzinfo);
3030 me->tzinfo = tzinfo;
3031 }
3032 }
3033 return (PyObject *)me;
Guido van Rossum177e41a2003-01-30 22:06:23 +00003034 }
3035
Tim Peters37f39822003-01-10 03:49:02 +00003036 if (PyArg_ParseTupleAndKeywords(args, kw, "|iiiiO", time_kws,
Tim Peters2a799bf2002-12-16 20:18:38 +00003037 &hour, &minute, &second, &usecond,
3038 &tzinfo)) {
3039 if (check_time_args(hour, minute, second, usecond) < 0)
3040 return NULL;
3041 if (check_tzinfo_subclass(tzinfo) < 0)
3042 return NULL;
Tim Petersa98924a2003-05-17 05:55:19 +00003043 self = new_time_ex(hour, minute, second, usecond, tzinfo,
3044 type);
Tim Peters2a799bf2002-12-16 20:18:38 +00003045 }
3046 return self;
3047}
3048
3049/*
3050 * Destructor.
3051 */
3052
3053static void
Tim Peters37f39822003-01-10 03:49:02 +00003054time_dealloc(PyDateTime_Time *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003055{
Tim Petersa032d2e2003-01-11 00:15:54 +00003056 if (HASTZINFO(self)) {
Tim Peters37f39822003-01-10 03:49:02 +00003057 Py_XDECREF(self->tzinfo);
Neal Norwitz8e914d92003-01-10 15:29:16 +00003058 }
Tim Peters2a799bf2002-12-16 20:18:38 +00003059 self->ob_type->tp_free((PyObject *)self);
3060}
3061
3062/*
Tim Peters855fe882002-12-22 03:43:39 +00003063 * Indirect access to tzinfo methods.
Tim Peters2a799bf2002-12-16 20:18:38 +00003064 */
3065
Tim Peters2a799bf2002-12-16 20:18:38 +00003066/* These are all METH_NOARGS, so don't need to check the arglist. */
3067static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003068time_utcoffset(PyDateTime_Time *self, PyObject *unused) {
Tim Petersa032d2e2003-01-11 00:15:54 +00003069 return offset_as_timedelta(HASTZINFO(self) ? self->tzinfo : Py_None,
Tim Peters37f39822003-01-10 03:49:02 +00003070 "utcoffset", Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00003071}
3072
3073static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003074time_dst(PyDateTime_Time *self, PyObject *unused) {
Tim Petersa032d2e2003-01-11 00:15:54 +00003075 return offset_as_timedelta(HASTZINFO(self) ? self->tzinfo : Py_None,
Tim Peters37f39822003-01-10 03:49:02 +00003076 "dst", Py_None);
Tim Peters855fe882002-12-22 03:43:39 +00003077}
3078
3079static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003080time_tzname(PyDateTime_Time *self, PyObject *unused) {
Tim Petersa032d2e2003-01-11 00:15:54 +00003081 return call_tzname(HASTZINFO(self) ? self->tzinfo : Py_None,
Tim Peters37f39822003-01-10 03:49:02 +00003082 Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00003083}
3084
3085/*
Tim Peters37f39822003-01-10 03:49:02 +00003086 * Various ways to turn a time into a string.
Tim Peters2a799bf2002-12-16 20:18:38 +00003087 */
3088
3089static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003090time_repr(PyDateTime_Time *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003091{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00003092 const char *type_name = self->ob_type->tp_name;
Tim Peters37f39822003-01-10 03:49:02 +00003093 int h = TIME_GET_HOUR(self);
3094 int m = TIME_GET_MINUTE(self);
3095 int s = TIME_GET_SECOND(self);
3096 int us = TIME_GET_MICROSECOND(self);
3097 PyObject *result = NULL;
Tim Peters2a799bf2002-12-16 20:18:38 +00003098
Tim Peters37f39822003-01-10 03:49:02 +00003099 if (us)
Walter Dörwald7569dfe2007-05-19 21:49:49 +00003100 result = PyUnicode_FromFormat("%s(%d, %d, %d, %d)",
3101 type_name, h, m, s, us);
Tim Peters37f39822003-01-10 03:49:02 +00003102 else if (s)
Walter Dörwald7569dfe2007-05-19 21:49:49 +00003103 result = PyUnicode_FromFormat("%s(%d, %d, %d)",
3104 type_name, h, m, s);
Tim Peters37f39822003-01-10 03:49:02 +00003105 else
Walter Dörwald7569dfe2007-05-19 21:49:49 +00003106 result = PyUnicode_FromFormat("%s(%d, %d)", type_name, h, m);
Tim Petersa032d2e2003-01-11 00:15:54 +00003107 if (result != NULL && HASTZINFO(self))
Tim Peters37f39822003-01-10 03:49:02 +00003108 result = append_keyword_tzinfo(result, self->tzinfo);
3109 return result;
Tim Peters2a799bf2002-12-16 20:18:38 +00003110}
3111
Tim Peters37f39822003-01-10 03:49:02 +00003112static PyObject *
3113time_str(PyDateTime_Time *self)
3114{
3115 return PyObject_CallMethod((PyObject *)self, "isoformat", "()");
3116}
Tim Peters2a799bf2002-12-16 20:18:38 +00003117
3118static PyObject *
Thomas Wouterscf297e42007-02-23 15:07:44 +00003119time_isoformat(PyDateTime_Time *self, PyObject *unused)
Tim Peters2a799bf2002-12-16 20:18:38 +00003120{
3121 char buf[100];
Tim Peters37f39822003-01-10 03:49:02 +00003122 PyObject *result;
Walter Dörwaldbafa1372007-05-31 17:50:48 +00003123 int us = TIME_GET_MICROSECOND(self);;
Tim Peters2a799bf2002-12-16 20:18:38 +00003124
Walter Dörwaldbafa1372007-05-31 17:50:48 +00003125 if (us)
3126 result = PyUnicode_FromFormat("%02d:%02d:%02d.%06d",
3127 TIME_GET_HOUR(self),
3128 TIME_GET_MINUTE(self),
3129 TIME_GET_SECOND(self),
3130 us);
3131 else
3132 result = PyUnicode_FromFormat("%02d:%02d:%02d",
3133 TIME_GET_HOUR(self),
3134 TIME_GET_MINUTE(self),
3135 TIME_GET_SECOND(self));
Tim Peters37f39822003-01-10 03:49:02 +00003136
Tim Petersa032d2e2003-01-11 00:15:54 +00003137 if (result == NULL || ! HASTZINFO(self) || self->tzinfo == Py_None)
Tim Peters2a799bf2002-12-16 20:18:38 +00003138 return result;
3139
3140 /* We need to append the UTC offset. */
3141 if (format_utcoffset(buf, sizeof(buf), ":", self->tzinfo,
Tim Petersbad8ff02002-12-30 20:52:32 +00003142 Py_None) < 0) {
Tim Peters2a799bf2002-12-16 20:18:38 +00003143 Py_DECREF(result);
3144 return NULL;
3145 }
Walter Dörwaldbafa1372007-05-31 17:50:48 +00003146 PyUnicode_AppendAndDel(&result, PyUnicode_FromString(buf));
Tim Peters2a799bf2002-12-16 20:18:38 +00003147 return result;
3148}
3149
Tim Peters37f39822003-01-10 03:49:02 +00003150static PyObject *
3151time_strftime(PyDateTime_Time *self, PyObject *args, PyObject *kw)
3152{
3153 PyObject *result;
3154 PyObject *format;
3155 PyObject *tuple;
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00003156 static char *keywords[] = {"format", NULL};
Tim Peters37f39822003-01-10 03:49:02 +00003157
Guido van Rossumbce56a62007-05-10 18:04:33 +00003158 if (! PyArg_ParseTupleAndKeywords(args, kw, "S:strftime", keywords,
3159 &format))
Tim Peters37f39822003-01-10 03:49:02 +00003160 return NULL;
3161
3162 /* Python's strftime does insane things with the year part of the
3163 * timetuple. The year is forced to (the otherwise nonsensical)
3164 * 1900 to worm around that.
3165 */
3166 tuple = Py_BuildValue("iiiiiiiii",
Brett Cannond1080a32004-03-02 04:38:10 +00003167 1900, 1, 1, /* year, month, day */
Tim Peters37f39822003-01-10 03:49:02 +00003168 TIME_GET_HOUR(self),
3169 TIME_GET_MINUTE(self),
3170 TIME_GET_SECOND(self),
Brett Cannond1080a32004-03-02 04:38:10 +00003171 0, 1, -1); /* weekday, daynum, dst */
Tim Peters37f39822003-01-10 03:49:02 +00003172 if (tuple == NULL)
3173 return NULL;
3174 assert(PyTuple_Size(tuple) == 9);
3175 result = wrap_strftime((PyObject *)self, format, tuple, Py_None);
3176 Py_DECREF(tuple);
3177 return result;
3178}
Tim Peters2a799bf2002-12-16 20:18:38 +00003179
3180/*
3181 * Miscellaneous methods.
3182 */
3183
Tim Peters37f39822003-01-10 03:49:02 +00003184static PyObject *
Guido van Rossum19960592006-08-24 17:29:38 +00003185time_richcompare(PyObject *self, PyObject *other, int op)
Tim Peters37f39822003-01-10 03:49:02 +00003186{
3187 int diff;
3188 naivety n1, n2;
3189 int offset1, offset2;
3190
3191 if (! PyTime_Check(other)) {
Guido van Rossum19960592006-08-24 17:29:38 +00003192 Py_INCREF(Py_NotImplemented);
3193 return Py_NotImplemented;
Tim Peters37f39822003-01-10 03:49:02 +00003194 }
Guido van Rossum19960592006-08-24 17:29:38 +00003195 if (classify_two_utcoffsets(self, &offset1, &n1, Py_None,
3196 other, &offset2, &n2, Py_None) < 0)
Tim Peters37f39822003-01-10 03:49:02 +00003197 return NULL;
3198 assert(n1 != OFFSET_UNKNOWN && n2 != OFFSET_UNKNOWN);
3199 /* If they're both naive, or both aware and have the same offsets,
3200 * we get off cheap. Note that if they're both naive, offset1 ==
3201 * offset2 == 0 at this point.
3202 */
3203 if (n1 == n2 && offset1 == offset2) {
Guido van Rossum19960592006-08-24 17:29:38 +00003204 diff = memcmp(((PyDateTime_Time *)self)->data,
3205 ((PyDateTime_Time *)other)->data,
Tim Peters37f39822003-01-10 03:49:02 +00003206 _PyDateTime_TIME_DATASIZE);
3207 return diff_to_bool(diff, op);
3208 }
3209
3210 if (n1 == OFFSET_AWARE && n2 == OFFSET_AWARE) {
3211 assert(offset1 != offset2); /* else last "if" handled it */
3212 /* Convert everything except microseconds to seconds. These
3213 * can't overflow (no more than the # of seconds in 2 days).
3214 */
3215 offset1 = TIME_GET_HOUR(self) * 3600 +
3216 (TIME_GET_MINUTE(self) - offset1) * 60 +
3217 TIME_GET_SECOND(self);
3218 offset2 = TIME_GET_HOUR(other) * 3600 +
3219 (TIME_GET_MINUTE(other) - offset2) * 60 +
3220 TIME_GET_SECOND(other);
3221 diff = offset1 - offset2;
3222 if (diff == 0)
3223 diff = TIME_GET_MICROSECOND(self) -
3224 TIME_GET_MICROSECOND(other);
3225 return diff_to_bool(diff, op);
3226 }
3227
3228 assert(n1 != n2);
3229 PyErr_SetString(PyExc_TypeError,
3230 "can't compare offset-naive and "
3231 "offset-aware times");
3232 return NULL;
3233}
3234
3235static long
3236time_hash(PyDateTime_Time *self)
3237{
3238 if (self->hashcode == -1) {
3239 naivety n;
3240 int offset;
3241 PyObject *temp;
3242
3243 n = classify_utcoffset((PyObject *)self, Py_None, &offset);
3244 assert(n != OFFSET_UNKNOWN);
3245 if (n == OFFSET_ERROR)
3246 return -1;
3247
3248 /* Reduce this to a hash of another object. */
3249 if (offset == 0)
3250 temp = PyString_FromStringAndSize((char *)self->data,
3251 _PyDateTime_TIME_DATASIZE);
3252 else {
3253 int hour;
3254 int minute;
3255
3256 assert(n == OFFSET_AWARE);
Tim Petersa032d2e2003-01-11 00:15:54 +00003257 assert(HASTZINFO(self));
Tim Peters37f39822003-01-10 03:49:02 +00003258 hour = divmod(TIME_GET_HOUR(self) * 60 +
3259 TIME_GET_MINUTE(self) - offset,
3260 60,
3261 &minute);
3262 if (0 <= hour && hour < 24)
3263 temp = new_time(hour, minute,
3264 TIME_GET_SECOND(self),
3265 TIME_GET_MICROSECOND(self),
3266 Py_None);
3267 else
3268 temp = Py_BuildValue("iiii",
3269 hour, minute,
3270 TIME_GET_SECOND(self),
3271 TIME_GET_MICROSECOND(self));
3272 }
3273 if (temp != NULL) {
3274 self->hashcode = PyObject_Hash(temp);
3275 Py_DECREF(temp);
3276 }
3277 }
3278 return self->hashcode;
3279}
Tim Peters2a799bf2002-12-16 20:18:38 +00003280
Tim Peters12bf3392002-12-24 05:41:27 +00003281static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003282time_replace(PyDateTime_Time *self, PyObject *args, PyObject *kw)
Tim Peters12bf3392002-12-24 05:41:27 +00003283{
3284 PyObject *clone;
3285 PyObject *tuple;
3286 int hh = TIME_GET_HOUR(self);
3287 int mm = TIME_GET_MINUTE(self);
3288 int ss = TIME_GET_SECOND(self);
3289 int us = TIME_GET_MICROSECOND(self);
Tim Petersa032d2e2003-01-11 00:15:54 +00003290 PyObject *tzinfo = HASTZINFO(self) ? self->tzinfo : Py_None;
Tim Peters12bf3392002-12-24 05:41:27 +00003291
3292 if (! PyArg_ParseTupleAndKeywords(args, kw, "|iiiiO:replace",
Tim Peters37f39822003-01-10 03:49:02 +00003293 time_kws,
Tim Peters12bf3392002-12-24 05:41:27 +00003294 &hh, &mm, &ss, &us, &tzinfo))
3295 return NULL;
3296 tuple = Py_BuildValue("iiiiO", hh, mm, ss, us, tzinfo);
3297 if (tuple == NULL)
3298 return NULL;
Tim Peters37f39822003-01-10 03:49:02 +00003299 clone = time_new(self->ob_type, tuple, NULL);
Tim Peters12bf3392002-12-24 05:41:27 +00003300 Py_DECREF(tuple);
3301 return clone;
3302}
3303
Tim Peters2a799bf2002-12-16 20:18:38 +00003304static int
Jack Diederich4dafcc42006-11-28 19:15:13 +00003305time_bool(PyDateTime_Time *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003306{
3307 int offset;
3308 int none;
3309
3310 if (TIME_GET_SECOND(self) || TIME_GET_MICROSECOND(self)) {
3311 /* Since utcoffset is in whole minutes, nothing can
3312 * alter the conclusion that this is nonzero.
3313 */
3314 return 1;
3315 }
3316 offset = 0;
Tim Petersa032d2e2003-01-11 00:15:54 +00003317 if (HASTZINFO(self) && self->tzinfo != Py_None) {
Tim Petersbad8ff02002-12-30 20:52:32 +00003318 offset = call_utcoffset(self->tzinfo, Py_None, &none);
Tim Peters2a799bf2002-12-16 20:18:38 +00003319 if (offset == -1 && PyErr_Occurred())
3320 return -1;
3321 }
3322 return (TIME_GET_MINUTE(self) - offset + TIME_GET_HOUR(self)*60) != 0;
3323}
3324
Tim Peters371935f2003-02-01 01:52:50 +00003325/* Pickle support, a simple use of __reduce__. */
Tim Peters2a799bf2002-12-16 20:18:38 +00003326
Tim Peters33e0f382003-01-10 02:05:14 +00003327/* Let basestate be the non-tzinfo data string.
Tim Peters2a799bf2002-12-16 20:18:38 +00003328 * If tzinfo is None, this returns (basestate,), else (basestate, tzinfo).
3329 * So it's a tuple in any (non-error) case.
Tim Petersb57f8f02003-02-01 02:54:15 +00003330 * __getstate__ isn't exposed.
Tim Peters2a799bf2002-12-16 20:18:38 +00003331 */
3332static PyObject *
Tim Peters37f39822003-01-10 03:49:02 +00003333time_getstate(PyDateTime_Time *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003334{
3335 PyObject *basestate;
3336 PyObject *result = NULL;
3337
Martin v. Löwis10a60b32007-07-18 02:28:27 +00003338 basestate = PyBytes_FromStringAndSize((char *)self->data,
Tim Peters33e0f382003-01-10 02:05:14 +00003339 _PyDateTime_TIME_DATASIZE);
Tim Peters2a799bf2002-12-16 20:18:38 +00003340 if (basestate != NULL) {
Tim Petersa032d2e2003-01-11 00:15:54 +00003341 if (! HASTZINFO(self) || self->tzinfo == Py_None)
Raymond Hettinger8ae46892003-10-12 19:09:37 +00003342 result = PyTuple_Pack(1, basestate);
Tim Peters2a799bf2002-12-16 20:18:38 +00003343 else
Raymond Hettinger8ae46892003-10-12 19:09:37 +00003344 result = PyTuple_Pack(2, basestate, self->tzinfo);
Tim Peters2a799bf2002-12-16 20:18:38 +00003345 Py_DECREF(basestate);
3346 }
3347 return result;
3348}
3349
3350static PyObject *
Guido van Rossum177e41a2003-01-30 22:06:23 +00003351time_reduce(PyDateTime_Time *self, PyObject *arg)
Tim Peters2a799bf2002-12-16 20:18:38 +00003352{
Guido van Rossum177e41a2003-01-30 22:06:23 +00003353 return Py_BuildValue("(ON)", self->ob_type, time_getstate(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00003354}
3355
Tim Peters37f39822003-01-10 03:49:02 +00003356static PyMethodDef time_methods[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00003357
Thomas Wouterscf297e42007-02-23 15:07:44 +00003358 {"isoformat", (PyCFunction)time_isoformat, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00003359 PyDoc_STR("Return string in ISO 8601 format, HH:MM:SS[.mmmmmm]"
3360 "[+HH:MM].")},
3361
Guido van Rossumd59da4b2007-05-22 18:11:13 +00003362 {"strftime", (PyCFunction)time_strftime, METH_VARARGS | METH_KEYWORDS,
Tim Peters37f39822003-01-10 03:49:02 +00003363 PyDoc_STR("format -> strftime() style string.")},
3364
3365 {"utcoffset", (PyCFunction)time_utcoffset, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00003366 PyDoc_STR("Return self.tzinfo.utcoffset(self).")},
3367
Tim Peters37f39822003-01-10 03:49:02 +00003368 {"tzname", (PyCFunction)time_tzname, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00003369 PyDoc_STR("Return self.tzinfo.tzname(self).")},
3370
Tim Peters37f39822003-01-10 03:49:02 +00003371 {"dst", (PyCFunction)time_dst, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00003372 PyDoc_STR("Return self.tzinfo.dst(self).")},
3373
Guido van Rossumd59da4b2007-05-22 18:11:13 +00003374 {"replace", (PyCFunction)time_replace, METH_VARARGS | METH_KEYWORDS,
Tim Peters37f39822003-01-10 03:49:02 +00003375 PyDoc_STR("Return time with new specified fields.")},
Tim Peters12bf3392002-12-24 05:41:27 +00003376
Guido van Rossum177e41a2003-01-30 22:06:23 +00003377 {"__reduce__", (PyCFunction)time_reduce, METH_NOARGS,
3378 PyDoc_STR("__reduce__() -> (cls, state)")},
3379
Tim Peters2a799bf2002-12-16 20:18:38 +00003380 {NULL, NULL}
Tim Peters2a799bf2002-12-16 20:18:38 +00003381};
3382
Tim Peters37f39822003-01-10 03:49:02 +00003383static char time_doc[] =
Raymond Hettinger3a4231d2004-12-19 20:13:24 +00003384PyDoc_STR("time([hour[, minute[, second[, microsecond[, tzinfo]]]]]) --> a time object\n\
3385\n\
3386All arguments are optional. tzinfo may be None, or an instance of\n\
3387a tzinfo subclass. The remaining arguments may be ints or longs.\n");
Tim Peters2a799bf2002-12-16 20:18:38 +00003388
Tim Peters37f39822003-01-10 03:49:02 +00003389static PyNumberMethods time_as_number = {
Tim Peters2a799bf2002-12-16 20:18:38 +00003390 0, /* nb_add */
3391 0, /* nb_subtract */
3392 0, /* nb_multiply */
Tim Peters2a799bf2002-12-16 20:18:38 +00003393 0, /* nb_remainder */
3394 0, /* nb_divmod */
3395 0, /* nb_power */
3396 0, /* nb_negative */
3397 0, /* nb_positive */
3398 0, /* nb_absolute */
Jack Diederich4dafcc42006-11-28 19:15:13 +00003399 (inquiry)time_bool, /* nb_bool */
Tim Peters2a799bf2002-12-16 20:18:38 +00003400};
3401
Neal Norwitz227b5332006-03-22 09:28:35 +00003402static PyTypeObject PyDateTime_TimeType = {
Tim Peters2a799bf2002-12-16 20:18:38 +00003403 PyObject_HEAD_INIT(NULL)
3404 0, /* ob_size */
Tim Peters0bf60bd2003-01-08 20:40:01 +00003405 "datetime.time", /* tp_name */
Tim Peters37f39822003-01-10 03:49:02 +00003406 sizeof(PyDateTime_Time), /* tp_basicsize */
Tim Peters2a799bf2002-12-16 20:18:38 +00003407 0, /* tp_itemsize */
Tim Peters37f39822003-01-10 03:49:02 +00003408 (destructor)time_dealloc, /* tp_dealloc */
Tim Peters2a799bf2002-12-16 20:18:38 +00003409 0, /* tp_print */
3410 0, /* tp_getattr */
3411 0, /* tp_setattr */
3412 0, /* tp_compare */
Tim Peters37f39822003-01-10 03:49:02 +00003413 (reprfunc)time_repr, /* tp_repr */
3414 &time_as_number, /* tp_as_number */
Tim Peters2a799bf2002-12-16 20:18:38 +00003415 0, /* tp_as_sequence */
3416 0, /* tp_as_mapping */
Tim Peters37f39822003-01-10 03:49:02 +00003417 (hashfunc)time_hash, /* tp_hash */
Tim Peters2a799bf2002-12-16 20:18:38 +00003418 0, /* tp_call */
Tim Peters37f39822003-01-10 03:49:02 +00003419 (reprfunc)time_str, /* tp_str */
Tim Peters2a799bf2002-12-16 20:18:38 +00003420 PyObject_GenericGetAttr, /* tp_getattro */
3421 0, /* tp_setattro */
3422 0, /* tp_as_buffer */
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00003423 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
Tim Peters37f39822003-01-10 03:49:02 +00003424 time_doc, /* tp_doc */
Tim Peters2a799bf2002-12-16 20:18:38 +00003425 0, /* tp_traverse */
3426 0, /* tp_clear */
Guido van Rossum19960592006-08-24 17:29:38 +00003427 time_richcompare, /* tp_richcompare */
Tim Peters2a799bf2002-12-16 20:18:38 +00003428 0, /* tp_weaklistoffset */
3429 0, /* tp_iter */
3430 0, /* tp_iternext */
Tim Peters37f39822003-01-10 03:49:02 +00003431 time_methods, /* tp_methods */
Tim Peters2a799bf2002-12-16 20:18:38 +00003432 0, /* tp_members */
Tim Peters37f39822003-01-10 03:49:02 +00003433 time_getset, /* tp_getset */
3434 0, /* tp_base */
Tim Peters2a799bf2002-12-16 20:18:38 +00003435 0, /* tp_dict */
3436 0, /* tp_descr_get */
3437 0, /* tp_descr_set */
3438 0, /* tp_dictoffset */
3439 0, /* tp_init */
Tim Petersa98924a2003-05-17 05:55:19 +00003440 time_alloc, /* tp_alloc */
Tim Peters37f39822003-01-10 03:49:02 +00003441 time_new, /* tp_new */
Tim Peters4c530132003-05-16 22:44:06 +00003442 0, /* tp_free */
Tim Peters2a799bf2002-12-16 20:18:38 +00003443};
3444
3445/*
Tim Petersa9bc1682003-01-11 03:39:11 +00003446 * PyDateTime_DateTime implementation.
Tim Peters2a799bf2002-12-16 20:18:38 +00003447 */
3448
Tim Petersa9bc1682003-01-11 03:39:11 +00003449/* Accessor properties. Properties for day, month, and year are inherited
3450 * from date.
Tim Peters2a799bf2002-12-16 20:18:38 +00003451 */
3452
3453static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003454datetime_hour(PyDateTime_DateTime *self, void *unused)
Tim Peters2a799bf2002-12-16 20:18:38 +00003455{
Tim Petersa9bc1682003-01-11 03:39:11 +00003456 return PyInt_FromLong(DATE_GET_HOUR(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00003457}
3458
Tim Petersa9bc1682003-01-11 03:39:11 +00003459static PyObject *
3460datetime_minute(PyDateTime_DateTime *self, void *unused)
3461{
3462 return PyInt_FromLong(DATE_GET_MINUTE(self));
3463}
3464
3465static PyObject *
3466datetime_second(PyDateTime_DateTime *self, void *unused)
3467{
3468 return PyInt_FromLong(DATE_GET_SECOND(self));
3469}
3470
3471static PyObject *
3472datetime_microsecond(PyDateTime_DateTime *self, void *unused)
3473{
3474 return PyInt_FromLong(DATE_GET_MICROSECOND(self));
3475}
3476
3477static PyObject *
3478datetime_tzinfo(PyDateTime_DateTime *self, void *unused)
3479{
3480 PyObject *result = HASTZINFO(self) ? self->tzinfo : Py_None;
3481 Py_INCREF(result);
3482 return result;
3483}
3484
3485static PyGetSetDef datetime_getset[] = {
3486 {"hour", (getter)datetime_hour},
3487 {"minute", (getter)datetime_minute},
3488 {"second", (getter)datetime_second},
3489 {"microsecond", (getter)datetime_microsecond},
3490 {"tzinfo", (getter)datetime_tzinfo},
Tim Peters2a799bf2002-12-16 20:18:38 +00003491 {NULL}
3492};
3493
3494/*
3495 * Constructors.
Tim Peters2a799bf2002-12-16 20:18:38 +00003496 */
3497
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00003498static char *datetime_kws[] = {
Tim Peters12bf3392002-12-24 05:41:27 +00003499 "year", "month", "day", "hour", "minute", "second",
3500 "microsecond", "tzinfo", NULL
3501};
3502
Tim Peters2a799bf2002-12-16 20:18:38 +00003503static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003504datetime_new(PyTypeObject *type, PyObject *args, PyObject *kw)
Tim Peters2a799bf2002-12-16 20:18:38 +00003505{
3506 PyObject *self = NULL;
Tim Peters70533e22003-02-01 04:40:04 +00003507 PyObject *state;
Tim Peters2a799bf2002-12-16 20:18:38 +00003508 int year;
3509 int month;
3510 int day;
3511 int hour = 0;
3512 int minute = 0;
3513 int second = 0;
3514 int usecond = 0;
3515 PyObject *tzinfo = Py_None;
3516
Guido van Rossum177e41a2003-01-30 22:06:23 +00003517 /* Check for invocation from pickle with __getstate__ state */
3518 if (PyTuple_GET_SIZE(args) >= 1 &&
3519 PyTuple_GET_SIZE(args) <= 2 &&
Martin v. Löwis10a60b32007-07-18 02:28:27 +00003520 PyBytes_Check(state = PyTuple_GET_ITEM(args, 0)) &&
3521 PyBytes_GET_SIZE(state) == _PyDateTime_DATETIME_DATASIZE &&
3522 MONTH_IS_SANE(PyBytes_AS_STRING(state)[2]))
Guido van Rossum177e41a2003-01-30 22:06:23 +00003523 {
Tim Peters70533e22003-02-01 04:40:04 +00003524 PyDateTime_DateTime *me;
3525 char aware;
3526
3527 if (PyTuple_GET_SIZE(args) == 2) {
Guido van Rossum177e41a2003-01-30 22:06:23 +00003528 tzinfo = PyTuple_GET_ITEM(args, 1);
Tim Peters70533e22003-02-01 04:40:04 +00003529 if (check_tzinfo_subclass(tzinfo) < 0) {
3530 PyErr_SetString(PyExc_TypeError, "bad "
3531 "tzinfo state arg");
3532 return NULL;
Guido van Rossum177e41a2003-01-30 22:06:23 +00003533 }
3534 }
Tim Peters70533e22003-02-01 04:40:04 +00003535 aware = (char)(tzinfo != Py_None);
Tim Peters604c0132004-06-07 23:04:33 +00003536 me = (PyDateTime_DateTime *) (type->tp_alloc(type , aware));
Tim Peters70533e22003-02-01 04:40:04 +00003537 if (me != NULL) {
Martin v. Löwis10a60b32007-07-18 02:28:27 +00003538 char *pdata = PyBytes_AS_STRING(state);
Tim Peters70533e22003-02-01 04:40:04 +00003539
3540 memcpy(me->data, pdata, _PyDateTime_DATETIME_DATASIZE);
3541 me->hashcode = -1;
3542 me->hastzinfo = aware;
3543 if (aware) {
3544 Py_INCREF(tzinfo);
3545 me->tzinfo = tzinfo;
3546 }
3547 }
3548 return (PyObject *)me;
Guido van Rossum177e41a2003-01-30 22:06:23 +00003549 }
3550
Tim Petersa9bc1682003-01-11 03:39:11 +00003551 if (PyArg_ParseTupleAndKeywords(args, kw, "iii|iiiiO", datetime_kws,
Tim Peters2a799bf2002-12-16 20:18:38 +00003552 &year, &month, &day, &hour, &minute,
3553 &second, &usecond, &tzinfo)) {
3554 if (check_date_args(year, month, day) < 0)
3555 return NULL;
3556 if (check_time_args(hour, minute, second, usecond) < 0)
3557 return NULL;
3558 if (check_tzinfo_subclass(tzinfo) < 0)
3559 return NULL;
Tim Petersa98924a2003-05-17 05:55:19 +00003560 self = new_datetime_ex(year, month, day,
3561 hour, minute, second, usecond,
3562 tzinfo, type);
Tim Peters2a799bf2002-12-16 20:18:38 +00003563 }
3564 return self;
3565}
3566
Tim Petersa9bc1682003-01-11 03:39:11 +00003567/* TM_FUNC is the shared type of localtime() and gmtime(). */
3568typedef struct tm *(*TM_FUNC)(const time_t *timer);
3569
3570/* Internal helper.
3571 * Build datetime from a time_t and a distinct count of microseconds.
3572 * Pass localtime or gmtime for f, to control the interpretation of timet.
3573 */
3574static PyObject *
3575datetime_from_timet_and_us(PyObject *cls, TM_FUNC f, time_t timet, int us,
3576 PyObject *tzinfo)
3577{
3578 struct tm *tm;
3579 PyObject *result = NULL;
3580
3581 tm = f(&timet);
3582 if (tm) {
3583 /* The platform localtime/gmtime may insert leap seconds,
3584 * indicated by tm->tm_sec > 59. We don't care about them,
3585 * except to the extent that passing them on to the datetime
3586 * constructor would raise ValueError for a reason that
3587 * made no sense to the user.
3588 */
3589 if (tm->tm_sec > 59)
3590 tm->tm_sec = 59;
3591 result = PyObject_CallFunction(cls, "iiiiiiiO",
3592 tm->tm_year + 1900,
3593 tm->tm_mon + 1,
3594 tm->tm_mday,
3595 tm->tm_hour,
3596 tm->tm_min,
3597 tm->tm_sec,
3598 us,
3599 tzinfo);
3600 }
3601 else
3602 PyErr_SetString(PyExc_ValueError,
3603 "timestamp out of range for "
3604 "platform localtime()/gmtime() function");
3605 return result;
3606}
3607
3608/* Internal helper.
3609 * Build datetime from a Python timestamp. Pass localtime or gmtime for f,
3610 * to control the interpretation of the timestamp. Since a double doesn't
3611 * have enough bits to cover a datetime's full range of precision, it's
3612 * better to call datetime_from_timet_and_us provided you have a way
3613 * to get that much precision (e.g., C time() isn't good enough).
3614 */
3615static PyObject *
3616datetime_from_timestamp(PyObject *cls, TM_FUNC f, double timestamp,
3617 PyObject *tzinfo)
3618{
Tim Peters1b6f7a92004-06-20 02:50:16 +00003619 time_t timet;
3620 double fraction;
3621 int us;
Tim Petersa9bc1682003-01-11 03:39:11 +00003622
Tim Peters1b6f7a92004-06-20 02:50:16 +00003623 timet = _PyTime_DoubleToTimet(timestamp);
3624 if (timet == (time_t)-1 && PyErr_Occurred())
3625 return NULL;
3626 fraction = timestamp - (double)timet;
3627 us = (int)round_to_long(fraction * 1e6);
Guido van Rossumd8faa362007-04-27 19:54:29 +00003628 if (us < 0) {
3629 /* Truncation towards zero is not what we wanted
3630 for negative numbers (Python's mod semantics) */
3631 timet -= 1;
3632 us += 1000000;
3633 }
Thomas Wouters477c8d52006-05-27 19:21:47 +00003634 /* If timestamp is less than one microsecond smaller than a
3635 * full second, round up. Otherwise, ValueErrors are raised
3636 * for some floats. */
3637 if (us == 1000000) {
3638 timet += 1;
3639 us = 0;
3640 }
Tim Petersa9bc1682003-01-11 03:39:11 +00003641 return datetime_from_timet_and_us(cls, f, timet, us, tzinfo);
3642}
3643
3644/* Internal helper.
3645 * Build most accurate possible datetime for current time. Pass localtime or
3646 * gmtime for f as appropriate.
3647 */
3648static PyObject *
3649datetime_best_possible(PyObject *cls, TM_FUNC f, PyObject *tzinfo)
3650{
3651#ifdef HAVE_GETTIMEOFDAY
3652 struct timeval t;
3653
3654#ifdef GETTIMEOFDAY_NO_TZ
3655 gettimeofday(&t);
3656#else
3657 gettimeofday(&t, (struct timezone *)NULL);
3658#endif
3659 return datetime_from_timet_and_us(cls, f, t.tv_sec, (int)t.tv_usec,
3660 tzinfo);
3661
3662#else /* ! HAVE_GETTIMEOFDAY */
3663 /* No flavor of gettimeofday exists on this platform. Python's
3664 * time.time() does a lot of other platform tricks to get the
3665 * best time it can on the platform, and we're not going to do
3666 * better than that (if we could, the better code would belong
3667 * in time.time()!) We're limited by the precision of a double,
3668 * though.
3669 */
3670 PyObject *time;
3671 double dtime;
3672
3673 time = time_time();
3674 if (time == NULL)
3675 return NULL;
3676 dtime = PyFloat_AsDouble(time);
3677 Py_DECREF(time);
3678 if (dtime == -1.0 && PyErr_Occurred())
3679 return NULL;
3680 return datetime_from_timestamp(cls, f, dtime, tzinfo);
3681#endif /* ! HAVE_GETTIMEOFDAY */
3682}
3683
Tim Peters2a799bf2002-12-16 20:18:38 +00003684/* Return best possible local time -- this isn't constrained by the
3685 * precision of a timestamp.
3686 */
3687static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003688datetime_now(PyObject *cls, PyObject *args, PyObject *kw)
Tim Peters2a799bf2002-12-16 20:18:38 +00003689{
Tim Peters10cadce2003-01-23 19:58:02 +00003690 PyObject *self;
Tim Peters2a799bf2002-12-16 20:18:38 +00003691 PyObject *tzinfo = Py_None;
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00003692 static char *keywords[] = {"tz", NULL};
Tim Peters2a799bf2002-12-16 20:18:38 +00003693
Tim Peters10cadce2003-01-23 19:58:02 +00003694 if (! PyArg_ParseTupleAndKeywords(args, kw, "|O:now", keywords,
3695 &tzinfo))
3696 return NULL;
3697 if (check_tzinfo_subclass(tzinfo) < 0)
3698 return NULL;
3699
3700 self = datetime_best_possible(cls,
3701 tzinfo == Py_None ? localtime : gmtime,
3702 tzinfo);
3703 if (self != NULL && tzinfo != Py_None) {
3704 /* Convert UTC to tzinfo's zone. */
3705 PyObject *temp = self;
Tim Peters2a44a8d2003-01-23 20:53:10 +00003706 self = PyObject_CallMethod(tzinfo, "fromutc", "O", self);
Tim Peters10cadce2003-01-23 19:58:02 +00003707 Py_DECREF(temp);
Tim Peters2a799bf2002-12-16 20:18:38 +00003708 }
3709 return self;
3710}
3711
Tim Petersa9bc1682003-01-11 03:39:11 +00003712/* Return best possible UTC time -- this isn't constrained by the
3713 * precision of a timestamp.
3714 */
3715static PyObject *
3716datetime_utcnow(PyObject *cls, PyObject *dummy)
3717{
3718 return datetime_best_possible(cls, gmtime, Py_None);
3719}
3720
Tim Peters2a799bf2002-12-16 20:18:38 +00003721/* Return new local datetime from timestamp (Python timestamp -- a double). */
3722static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003723datetime_fromtimestamp(PyObject *cls, PyObject *args, PyObject *kw)
Tim Peters2a799bf2002-12-16 20:18:38 +00003724{
Tim Peters2a44a8d2003-01-23 20:53:10 +00003725 PyObject *self;
Tim Peters2a799bf2002-12-16 20:18:38 +00003726 double timestamp;
3727 PyObject *tzinfo = Py_None;
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00003728 static char *keywords[] = {"timestamp", "tz", NULL};
Tim Peters2a799bf2002-12-16 20:18:38 +00003729
Tim Peters2a44a8d2003-01-23 20:53:10 +00003730 if (! PyArg_ParseTupleAndKeywords(args, kw, "d|O:fromtimestamp",
3731 keywords, &timestamp, &tzinfo))
3732 return NULL;
3733 if (check_tzinfo_subclass(tzinfo) < 0)
3734 return NULL;
3735
3736 self = datetime_from_timestamp(cls,
3737 tzinfo == Py_None ? localtime : gmtime,
3738 timestamp,
3739 tzinfo);
3740 if (self != NULL && tzinfo != Py_None) {
3741 /* Convert UTC to tzinfo's zone. */
3742 PyObject *temp = self;
3743 self = PyObject_CallMethod(tzinfo, "fromutc", "O", self);
3744 Py_DECREF(temp);
Tim Peters2a799bf2002-12-16 20:18:38 +00003745 }
3746 return self;
3747}
3748
Tim Petersa9bc1682003-01-11 03:39:11 +00003749/* Return new UTC datetime from timestamp (Python timestamp -- a double). */
3750static PyObject *
3751datetime_utcfromtimestamp(PyObject *cls, PyObject *args)
3752{
3753 double timestamp;
3754 PyObject *result = NULL;
Tim Peters2a799bf2002-12-16 20:18:38 +00003755
Tim Petersa9bc1682003-01-11 03:39:11 +00003756 if (PyArg_ParseTuple(args, "d:utcfromtimestamp", &timestamp))
3757 result = datetime_from_timestamp(cls, gmtime, timestamp,
3758 Py_None);
3759 return result;
3760}
3761
Skip Montanaro0af3ade2005-01-13 04:12:31 +00003762/* Return new datetime from time.strptime(). */
3763static PyObject *
3764datetime_strptime(PyObject *cls, PyObject *args)
3765{
3766 PyObject *result = NULL, *obj, *module;
3767 const char *string, *format;
3768
3769 if (!PyArg_ParseTuple(args, "ss:strptime", &string, &format))
3770 return NULL;
3771
3772 if ((module = PyImport_ImportModule("time")) == NULL)
3773 return NULL;
3774 obj = PyObject_CallMethod(module, "strptime", "ss", string, format);
3775 Py_DECREF(module);
3776
3777 if (obj != NULL) {
3778 int i, good_timetuple = 1;
3779 long int ia[6];
3780 if (PySequence_Check(obj) && PySequence_Size(obj) >= 6)
3781 for (i=0; i < 6; i++) {
3782 PyObject *p = PySequence_GetItem(obj, i);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00003783 if (p == NULL) {
3784 Py_DECREF(obj);
3785 return NULL;
3786 }
Guido van Rossumddefaf32007-01-14 03:31:43 +00003787 if (PyInt_CheckExact(p))
Skip Montanaro0af3ade2005-01-13 04:12:31 +00003788 ia[i] = PyInt_AsLong(p);
3789 else
3790 good_timetuple = 0;
3791 Py_DECREF(p);
3792 }
3793 else
3794 good_timetuple = 0;
3795 if (good_timetuple)
3796 result = PyObject_CallFunction(cls, "iiiiii",
3797 ia[0], ia[1], ia[2], ia[3], ia[4], ia[5]);
3798 else
3799 PyErr_SetString(PyExc_ValueError,
3800 "unexpected value from time.strptime");
3801 Py_DECREF(obj);
3802 }
3803 return result;
3804}
3805
Tim Petersa9bc1682003-01-11 03:39:11 +00003806/* Return new datetime from date/datetime and time arguments. */
3807static PyObject *
3808datetime_combine(PyObject *cls, PyObject *args, PyObject *kw)
3809{
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00003810 static char *keywords[] = {"date", "time", NULL};
Tim Petersa9bc1682003-01-11 03:39:11 +00003811 PyObject *date;
3812 PyObject *time;
3813 PyObject *result = NULL;
3814
3815 if (PyArg_ParseTupleAndKeywords(args, kw, "O!O!:combine", keywords,
3816 &PyDateTime_DateType, &date,
3817 &PyDateTime_TimeType, &time)) {
3818 PyObject *tzinfo = Py_None;
3819
3820 if (HASTZINFO(time))
3821 tzinfo = ((PyDateTime_Time *)time)->tzinfo;
3822 result = PyObject_CallFunction(cls, "iiiiiiiO",
3823 GET_YEAR(date),
3824 GET_MONTH(date),
3825 GET_DAY(date),
3826 TIME_GET_HOUR(time),
3827 TIME_GET_MINUTE(time),
3828 TIME_GET_SECOND(time),
3829 TIME_GET_MICROSECOND(time),
3830 tzinfo);
3831 }
3832 return result;
3833}
Tim Peters2a799bf2002-12-16 20:18:38 +00003834
3835/*
3836 * Destructor.
3837 */
3838
3839static void
Tim Petersa9bc1682003-01-11 03:39:11 +00003840datetime_dealloc(PyDateTime_DateTime *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003841{
Tim Petersa9bc1682003-01-11 03:39:11 +00003842 if (HASTZINFO(self)) {
3843 Py_XDECREF(self->tzinfo);
3844 }
Tim Peters2a799bf2002-12-16 20:18:38 +00003845 self->ob_type->tp_free((PyObject *)self);
3846}
3847
3848/*
3849 * Indirect access to tzinfo methods.
3850 */
3851
Tim Peters2a799bf2002-12-16 20:18:38 +00003852/* These are all METH_NOARGS, so don't need to check the arglist. */
3853static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003854datetime_utcoffset(PyDateTime_DateTime *self, PyObject *unused) {
3855 return offset_as_timedelta(HASTZINFO(self) ? self->tzinfo : Py_None,
3856 "utcoffset", (PyObject *)self);
Tim Peters2a799bf2002-12-16 20:18:38 +00003857}
3858
3859static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003860datetime_dst(PyDateTime_DateTime *self, PyObject *unused) {
3861 return offset_as_timedelta(HASTZINFO(self) ? self->tzinfo : Py_None,
3862 "dst", (PyObject *)self);
Tim Peters855fe882002-12-22 03:43:39 +00003863}
3864
3865static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003866datetime_tzname(PyDateTime_DateTime *self, PyObject *unused) {
3867 return call_tzname(HASTZINFO(self) ? self->tzinfo : Py_None,
3868 (PyObject *)self);
Tim Peters2a799bf2002-12-16 20:18:38 +00003869}
3870
3871/*
Tim Petersa9bc1682003-01-11 03:39:11 +00003872 * datetime arithmetic.
Tim Peters2a799bf2002-12-16 20:18:38 +00003873 */
3874
Tim Petersa9bc1682003-01-11 03:39:11 +00003875/* factor must be 1 (to add) or -1 (to subtract). The result inherits
3876 * the tzinfo state of date.
Tim Peters2a799bf2002-12-16 20:18:38 +00003877 */
3878static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003879add_datetime_timedelta(PyDateTime_DateTime *date, PyDateTime_Delta *delta,
3880 int factor)
Tim Peters2a799bf2002-12-16 20:18:38 +00003881{
Tim Petersa9bc1682003-01-11 03:39:11 +00003882 /* Note that the C-level additions can't overflow, because of
3883 * invariant bounds on the member values.
3884 */
3885 int year = GET_YEAR(date);
3886 int month = GET_MONTH(date);
3887 int day = GET_DAY(date) + GET_TD_DAYS(delta) * factor;
3888 int hour = DATE_GET_HOUR(date);
3889 int minute = DATE_GET_MINUTE(date);
3890 int second = DATE_GET_SECOND(date) + GET_TD_SECONDS(delta) * factor;
3891 int microsecond = DATE_GET_MICROSECOND(date) +
3892 GET_TD_MICROSECONDS(delta) * factor;
Tim Peters2a799bf2002-12-16 20:18:38 +00003893
Tim Petersa9bc1682003-01-11 03:39:11 +00003894 assert(factor == 1 || factor == -1);
3895 if (normalize_datetime(&year, &month, &day,
3896 &hour, &minute, &second, &microsecond) < 0)
3897 return NULL;
3898 else
3899 return new_datetime(year, month, day,
3900 hour, minute, second, microsecond,
3901 HASTZINFO(date) ? date->tzinfo : Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00003902}
3903
3904static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003905datetime_add(PyObject *left, PyObject *right)
Tim Peters2a799bf2002-12-16 20:18:38 +00003906{
Tim Petersa9bc1682003-01-11 03:39:11 +00003907 if (PyDateTime_Check(left)) {
3908 /* datetime + ??? */
3909 if (PyDelta_Check(right))
3910 /* datetime + delta */
3911 return add_datetime_timedelta(
3912 (PyDateTime_DateTime *)left,
3913 (PyDateTime_Delta *)right,
3914 1);
3915 }
3916 else if (PyDelta_Check(left)) {
3917 /* delta + datetime */
3918 return add_datetime_timedelta((PyDateTime_DateTime *) right,
3919 (PyDateTime_Delta *) left,
3920 1);
3921 }
3922 Py_INCREF(Py_NotImplemented);
3923 return Py_NotImplemented;
Tim Peters2a799bf2002-12-16 20:18:38 +00003924}
3925
3926static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003927datetime_subtract(PyObject *left, PyObject *right)
Tim Peters2a799bf2002-12-16 20:18:38 +00003928{
3929 PyObject *result = Py_NotImplemented;
3930
3931 if (PyDateTime_Check(left)) {
3932 /* datetime - ??? */
3933 if (PyDateTime_Check(right)) {
3934 /* datetime - datetime */
3935 naivety n1, n2;
3936 int offset1, offset2;
Tim Petersa9bc1682003-01-11 03:39:11 +00003937 int delta_d, delta_s, delta_us;
Tim Peters2a799bf2002-12-16 20:18:38 +00003938
Tim Peterse39a80c2002-12-30 21:28:52 +00003939 if (classify_two_utcoffsets(left, &offset1, &n1, left,
3940 right, &offset2, &n2,
3941 right) < 0)
Tim Peters00237032002-12-27 02:21:51 +00003942 return NULL;
Tim Peters8702d5f2002-12-27 02:26:16 +00003943 assert(n1 != OFFSET_UNKNOWN && n2 != OFFSET_UNKNOWN);
Tim Peters2a799bf2002-12-16 20:18:38 +00003944 if (n1 != n2) {
3945 PyErr_SetString(PyExc_TypeError,
3946 "can't subtract offset-naive and "
3947 "offset-aware datetimes");
3948 return NULL;
3949 }
Tim Petersa9bc1682003-01-11 03:39:11 +00003950 delta_d = ymd_to_ord(GET_YEAR(left),
3951 GET_MONTH(left),
3952 GET_DAY(left)) -
3953 ymd_to_ord(GET_YEAR(right),
3954 GET_MONTH(right),
3955 GET_DAY(right));
3956 /* These can't overflow, since the values are
3957 * normalized. At most this gives the number of
3958 * seconds in one day.
3959 */
3960 delta_s = (DATE_GET_HOUR(left) -
3961 DATE_GET_HOUR(right)) * 3600 +
3962 (DATE_GET_MINUTE(left) -
3963 DATE_GET_MINUTE(right)) * 60 +
3964 (DATE_GET_SECOND(left) -
3965 DATE_GET_SECOND(right));
3966 delta_us = DATE_GET_MICROSECOND(left) -
3967 DATE_GET_MICROSECOND(right);
Tim Peters2a799bf2002-12-16 20:18:38 +00003968 /* (left - offset1) - (right - offset2) =
3969 * (left - right) + (offset2 - offset1)
3970 */
Tim Petersa9bc1682003-01-11 03:39:11 +00003971 delta_s += (offset2 - offset1) * 60;
3972 result = new_delta(delta_d, delta_s, delta_us, 1);
Tim Peters2a799bf2002-12-16 20:18:38 +00003973 }
3974 else if (PyDelta_Check(right)) {
Tim Petersa9bc1682003-01-11 03:39:11 +00003975 /* datetime - delta */
3976 result = add_datetime_timedelta(
Tim Peters2a799bf2002-12-16 20:18:38 +00003977 (PyDateTime_DateTime *)left,
Tim Petersa9bc1682003-01-11 03:39:11 +00003978 (PyDateTime_Delta *)right,
3979 -1);
Tim Peters2a799bf2002-12-16 20:18:38 +00003980 }
3981 }
3982
3983 if (result == Py_NotImplemented)
3984 Py_INCREF(result);
3985 return result;
3986}
3987
3988/* Various ways to turn a datetime into a string. */
3989
3990static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00003991datetime_repr(PyDateTime_DateTime *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00003992{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00003993 const char *type_name = self->ob_type->tp_name;
Tim Petersa9bc1682003-01-11 03:39:11 +00003994 PyObject *baserepr;
Tim Peters2a799bf2002-12-16 20:18:38 +00003995
Tim Petersa9bc1682003-01-11 03:39:11 +00003996 if (DATE_GET_MICROSECOND(self)) {
Walter Dörwald7569dfe2007-05-19 21:49:49 +00003997 baserepr = PyUnicode_FromFormat(
Tim Petersa9bc1682003-01-11 03:39:11 +00003998 "%s(%d, %d, %d, %d, %d, %d, %d)",
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00003999 type_name,
Tim Petersa9bc1682003-01-11 03:39:11 +00004000 GET_YEAR(self), GET_MONTH(self), GET_DAY(self),
4001 DATE_GET_HOUR(self), DATE_GET_MINUTE(self),
4002 DATE_GET_SECOND(self),
4003 DATE_GET_MICROSECOND(self));
4004 }
4005 else if (DATE_GET_SECOND(self)) {
Walter Dörwald7569dfe2007-05-19 21:49:49 +00004006 baserepr = PyUnicode_FromFormat(
Tim Petersa9bc1682003-01-11 03:39:11 +00004007 "%s(%d, %d, %d, %d, %d, %d)",
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004008 type_name,
Tim Petersa9bc1682003-01-11 03:39:11 +00004009 GET_YEAR(self), GET_MONTH(self), GET_DAY(self),
4010 DATE_GET_HOUR(self), DATE_GET_MINUTE(self),
4011 DATE_GET_SECOND(self));
4012 }
4013 else {
Walter Dörwald7569dfe2007-05-19 21:49:49 +00004014 baserepr = PyUnicode_FromFormat(
Tim Petersa9bc1682003-01-11 03:39:11 +00004015 "%s(%d, %d, %d, %d, %d)",
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004016 type_name,
Tim Petersa9bc1682003-01-11 03:39:11 +00004017 GET_YEAR(self), GET_MONTH(self), GET_DAY(self),
4018 DATE_GET_HOUR(self), DATE_GET_MINUTE(self));
4019 }
Tim Petersa9bc1682003-01-11 03:39:11 +00004020 if (baserepr == NULL || ! HASTZINFO(self))
4021 return baserepr;
Tim Peters2a799bf2002-12-16 20:18:38 +00004022 return append_keyword_tzinfo(baserepr, self->tzinfo);
4023}
4024
Tim Petersa9bc1682003-01-11 03:39:11 +00004025static PyObject *
4026datetime_str(PyDateTime_DateTime *self)
4027{
4028 return PyObject_CallMethod((PyObject *)self, "isoformat", "(s)", " ");
4029}
Tim Peters2a799bf2002-12-16 20:18:38 +00004030
4031static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004032datetime_isoformat(PyDateTime_DateTime *self, PyObject *args, PyObject *kw)
Tim Peters2a799bf2002-12-16 20:18:38 +00004033{
Walter Dörwaldbc1f8862007-06-20 11:02:38 +00004034 int sep = 'T';
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00004035 static char *keywords[] = {"sep", NULL};
Tim Petersa9bc1682003-01-11 03:39:11 +00004036 char buffer[100];
Tim Petersa9bc1682003-01-11 03:39:11 +00004037 PyObject *result;
Walter Dörwaldbafa1372007-05-31 17:50:48 +00004038 int us = DATE_GET_MICROSECOND(self);
Tim Peters2a799bf2002-12-16 20:18:38 +00004039
Walter Dörwaldd0941302007-07-01 21:58:22 +00004040 if (!PyArg_ParseTupleAndKeywords(args, kw, "|C:isoformat", keywords, &sep))
Tim Petersa9bc1682003-01-11 03:39:11 +00004041 return NULL;
Walter Dörwaldbafa1372007-05-31 17:50:48 +00004042 if (us)
4043 result = PyUnicode_FromFormat("%04d-%02d-%02d%c%02d:%02d:%02d.%06d",
4044 GET_YEAR(self), GET_MONTH(self),
4045 GET_DAY(self), (int)sep,
4046 DATE_GET_HOUR(self), DATE_GET_MINUTE(self),
4047 DATE_GET_SECOND(self), us);
4048 else
4049 result = PyUnicode_FromFormat("%04d-%02d-%02d%c%02d:%02d:%02d",
4050 GET_YEAR(self), GET_MONTH(self),
4051 GET_DAY(self), (int)sep,
4052 DATE_GET_HOUR(self), DATE_GET_MINUTE(self),
4053 DATE_GET_SECOND(self));
4054
4055 if (!result || !HASTZINFO(self))
Tim Peters2a799bf2002-12-16 20:18:38 +00004056 return result;
4057
4058 /* We need to append the UTC offset. */
Tim Petersa9bc1682003-01-11 03:39:11 +00004059 if (format_utcoffset(buffer, sizeof(buffer), ":", self->tzinfo,
Tim Peters2a799bf2002-12-16 20:18:38 +00004060 (PyObject *)self) < 0) {
4061 Py_DECREF(result);
4062 return NULL;
4063 }
Walter Dörwaldbafa1372007-05-31 17:50:48 +00004064 PyUnicode_AppendAndDel(&result, PyUnicode_FromString(buffer));
Tim Peters2a799bf2002-12-16 20:18:38 +00004065 return result;
4066}
4067
Tim Petersa9bc1682003-01-11 03:39:11 +00004068static PyObject *
4069datetime_ctime(PyDateTime_DateTime *self)
4070{
4071 return format_ctime((PyDateTime_Date *)self,
4072 DATE_GET_HOUR(self),
4073 DATE_GET_MINUTE(self),
4074 DATE_GET_SECOND(self));
4075}
4076
Tim Peters2a799bf2002-12-16 20:18:38 +00004077/* Miscellaneous methods. */
4078
Tim Petersa9bc1682003-01-11 03:39:11 +00004079static PyObject *
Guido van Rossum19960592006-08-24 17:29:38 +00004080datetime_richcompare(PyObject *self, PyObject *other, int op)
Tim Petersa9bc1682003-01-11 03:39:11 +00004081{
4082 int diff;
4083 naivety n1, n2;
4084 int offset1, offset2;
4085
4086 if (! PyDateTime_Check(other)) {
Guido van Rossum19960592006-08-24 17:29:38 +00004087 if (PyDate_Check(other)) {
4088 /* Prevent invocation of date_richcompare. We want to
4089 return NotImplemented here to give the other object
4090 a chance. But since DateTime is a subclass of
4091 Date, if the other object is a Date, it would
4092 compute an ordering based on the date part alone,
4093 and we don't want that. So force unequal or
4094 uncomparable here in that case. */
4095 if (op == Py_EQ)
4096 Py_RETURN_FALSE;
4097 if (op == Py_NE)
4098 Py_RETURN_TRUE;
4099 return cmperror(self, other);
Tim Peters8d81a012003-01-24 22:36:34 +00004100 }
Guido van Rossum19960592006-08-24 17:29:38 +00004101 Py_INCREF(Py_NotImplemented);
4102 return Py_NotImplemented;
Tim Petersa9bc1682003-01-11 03:39:11 +00004103 }
4104
Guido van Rossum19960592006-08-24 17:29:38 +00004105 if (classify_two_utcoffsets(self, &offset1, &n1, self,
4106 other, &offset2, &n2, other) < 0)
Tim Petersa9bc1682003-01-11 03:39:11 +00004107 return NULL;
4108 assert(n1 != OFFSET_UNKNOWN && n2 != OFFSET_UNKNOWN);
4109 /* If they're both naive, or both aware and have the same offsets,
4110 * we get off cheap. Note that if they're both naive, offset1 ==
4111 * offset2 == 0 at this point.
4112 */
4113 if (n1 == n2 && offset1 == offset2) {
Guido van Rossum19960592006-08-24 17:29:38 +00004114 diff = memcmp(((PyDateTime_DateTime *)self)->data,
4115 ((PyDateTime_DateTime *)other)->data,
Tim Petersa9bc1682003-01-11 03:39:11 +00004116 _PyDateTime_DATETIME_DATASIZE);
4117 return diff_to_bool(diff, op);
4118 }
4119
4120 if (n1 == OFFSET_AWARE && n2 == OFFSET_AWARE) {
4121 PyDateTime_Delta *delta;
4122
4123 assert(offset1 != offset2); /* else last "if" handled it */
4124 delta = (PyDateTime_Delta *)datetime_subtract((PyObject *)self,
4125 other);
4126 if (delta == NULL)
4127 return NULL;
4128 diff = GET_TD_DAYS(delta);
4129 if (diff == 0)
4130 diff = GET_TD_SECONDS(delta) |
4131 GET_TD_MICROSECONDS(delta);
4132 Py_DECREF(delta);
4133 return diff_to_bool(diff, op);
4134 }
4135
4136 assert(n1 != n2);
4137 PyErr_SetString(PyExc_TypeError,
4138 "can't compare offset-naive and "
4139 "offset-aware datetimes");
4140 return NULL;
4141}
4142
4143static long
4144datetime_hash(PyDateTime_DateTime *self)
4145{
4146 if (self->hashcode == -1) {
4147 naivety n;
4148 int offset;
4149 PyObject *temp;
4150
4151 n = classify_utcoffset((PyObject *)self, (PyObject *)self,
4152 &offset);
4153 assert(n != OFFSET_UNKNOWN);
4154 if (n == OFFSET_ERROR)
4155 return -1;
4156
4157 /* Reduce this to a hash of another object. */
4158 if (n == OFFSET_NAIVE)
4159 temp = PyString_FromStringAndSize(
4160 (char *)self->data,
4161 _PyDateTime_DATETIME_DATASIZE);
4162 else {
4163 int days;
4164 int seconds;
4165
4166 assert(n == OFFSET_AWARE);
4167 assert(HASTZINFO(self));
4168 days = ymd_to_ord(GET_YEAR(self),
4169 GET_MONTH(self),
4170 GET_DAY(self));
4171 seconds = DATE_GET_HOUR(self) * 3600 +
4172 (DATE_GET_MINUTE(self) - offset) * 60 +
4173 DATE_GET_SECOND(self);
4174 temp = new_delta(days,
4175 seconds,
4176 DATE_GET_MICROSECOND(self),
4177 1);
4178 }
4179 if (temp != NULL) {
4180 self->hashcode = PyObject_Hash(temp);
4181 Py_DECREF(temp);
4182 }
4183 }
4184 return self->hashcode;
4185}
Tim Peters2a799bf2002-12-16 20:18:38 +00004186
4187static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004188datetime_replace(PyDateTime_DateTime *self, PyObject *args, PyObject *kw)
Tim Peters12bf3392002-12-24 05:41:27 +00004189{
4190 PyObject *clone;
4191 PyObject *tuple;
4192 int y = GET_YEAR(self);
4193 int m = GET_MONTH(self);
4194 int d = GET_DAY(self);
4195 int hh = DATE_GET_HOUR(self);
4196 int mm = DATE_GET_MINUTE(self);
4197 int ss = DATE_GET_SECOND(self);
4198 int us = DATE_GET_MICROSECOND(self);
Tim Petersa9bc1682003-01-11 03:39:11 +00004199 PyObject *tzinfo = HASTZINFO(self) ? self->tzinfo : Py_None;
Tim Peters12bf3392002-12-24 05:41:27 +00004200
4201 if (! PyArg_ParseTupleAndKeywords(args, kw, "|iiiiiiiO:replace",
Tim Petersa9bc1682003-01-11 03:39:11 +00004202 datetime_kws,
Tim Peters12bf3392002-12-24 05:41:27 +00004203 &y, &m, &d, &hh, &mm, &ss, &us,
4204 &tzinfo))
4205 return NULL;
4206 tuple = Py_BuildValue("iiiiiiiO", y, m, d, hh, mm, ss, us, tzinfo);
4207 if (tuple == NULL)
4208 return NULL;
Tim Petersa9bc1682003-01-11 03:39:11 +00004209 clone = datetime_new(self->ob_type, tuple, NULL);
Tim Peters12bf3392002-12-24 05:41:27 +00004210 Py_DECREF(tuple);
4211 return clone;
4212}
4213
4214static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004215datetime_astimezone(PyDateTime_DateTime *self, PyObject *args, PyObject *kw)
Tim Peters80475bb2002-12-25 07:40:55 +00004216{
Tim Peters52dcce22003-01-23 16:36:11 +00004217 int y, m, d, hh, mm, ss, us;
Tim Peters521fc152002-12-31 17:36:56 +00004218 PyObject *result;
Tim Peters52dcce22003-01-23 16:36:11 +00004219 int offset, none;
Tim Peters521fc152002-12-31 17:36:56 +00004220
Tim Peters80475bb2002-12-25 07:40:55 +00004221 PyObject *tzinfo;
Martin v. Löwis02cbf4a2006-02-27 17:20:04 +00004222 static char *keywords[] = {"tz", NULL};
Tim Peters80475bb2002-12-25 07:40:55 +00004223
Tim Peters52dcce22003-01-23 16:36:11 +00004224 if (! PyArg_ParseTupleAndKeywords(args, kw, "O!:astimezone", keywords,
4225 &PyDateTime_TZInfoType, &tzinfo))
Tim Peters80475bb2002-12-25 07:40:55 +00004226 return NULL;
4227
Tim Peters52dcce22003-01-23 16:36:11 +00004228 if (!HASTZINFO(self) || self->tzinfo == Py_None)
4229 goto NeedAware;
Tim Peters521fc152002-12-31 17:36:56 +00004230
Tim Peters52dcce22003-01-23 16:36:11 +00004231 /* Conversion to self's own time zone is a NOP. */
4232 if (self->tzinfo == tzinfo) {
4233 Py_INCREF(self);
4234 return (PyObject *)self;
Tim Peters710fb152003-01-02 19:35:54 +00004235 }
Tim Peters521fc152002-12-31 17:36:56 +00004236
Tim Peters52dcce22003-01-23 16:36:11 +00004237 /* Convert self to UTC. */
4238 offset = call_utcoffset(self->tzinfo, (PyObject *)self, &none);
4239 if (offset == -1 && PyErr_Occurred())
4240 return NULL;
4241 if (none)
4242 goto NeedAware;
Tim Petersf3615152003-01-01 21:51:37 +00004243
Tim Peters52dcce22003-01-23 16:36:11 +00004244 y = GET_YEAR(self);
4245 m = GET_MONTH(self);
4246 d = GET_DAY(self);
4247 hh = DATE_GET_HOUR(self);
4248 mm = DATE_GET_MINUTE(self);
4249 ss = DATE_GET_SECOND(self);
4250 us = DATE_GET_MICROSECOND(self);
4251
4252 mm -= offset;
Tim Petersf3615152003-01-01 21:51:37 +00004253 if ((mm < 0 || mm >= 60) &&
4254 normalize_datetime(&y, &m, &d, &hh, &mm, &ss, &us) < 0)
Tim Peters52dcce22003-01-23 16:36:11 +00004255 return NULL;
4256
4257 /* Attach new tzinfo and let fromutc() do the rest. */
4258 result = new_datetime(y, m, d, hh, mm, ss, us, tzinfo);
4259 if (result != NULL) {
4260 PyObject *temp = result;
4261
4262 result = PyObject_CallMethod(tzinfo, "fromutc", "O", temp);
4263 Py_DECREF(temp);
4264 }
Tim Petersadf64202003-01-04 06:03:15 +00004265 return result;
Tim Peters521fc152002-12-31 17:36:56 +00004266
Tim Peters52dcce22003-01-23 16:36:11 +00004267NeedAware:
4268 PyErr_SetString(PyExc_ValueError, "astimezone() cannot be applied to "
4269 "a naive datetime");
Tim Peters521fc152002-12-31 17:36:56 +00004270 return NULL;
Tim Peters80475bb2002-12-25 07:40:55 +00004271}
4272
4273static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004274datetime_timetuple(PyDateTime_DateTime *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00004275{
4276 int dstflag = -1;
4277
Tim Petersa9bc1682003-01-11 03:39:11 +00004278 if (HASTZINFO(self) && self->tzinfo != Py_None) {
Tim Peters2a799bf2002-12-16 20:18:38 +00004279 int none;
4280
4281 dstflag = call_dst(self->tzinfo, (PyObject *)self, &none);
4282 if (dstflag == -1 && PyErr_Occurred())
4283 return NULL;
4284
4285 if (none)
4286 dstflag = -1;
4287 else if (dstflag != 0)
4288 dstflag = 1;
4289
4290 }
4291 return build_struct_time(GET_YEAR(self),
4292 GET_MONTH(self),
4293 GET_DAY(self),
4294 DATE_GET_HOUR(self),
4295 DATE_GET_MINUTE(self),
4296 DATE_GET_SECOND(self),
4297 dstflag);
4298}
4299
4300static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004301datetime_getdate(PyDateTime_DateTime *self)
4302{
4303 return new_date(GET_YEAR(self),
4304 GET_MONTH(self),
4305 GET_DAY(self));
4306}
4307
4308static PyObject *
4309datetime_gettime(PyDateTime_DateTime *self)
4310{
4311 return new_time(DATE_GET_HOUR(self),
4312 DATE_GET_MINUTE(self),
4313 DATE_GET_SECOND(self),
4314 DATE_GET_MICROSECOND(self),
4315 Py_None);
4316}
4317
4318static PyObject *
4319datetime_gettimetz(PyDateTime_DateTime *self)
4320{
4321 return new_time(DATE_GET_HOUR(self),
4322 DATE_GET_MINUTE(self),
4323 DATE_GET_SECOND(self),
4324 DATE_GET_MICROSECOND(self),
4325 HASTZINFO(self) ? self->tzinfo : Py_None);
4326}
4327
4328static PyObject *
4329datetime_utctimetuple(PyDateTime_DateTime *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00004330{
4331 int y = GET_YEAR(self);
4332 int m = GET_MONTH(self);
4333 int d = GET_DAY(self);
4334 int hh = DATE_GET_HOUR(self);
4335 int mm = DATE_GET_MINUTE(self);
4336 int ss = DATE_GET_SECOND(self);
4337 int us = 0; /* microseconds are ignored in a timetuple */
4338 int offset = 0;
4339
Tim Petersa9bc1682003-01-11 03:39:11 +00004340 if (HASTZINFO(self) && self->tzinfo != Py_None) {
Tim Peters2a799bf2002-12-16 20:18:38 +00004341 int none;
4342
4343 offset = call_utcoffset(self->tzinfo, (PyObject *)self, &none);
4344 if (offset == -1 && PyErr_Occurred())
4345 return NULL;
4346 }
4347 /* Even if offset is 0, don't call timetuple() -- tm_isdst should be
4348 * 0 in a UTC timetuple regardless of what dst() says.
4349 */
4350 if (offset) {
4351 /* Subtract offset minutes & normalize. */
4352 int stat;
4353
4354 mm -= offset;
4355 stat = normalize_datetime(&y, &m, &d, &hh, &mm, &ss, &us);
4356 if (stat < 0) {
4357 /* At the edges, it's possible we overflowed
4358 * beyond MINYEAR or MAXYEAR.
4359 */
4360 if (PyErr_ExceptionMatches(PyExc_OverflowError))
4361 PyErr_Clear();
4362 else
4363 return NULL;
4364 }
4365 }
4366 return build_struct_time(y, m, d, hh, mm, ss, 0);
4367}
4368
Tim Peters371935f2003-02-01 01:52:50 +00004369/* Pickle support, a simple use of __reduce__. */
Tim Peters33e0f382003-01-10 02:05:14 +00004370
Tim Petersa9bc1682003-01-11 03:39:11 +00004371/* Let basestate be the non-tzinfo data string.
Tim Peters2a799bf2002-12-16 20:18:38 +00004372 * If tzinfo is None, this returns (basestate,), else (basestate, tzinfo).
4373 * So it's a tuple in any (non-error) case.
Tim Petersb57f8f02003-02-01 02:54:15 +00004374 * __getstate__ isn't exposed.
Tim Peters2a799bf2002-12-16 20:18:38 +00004375 */
4376static PyObject *
Tim Petersa9bc1682003-01-11 03:39:11 +00004377datetime_getstate(PyDateTime_DateTime *self)
Tim Peters2a799bf2002-12-16 20:18:38 +00004378{
4379 PyObject *basestate;
4380 PyObject *result = NULL;
4381
Martin v. Löwis10a60b32007-07-18 02:28:27 +00004382 basestate = PyBytes_FromStringAndSize((char *)self->data,
4383 _PyDateTime_DATETIME_DATASIZE);
Tim Peters2a799bf2002-12-16 20:18:38 +00004384 if (basestate != NULL) {
Tim Petersa9bc1682003-01-11 03:39:11 +00004385 if (! HASTZINFO(self) || self->tzinfo == Py_None)
Raymond Hettinger8ae46892003-10-12 19:09:37 +00004386 result = PyTuple_Pack(1, basestate);
Tim Peters2a799bf2002-12-16 20:18:38 +00004387 else
Raymond Hettinger8ae46892003-10-12 19:09:37 +00004388 result = PyTuple_Pack(2, basestate, self->tzinfo);
Tim Peters2a799bf2002-12-16 20:18:38 +00004389 Py_DECREF(basestate);
4390 }
4391 return result;
4392}
4393
4394static PyObject *
Guido van Rossum177e41a2003-01-30 22:06:23 +00004395datetime_reduce(PyDateTime_DateTime *self, PyObject *arg)
Tim Peters2a799bf2002-12-16 20:18:38 +00004396{
Guido van Rossum177e41a2003-01-30 22:06:23 +00004397 return Py_BuildValue("(ON)", self->ob_type, datetime_getstate(self));
Tim Peters2a799bf2002-12-16 20:18:38 +00004398}
4399
Tim Petersa9bc1682003-01-11 03:39:11 +00004400static PyMethodDef datetime_methods[] = {
Guido van Rossum177e41a2003-01-30 22:06:23 +00004401
Tim Peters2a799bf2002-12-16 20:18:38 +00004402 /* Class methods: */
Tim Peters2a799bf2002-12-16 20:18:38 +00004403
Tim Petersa9bc1682003-01-11 03:39:11 +00004404 {"now", (PyCFunction)datetime_now,
Guido van Rossumd59da4b2007-05-22 18:11:13 +00004405 METH_VARARGS | METH_KEYWORDS | METH_CLASS,
Neal Norwitz2fbe5372003-01-23 21:09:05 +00004406 PyDoc_STR("[tz] -> new datetime with tz's local day and time.")},
Tim Peters2a799bf2002-12-16 20:18:38 +00004407
Tim Petersa9bc1682003-01-11 03:39:11 +00004408 {"utcnow", (PyCFunction)datetime_utcnow,
4409 METH_NOARGS | METH_CLASS,
4410 PyDoc_STR("Return a new datetime representing UTC day and time.")},
4411
4412 {"fromtimestamp", (PyCFunction)datetime_fromtimestamp,
Guido van Rossumd59da4b2007-05-22 18:11:13 +00004413 METH_VARARGS | METH_KEYWORDS | METH_CLASS,
Tim Peters2a44a8d2003-01-23 20:53:10 +00004414 PyDoc_STR("timestamp[, tz] -> tz's local time from POSIX timestamp.")},
Tim Peters2a799bf2002-12-16 20:18:38 +00004415
Tim Petersa9bc1682003-01-11 03:39:11 +00004416 {"utcfromtimestamp", (PyCFunction)datetime_utcfromtimestamp,
4417 METH_VARARGS | METH_CLASS,
4418 PyDoc_STR("timestamp -> UTC datetime from a POSIX timestamp "
4419 "(like time.time()).")},
4420
Skip Montanaro0af3ade2005-01-13 04:12:31 +00004421 {"strptime", (PyCFunction)datetime_strptime,
4422 METH_VARARGS | METH_CLASS,
4423 PyDoc_STR("string, format -> new datetime parsed from a string "
4424 "(like time.strptime()).")},
4425
Tim Petersa9bc1682003-01-11 03:39:11 +00004426 {"combine", (PyCFunction)datetime_combine,
4427 METH_VARARGS | METH_KEYWORDS | METH_CLASS,
4428 PyDoc_STR("date, time -> datetime with same date and time fields")},
4429
Tim Peters2a799bf2002-12-16 20:18:38 +00004430 /* Instance methods: */
Guido van Rossum177e41a2003-01-30 22:06:23 +00004431
Tim Petersa9bc1682003-01-11 03:39:11 +00004432 {"date", (PyCFunction)datetime_getdate, METH_NOARGS,
4433 PyDoc_STR("Return date object with same year, month and day.")},
4434
4435 {"time", (PyCFunction)datetime_gettime, METH_NOARGS,
4436 PyDoc_STR("Return time object with same time but with tzinfo=None.")},
4437
4438 {"timetz", (PyCFunction)datetime_gettimetz, METH_NOARGS,
4439 PyDoc_STR("Return time object with same time and tzinfo.")},
4440
4441 {"ctime", (PyCFunction)datetime_ctime, METH_NOARGS,
4442 PyDoc_STR("Return ctime() style string.")},
4443
4444 {"timetuple", (PyCFunction)datetime_timetuple, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004445 PyDoc_STR("Return time tuple, compatible with time.localtime().")},
4446
Tim Petersa9bc1682003-01-11 03:39:11 +00004447 {"utctimetuple", (PyCFunction)datetime_utctimetuple, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004448 PyDoc_STR("Return UTC time tuple, compatible with time.localtime().")},
4449
Guido van Rossumd59da4b2007-05-22 18:11:13 +00004450 {"isoformat", (PyCFunction)datetime_isoformat, METH_VARARGS | METH_KEYWORDS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004451 PyDoc_STR("[sep] -> string in ISO 8601 format, "
4452 "YYYY-MM-DDTHH:MM:SS[.mmmmmm][+HH:MM].\n\n"
4453 "sep is used to separate the year from the time, and "
4454 "defaults to 'T'.")},
4455
Tim Petersa9bc1682003-01-11 03:39:11 +00004456 {"utcoffset", (PyCFunction)datetime_utcoffset, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004457 PyDoc_STR("Return self.tzinfo.utcoffset(self).")},
4458
Tim Petersa9bc1682003-01-11 03:39:11 +00004459 {"tzname", (PyCFunction)datetime_tzname, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004460 PyDoc_STR("Return self.tzinfo.tzname(self).")},
4461
Tim Petersa9bc1682003-01-11 03:39:11 +00004462 {"dst", (PyCFunction)datetime_dst, METH_NOARGS,
Tim Peters2a799bf2002-12-16 20:18:38 +00004463 PyDoc_STR("Return self.tzinfo.dst(self).")},
4464
Guido van Rossumd59da4b2007-05-22 18:11:13 +00004465 {"replace", (PyCFunction)datetime_replace, METH_VARARGS | METH_KEYWORDS,
Tim Petersa9bc1682003-01-11 03:39:11 +00004466 PyDoc_STR("Return datetime with new specified fields.")},
Tim Peters12bf3392002-12-24 05:41:27 +00004467
Guido van Rossumd59da4b2007-05-22 18:11:13 +00004468 {"astimezone", (PyCFunction)datetime_astimezone, METH_VARARGS | METH_KEYWORDS,
Tim Peters80475bb2002-12-25 07:40:55 +00004469 PyDoc_STR("tz -> convert to local time in new timezone tz\n")},
4470
Guido van Rossum177e41a2003-01-30 22:06:23 +00004471 {"__reduce__", (PyCFunction)datetime_reduce, METH_NOARGS,
4472 PyDoc_STR("__reduce__() -> (cls, state)")},
4473
Tim Peters2a799bf2002-12-16 20:18:38 +00004474 {NULL, NULL}
4475};
4476
Tim Petersa9bc1682003-01-11 03:39:11 +00004477static char datetime_doc[] =
Raymond Hettinger3a4231d2004-12-19 20:13:24 +00004478PyDoc_STR("datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])\n\
4479\n\
4480The year, month and day arguments are required. tzinfo may be None, or an\n\
4481instance of a tzinfo subclass. The remaining arguments may be ints or longs.\n");
Tim Peters2a799bf2002-12-16 20:18:38 +00004482
Tim Petersa9bc1682003-01-11 03:39:11 +00004483static PyNumberMethods datetime_as_number = {
4484 datetime_add, /* nb_add */
4485 datetime_subtract, /* nb_subtract */
Tim Peters2a799bf2002-12-16 20:18:38 +00004486 0, /* nb_multiply */
Tim Peters2a799bf2002-12-16 20:18:38 +00004487 0, /* nb_remainder */
4488 0, /* nb_divmod */
4489 0, /* nb_power */
4490 0, /* nb_negative */
4491 0, /* nb_positive */
4492 0, /* nb_absolute */
Jack Diederich4dafcc42006-11-28 19:15:13 +00004493 0, /* nb_bool */
Tim Peters2a799bf2002-12-16 20:18:38 +00004494};
4495
Neal Norwitz227b5332006-03-22 09:28:35 +00004496static PyTypeObject PyDateTime_DateTimeType = {
Tim Peters2a799bf2002-12-16 20:18:38 +00004497 PyObject_HEAD_INIT(NULL)
4498 0, /* ob_size */
Tim Peters0bf60bd2003-01-08 20:40:01 +00004499 "datetime.datetime", /* tp_name */
Tim Petersa9bc1682003-01-11 03:39:11 +00004500 sizeof(PyDateTime_DateTime), /* tp_basicsize */
Tim Peters2a799bf2002-12-16 20:18:38 +00004501 0, /* tp_itemsize */
Tim Petersa9bc1682003-01-11 03:39:11 +00004502 (destructor)datetime_dealloc, /* tp_dealloc */
Tim Peters2a799bf2002-12-16 20:18:38 +00004503 0, /* tp_print */
4504 0, /* tp_getattr */
4505 0, /* tp_setattr */
4506 0, /* tp_compare */
Tim Petersa9bc1682003-01-11 03:39:11 +00004507 (reprfunc)datetime_repr, /* tp_repr */
4508 &datetime_as_number, /* tp_as_number */
Tim Peters2a799bf2002-12-16 20:18:38 +00004509 0, /* tp_as_sequence */
4510 0, /* tp_as_mapping */
Tim Petersa9bc1682003-01-11 03:39:11 +00004511 (hashfunc)datetime_hash, /* tp_hash */
Tim Peters2a799bf2002-12-16 20:18:38 +00004512 0, /* tp_call */
Tim Petersa9bc1682003-01-11 03:39:11 +00004513 (reprfunc)datetime_str, /* tp_str */
Tim Peters2a799bf2002-12-16 20:18:38 +00004514 PyObject_GenericGetAttr, /* tp_getattro */
4515 0, /* tp_setattro */
4516 0, /* tp_as_buffer */
Guido van Rossum3cf5b1e2006-07-27 21:53:35 +00004517 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */
Tim Petersa9bc1682003-01-11 03:39:11 +00004518 datetime_doc, /* tp_doc */
Tim Peters2a799bf2002-12-16 20:18:38 +00004519 0, /* tp_traverse */
4520 0, /* tp_clear */
Guido van Rossum19960592006-08-24 17:29:38 +00004521 datetime_richcompare, /* tp_richcompare */
Tim Peters2a799bf2002-12-16 20:18:38 +00004522 0, /* tp_weaklistoffset */
4523 0, /* tp_iter */
4524 0, /* tp_iternext */
Tim Petersa9bc1682003-01-11 03:39:11 +00004525 datetime_methods, /* tp_methods */
Tim Peters2a799bf2002-12-16 20:18:38 +00004526 0, /* tp_members */
Tim Petersa9bc1682003-01-11 03:39:11 +00004527 datetime_getset, /* tp_getset */
4528 &PyDateTime_DateType, /* tp_base */
Tim Peters2a799bf2002-12-16 20:18:38 +00004529 0, /* tp_dict */
4530 0, /* tp_descr_get */
4531 0, /* tp_descr_set */
4532 0, /* tp_dictoffset */
4533 0, /* tp_init */
Tim Petersa98924a2003-05-17 05:55:19 +00004534 datetime_alloc, /* tp_alloc */
Tim Petersa9bc1682003-01-11 03:39:11 +00004535 datetime_new, /* tp_new */
Tim Peters4c530132003-05-16 22:44:06 +00004536 0, /* tp_free */
Tim Peters2a799bf2002-12-16 20:18:38 +00004537};
4538
4539/* ---------------------------------------------------------------------------
4540 * Module methods and initialization.
4541 */
4542
4543static PyMethodDef module_methods[] = {
Tim Peters2a799bf2002-12-16 20:18:38 +00004544 {NULL, NULL}
4545};
4546
Tim Peters9ddf40b2004-06-20 22:41:32 +00004547/* C API. Clients get at this via PyDateTime_IMPORT, defined in
4548 * datetime.h.
4549 */
4550static PyDateTime_CAPI CAPI = {
4551 &PyDateTime_DateType,
4552 &PyDateTime_DateTimeType,
4553 &PyDateTime_TimeType,
4554 &PyDateTime_DeltaType,
4555 &PyDateTime_TZInfoType,
4556 new_date_ex,
4557 new_datetime_ex,
4558 new_time_ex,
4559 new_delta_ex,
4560 datetime_fromtimestamp,
4561 date_fromtimestamp
4562};
4563
4564
Tim Peters2a799bf2002-12-16 20:18:38 +00004565PyMODINIT_FUNC
4566initdatetime(void)
4567{
4568 PyObject *m; /* a module object */
4569 PyObject *d; /* its dict */
4570 PyObject *x;
4571
Tim Peters2a799bf2002-12-16 20:18:38 +00004572 m = Py_InitModule3("datetime", module_methods,
4573 "Fast implementation of the datetime type.");
Neal Norwitz1ac754f2006-01-19 06:09:39 +00004574 if (m == NULL)
4575 return;
Tim Peters2a799bf2002-12-16 20:18:38 +00004576
4577 if (PyType_Ready(&PyDateTime_DateType) < 0)
4578 return;
4579 if (PyType_Ready(&PyDateTime_DateTimeType) < 0)
4580 return;
4581 if (PyType_Ready(&PyDateTime_DeltaType) < 0)
4582 return;
4583 if (PyType_Ready(&PyDateTime_TimeType) < 0)
4584 return;
4585 if (PyType_Ready(&PyDateTime_TZInfoType) < 0)
4586 return;
Tim Peters2a799bf2002-12-16 20:18:38 +00004587
Tim Peters2a799bf2002-12-16 20:18:38 +00004588 /* timedelta values */
4589 d = PyDateTime_DeltaType.tp_dict;
4590
Tim Peters2a799bf2002-12-16 20:18:38 +00004591 x = new_delta(0, 0, 1, 0);
4592 if (x == NULL || PyDict_SetItemString(d, "resolution", x) < 0)
4593 return;
4594 Py_DECREF(x);
4595
4596 x = new_delta(-MAX_DELTA_DAYS, 0, 0, 0);
4597 if (x == NULL || PyDict_SetItemString(d, "min", x) < 0)
4598 return;
4599 Py_DECREF(x);
4600
4601 x = new_delta(MAX_DELTA_DAYS, 24*3600-1, 1000000-1, 0);
4602 if (x == NULL || PyDict_SetItemString(d, "max", x) < 0)
4603 return;
4604 Py_DECREF(x);
4605
4606 /* date values */
4607 d = PyDateTime_DateType.tp_dict;
4608
4609 x = new_date(1, 1, 1);
4610 if (x == NULL || PyDict_SetItemString(d, "min", x) < 0)
4611 return;
4612 Py_DECREF(x);
4613
4614 x = new_date(MAXYEAR, 12, 31);
4615 if (x == NULL || PyDict_SetItemString(d, "max", x) < 0)
4616 return;
4617 Py_DECREF(x);
4618
4619 x = new_delta(1, 0, 0, 0);
4620 if (x == NULL || PyDict_SetItemString(d, "resolution", x) < 0)
4621 return;
4622 Py_DECREF(x);
4623
Tim Peters37f39822003-01-10 03:49:02 +00004624 /* time values */
4625 d = PyDateTime_TimeType.tp_dict;
Tim Peters2a799bf2002-12-16 20:18:38 +00004626
Tim Peters37f39822003-01-10 03:49:02 +00004627 x = new_time(0, 0, 0, 0, Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00004628 if (x == NULL || PyDict_SetItemString(d, "min", x) < 0)
4629 return;
4630 Py_DECREF(x);
4631
Tim Peters37f39822003-01-10 03:49:02 +00004632 x = new_time(23, 59, 59, 999999, Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00004633 if (x == NULL || PyDict_SetItemString(d, "max", x) < 0)
4634 return;
4635 Py_DECREF(x);
4636
4637 x = new_delta(0, 0, 1, 0);
4638 if (x == NULL || PyDict_SetItemString(d, "resolution", x) < 0)
4639 return;
4640 Py_DECREF(x);
4641
Tim Petersa9bc1682003-01-11 03:39:11 +00004642 /* datetime values */
4643 d = PyDateTime_DateTimeType.tp_dict;
Tim Peters2a799bf2002-12-16 20:18:38 +00004644
Tim Petersa9bc1682003-01-11 03:39:11 +00004645 x = new_datetime(1, 1, 1, 0, 0, 0, 0, Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00004646 if (x == NULL || PyDict_SetItemString(d, "min", x) < 0)
4647 return;
4648 Py_DECREF(x);
4649
Tim Petersa9bc1682003-01-11 03:39:11 +00004650 x = new_datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999, Py_None);
Tim Peters2a799bf2002-12-16 20:18:38 +00004651 if (x == NULL || PyDict_SetItemString(d, "max", x) < 0)
4652 return;
4653 Py_DECREF(x);
4654
4655 x = new_delta(0, 0, 1, 0);
4656 if (x == NULL || PyDict_SetItemString(d, "resolution", x) < 0)
4657 return;
4658 Py_DECREF(x);
4659
Tim Peters2a799bf2002-12-16 20:18:38 +00004660 /* module initialization */
4661 PyModule_AddIntConstant(m, "MINYEAR", MINYEAR);
4662 PyModule_AddIntConstant(m, "MAXYEAR", MAXYEAR);
4663
4664 Py_INCREF(&PyDateTime_DateType);
4665 PyModule_AddObject(m, "date", (PyObject *) &PyDateTime_DateType);
4666
Tim Petersa9bc1682003-01-11 03:39:11 +00004667 Py_INCREF(&PyDateTime_DateTimeType);
4668 PyModule_AddObject(m, "datetime",
4669 (PyObject *)&PyDateTime_DateTimeType);
4670
4671 Py_INCREF(&PyDateTime_TimeType);
4672 PyModule_AddObject(m, "time", (PyObject *) &PyDateTime_TimeType);
4673
Tim Peters2a799bf2002-12-16 20:18:38 +00004674 Py_INCREF(&PyDateTime_DeltaType);
4675 PyModule_AddObject(m, "timedelta", (PyObject *) &PyDateTime_DeltaType);
4676
Tim Peters2a799bf2002-12-16 20:18:38 +00004677 Py_INCREF(&PyDateTime_TZInfoType);
4678 PyModule_AddObject(m, "tzinfo", (PyObject *) &PyDateTime_TZInfoType);
4679
Tim Peters9ddf40b2004-06-20 22:41:32 +00004680 x = PyCObject_FromVoidPtrAndDesc(&CAPI, (void*) DATETIME_API_MAGIC,
4681 NULL);
4682 if (x == NULL)
4683 return;
4684 PyModule_AddObject(m, "datetime_CAPI", x);
4685
Tim Peters2a799bf2002-12-16 20:18:38 +00004686 /* A 4-year cycle has an extra leap day over what we'd get from
4687 * pasting together 4 single years.
4688 */
4689 assert(DI4Y == 4 * 365 + 1);
4690 assert(DI4Y == days_before_year(4+1));
4691
4692 /* Similarly, a 400-year cycle has an extra leap day over what we'd
4693 * get from pasting together 4 100-year cycles.
4694 */
4695 assert(DI400Y == 4 * DI100Y + 1);
4696 assert(DI400Y == days_before_year(400+1));
4697
4698 /* OTOH, a 100-year cycle has one fewer leap day than we'd get from
4699 * pasting together 25 4-year cycles.
4700 */
4701 assert(DI100Y == 25 * DI4Y - 1);
4702 assert(DI100Y == days_before_year(100+1));
4703
4704 us_per_us = PyInt_FromLong(1);
4705 us_per_ms = PyInt_FromLong(1000);
4706 us_per_second = PyInt_FromLong(1000000);
4707 us_per_minute = PyInt_FromLong(60000000);
4708 seconds_per_day = PyInt_FromLong(24 * 3600);
4709 if (us_per_us == NULL || us_per_ms == NULL || us_per_second == NULL ||
4710 us_per_minute == NULL || seconds_per_day == NULL)
4711 return;
4712
4713 /* The rest are too big for 32-bit ints, but even
4714 * us_per_week fits in 40 bits, so doubles should be exact.
4715 */
4716 us_per_hour = PyLong_FromDouble(3600000000.0);
4717 us_per_day = PyLong_FromDouble(86400000000.0);
4718 us_per_week = PyLong_FromDouble(604800000000.0);
4719 if (us_per_hour == NULL || us_per_day == NULL || us_per_week == NULL)
4720 return;
4721}
Tim Petersf3615152003-01-01 21:51:37 +00004722
4723/* ---------------------------------------------------------------------------
Tim Petersa9bc1682003-01-11 03:39:11 +00004724Some time zone algebra. For a datetime x, let
Tim Petersf3615152003-01-01 21:51:37 +00004725 x.n = x stripped of its timezone -- its naive time.
4726 x.o = x.utcoffset(), and assuming that doesn't raise an exception or
4727 return None
4728 x.d = x.dst(), and assuming that doesn't raise an exception or
4729 return None
4730 x.s = x's standard offset, x.o - x.d
4731
4732Now some derived rules, where k is a duration (timedelta).
4733
47341. x.o = x.s + x.d
4735 This follows from the definition of x.s.
4736
Tim Petersc5dc4da2003-01-02 17:55:03 +000047372. If x and y have the same tzinfo member, x.s = y.s.
Tim Petersf3615152003-01-01 21:51:37 +00004738 This is actually a requirement, an assumption we need to make about
4739 sane tzinfo classes.
4740
47413. The naive UTC time corresponding to x is x.n - x.o.
4742 This is again a requirement for a sane tzinfo class.
4743
47444. (x+k).s = x.s
Tim Peters8bb5ad22003-01-24 02:44:45 +00004745 This follows from #2, and that datimetimetz+timedelta preserves tzinfo.
Tim Petersf3615152003-01-01 21:51:37 +00004746
Tim Petersc5dc4da2003-01-02 17:55:03 +000047475. (x+k).n = x.n + k
Tim Petersf3615152003-01-01 21:51:37 +00004748 Again follows from how arithmetic is defined.
4749
Tim Peters8bb5ad22003-01-24 02:44:45 +00004750Now we can explain tz.fromutc(x). Let's assume it's an interesting case
Tim Petersf3615152003-01-01 21:51:37 +00004751(meaning that the various tzinfo methods exist, and don't blow up or return
4752None when called).
4753
Tim Petersa9bc1682003-01-11 03:39:11 +00004754The function wants to return a datetime y with timezone tz, equivalent to x.
Tim Peters8bb5ad22003-01-24 02:44:45 +00004755x is already in UTC.
Tim Petersf3615152003-01-01 21:51:37 +00004756
4757By #3, we want
4758
Tim Peters8bb5ad22003-01-24 02:44:45 +00004759 y.n - y.o = x.n [1]
Tim Petersf3615152003-01-01 21:51:37 +00004760
4761The algorithm starts by attaching tz to x.n, and calling that y. So
4762x.n = y.n at the start. Then it wants to add a duration k to y, so that [1]
4763becomes true; in effect, we want to solve [2] for k:
4764
Tim Peters8bb5ad22003-01-24 02:44:45 +00004765 (y+k).n - (y+k).o = x.n [2]
Tim Petersf3615152003-01-01 21:51:37 +00004766
4767By #1, this is the same as
4768
Tim Peters8bb5ad22003-01-24 02:44:45 +00004769 (y+k).n - ((y+k).s + (y+k).d) = x.n [3]
Tim Petersf3615152003-01-01 21:51:37 +00004770
4771By #5, (y+k).n = y.n + k, which equals x.n + k because x.n=y.n at the start.
4772Substituting that into [3],
4773
Tim Peters8bb5ad22003-01-24 02:44:45 +00004774 x.n + k - (y+k).s - (y+k).d = x.n; the x.n terms cancel, leaving
4775 k - (y+k).s - (y+k).d = 0; rearranging,
4776 k = (y+k).s - (y+k).d; by #4, (y+k).s == y.s, so
4777 k = y.s - (y+k).d
Tim Petersf3615152003-01-01 21:51:37 +00004778
Tim Peters8bb5ad22003-01-24 02:44:45 +00004779On the RHS, (y+k).d can't be computed directly, but y.s can be, and we
4780approximate k by ignoring the (y+k).d term at first. Note that k can't be
4781very large, since all offset-returning methods return a duration of magnitude
4782less than 24 hours. For that reason, if y is firmly in std time, (y+k).d must
4783be 0, so ignoring it has no consequence then.
Tim Petersf3615152003-01-01 21:51:37 +00004784
4785In any case, the new value is
4786
Tim Peters8bb5ad22003-01-24 02:44:45 +00004787 z = y + y.s [4]
Tim Petersf3615152003-01-01 21:51:37 +00004788
Tim Peters8bb5ad22003-01-24 02:44:45 +00004789It's helpful to step back at look at [4] from a higher level: it's simply
4790mapping from UTC to tz's standard time.
Tim Petersc5dc4da2003-01-02 17:55:03 +00004791
4792At this point, if
4793
Tim Peters8bb5ad22003-01-24 02:44:45 +00004794 z.n - z.o = x.n [5]
Tim Petersc5dc4da2003-01-02 17:55:03 +00004795
4796we have an equivalent time, and are almost done. The insecurity here is
Tim Petersf3615152003-01-01 21:51:37 +00004797at the start of daylight time. Picture US Eastern for concreteness. The wall
4798time jumps from 1:59 to 3:00, and wall hours of the form 2:MM don't make good
Tim Peters8bb5ad22003-01-24 02:44:45 +00004799sense then. The docs ask that an Eastern tzinfo class consider such a time to
4800be EDT (because it's "after 2"), which is a redundant spelling of 1:MM EST
4801on the day DST starts. We want to return the 1:MM EST spelling because that's
Tim Petersf3615152003-01-01 21:51:37 +00004802the only spelling that makes sense on the local wall clock.
4803
Tim Petersc5dc4da2003-01-02 17:55:03 +00004804In fact, if [5] holds at this point, we do have the standard-time spelling,
4805but that takes a bit of proof. We first prove a stronger result. What's the
4806difference between the LHS and RHS of [5]? Let
Tim Petersf3615152003-01-01 21:51:37 +00004807
Tim Peters8bb5ad22003-01-24 02:44:45 +00004808 diff = x.n - (z.n - z.o) [6]
Tim Petersf3615152003-01-01 21:51:37 +00004809
Tim Petersc5dc4da2003-01-02 17:55:03 +00004810Now
4811 z.n = by [4]
Tim Peters8bb5ad22003-01-24 02:44:45 +00004812 (y + y.s).n = by #5
4813 y.n + y.s = since y.n = x.n
4814 x.n + y.s = since z and y are have the same tzinfo member,
4815 y.s = z.s by #2
4816 x.n + z.s
Tim Petersf3615152003-01-01 21:51:37 +00004817
Tim Petersc5dc4da2003-01-02 17:55:03 +00004818Plugging that back into [6] gives
Tim Petersf3615152003-01-01 21:51:37 +00004819
Tim Petersc5dc4da2003-01-02 17:55:03 +00004820 diff =
Tim Peters8bb5ad22003-01-24 02:44:45 +00004821 x.n - ((x.n + z.s) - z.o) = expanding
4822 x.n - x.n - z.s + z.o = cancelling
4823 - z.s + z.o = by #2
Tim Petersc5dc4da2003-01-02 17:55:03 +00004824 z.d
Tim Petersf3615152003-01-01 21:51:37 +00004825
Tim Petersc5dc4da2003-01-02 17:55:03 +00004826So diff = z.d.
Tim Petersf3615152003-01-01 21:51:37 +00004827
Tim Petersc5dc4da2003-01-02 17:55:03 +00004828If [5] is true now, diff = 0, so z.d = 0 too, and we have the standard-time
Tim Peters8bb5ad22003-01-24 02:44:45 +00004829spelling we wanted in the endcase described above. We're done. Contrarily,
4830if z.d = 0, then we have a UTC equivalent, and are also done.
Tim Petersf3615152003-01-01 21:51:37 +00004831
Tim Petersc5dc4da2003-01-02 17:55:03 +00004832If [5] is not true now, diff = z.d != 0, and z.d is the offset we need to
4833add to z (in effect, z is in tz's standard time, and we need to shift the
Tim Peters8bb5ad22003-01-24 02:44:45 +00004834local clock into tz's daylight time).
Tim Petersf3615152003-01-01 21:51:37 +00004835
Tim Petersc5dc4da2003-01-02 17:55:03 +00004836Let
Tim Petersf3615152003-01-01 21:51:37 +00004837
Tim Peters4fede1a2003-01-04 00:26:59 +00004838 z' = z + z.d = z + diff [7]
Tim Petersc3bb26a2003-01-02 03:14:59 +00004839
Tim Peters4fede1a2003-01-04 00:26:59 +00004840and we can again ask whether
Tim Petersc3bb26a2003-01-02 03:14:59 +00004841
Tim Peters8bb5ad22003-01-24 02:44:45 +00004842 z'.n - z'.o = x.n [8]
Tim Petersc3bb26a2003-01-02 03:14:59 +00004843
Tim Peters8bb5ad22003-01-24 02:44:45 +00004844If so, we're done. If not, the tzinfo class is insane, according to the
4845assumptions we've made. This also requires a bit of proof. As before, let's
4846compute the difference between the LHS and RHS of [8] (and skipping some of
4847the justifications for the kinds of substitutions we've done several times
4848already):
Tim Peters4fede1a2003-01-04 00:26:59 +00004849
Tim Peters8bb5ad22003-01-24 02:44:45 +00004850 diff' = x.n - (z'.n - z'.o) = replacing z'.n via [7]
4851 x.n - (z.n + diff - z'.o) = replacing diff via [6]
4852 x.n - (z.n + x.n - (z.n - z.o) - z'.o) =
4853 x.n - z.n - x.n + z.n - z.o + z'.o = cancel x.n
4854 - z.n + z.n - z.o + z'.o = cancel z.n
Tim Peters4fede1a2003-01-04 00:26:59 +00004855 - z.o + z'.o = #1 twice
4856 -z.s - z.d + z'.s + z'.d = z and z' have same tzinfo
4857 z'.d - z.d
4858
4859So z' is UTC-equivalent to x iff z'.d = z.d at this point. If they are equal,
Tim Peters8bb5ad22003-01-24 02:44:45 +00004860we've found the UTC-equivalent so are done. In fact, we stop with [7] and
4861return z', not bothering to compute z'.d.
Tim Peters4fede1a2003-01-04 00:26:59 +00004862
Tim Peters8bb5ad22003-01-24 02:44:45 +00004863How could z.d and z'd differ? z' = z + z.d [7], so merely moving z' by
4864a dst() offset, and starting *from* a time already in DST (we know z.d != 0),
4865would have to change the result dst() returns: we start in DST, and moving
4866a little further into it takes us out of DST.
Tim Peters4fede1a2003-01-04 00:26:59 +00004867
Tim Peters8bb5ad22003-01-24 02:44:45 +00004868There isn't a sane case where this can happen. The closest it gets is at
4869the end of DST, where there's an hour in UTC with no spelling in a hybrid
4870tzinfo class. In US Eastern, that's 5:MM UTC = 0:MM EST = 1:MM EDT. During
4871that hour, on an Eastern clock 1:MM is taken as being in standard time (6:MM
4872UTC) because the docs insist on that, but 0:MM is taken as being in daylight
4873time (4:MM UTC). There is no local time mapping to 5:MM UTC. The local
4874clock jumps from 1:59 back to 1:00 again, and repeats the 1:MM hour in
4875standard time. Since that's what the local clock *does*, we want to map both
4876UTC hours 5:MM and 6:MM to 1:MM Eastern. The result is ambiguous
Tim Peters4fede1a2003-01-04 00:26:59 +00004877in local time, but so it goes -- it's the way the local clock works.
4878
Tim Peters8bb5ad22003-01-24 02:44:45 +00004879When x = 5:MM UTC is the input to this algorithm, x.o=0, y.o=-5 and y.d=0,
4880so z=0:MM. z.d=60 (minutes) then, so [5] doesn't hold and we keep going.
4881z' = z + z.d = 1:MM then, and z'.d=0, and z'.d - z.d = -60 != 0 so [8]
Tim Peters4fede1a2003-01-04 00:26:59 +00004882(correctly) concludes that z' is not UTC-equivalent to x.
4883
4884Because we know z.d said z was in daylight time (else [5] would have held and
4885we would have stopped then), and we know z.d != z'.d (else [8] would have held
Walter Dörwaldf0dfc7a2003-10-20 14:01:56 +00004886and we would have stopped then), and there are only 2 possible values dst() can
Tim Peters4fede1a2003-01-04 00:26:59 +00004887return in Eastern, it follows that z'.d must be 0 (which it is in the example,
4888but the reasoning doesn't depend on the example -- it depends on there being
4889two possible dst() outcomes, one zero and the other non-zero). Therefore
Tim Peters8bb5ad22003-01-24 02:44:45 +00004890z' must be in standard time, and is the spelling we want in this case.
4891
4892Note again that z' is not UTC-equivalent as far as the hybrid tzinfo class is
4893concerned (because it takes z' as being in standard time rather than the
4894daylight time we intend here), but returning it gives the real-life "local
4895clock repeats an hour" behavior when mapping the "unspellable" UTC hour into
4896tz.
4897
4898When the input is 6:MM, z=1:MM and z.d=0, and we stop at once, again with
4899the 1:MM standard time spelling we want.
4900
4901So how can this break? One of the assumptions must be violated. Two
4902possibilities:
4903
49041) [2] effectively says that y.s is invariant across all y belong to a given
4905 time zone. This isn't true if, for political reasons or continental drift,
4906 a region decides to change its base offset from UTC.
4907
49082) There may be versions of "double daylight" time where the tail end of
4909 the analysis gives up a step too early. I haven't thought about that
4910 enough to say.
4911
4912In any case, it's clear that the default fromutc() is strong enough to handle
4913"almost all" time zones: so long as the standard offset is invariant, it
4914doesn't matter if daylight time transition points change from year to year, or
4915if daylight time is skipped in some years; it doesn't matter how large or
4916small dst() may get within its bounds; and it doesn't even matter if some
4917perverse time zone returns a negative dst()). So a breaking case must be
4918pretty bizarre, and a tzinfo subclass can override fromutc() if it is.
Tim Petersf3615152003-01-01 21:51:37 +00004919--------------------------------------------------------------------------- */