Initial commit of OpenSPARC T2 architecture model.
[OpenSPARC-T2-SAM] / sam-t2 / devtools / v9 / lib / python2.4 / test / test_datetime.py
CommitLineData
920dae64
AT
1"""Test date/time type.
2
3See http://www.zope.org/Members/fdrake/DateTimeWiki/TestCases
4"""
5
6import sys
7import pickle
8import cPickle
9import unittest
10
11from test import test_support
12
13from datetime import MINYEAR, MAXYEAR
14from datetime import timedelta
15from datetime import tzinfo
16from datetime import time
17from datetime import date, datetime
18
19pickle_choices = [(pickler, unpickler, proto)
20 for pickler in pickle, cPickle
21 for unpickler in pickle, cPickle
22 for proto in range(3)]
23assert len(pickle_choices) == 2*2*3
24
25# An arbitrary collection of objects of non-datetime types, for testing
26# mixed-type comparisons.
27OTHERSTUFF = (10, 10L, 34.5, "abc", {}, [], ())
28
29
30#############################################################################
31# module tests
32
33class TestModule(unittest.TestCase):
34
35 def test_constants(self):
36 import datetime
37 self.assertEqual(datetime.MINYEAR, 1)
38 self.assertEqual(datetime.MAXYEAR, 9999)
39
40#############################################################################
41# tzinfo tests
42
43class FixedOffset(tzinfo):
44 def __init__(self, offset, name, dstoffset=42):
45 if isinstance(offset, int):
46 offset = timedelta(minutes=offset)
47 if isinstance(dstoffset, int):
48 dstoffset = timedelta(minutes=dstoffset)
49 self.__offset = offset
50 self.__name = name
51 self.__dstoffset = dstoffset
52 def __repr__(self):
53 return self.__name.lower()
54 def utcoffset(self, dt):
55 return self.__offset
56 def tzname(self, dt):
57 return self.__name
58 def dst(self, dt):
59 return self.__dstoffset
60
61class PicklableFixedOffset(FixedOffset):
62 def __init__(self, offset=None, name=None, dstoffset=None):
63 FixedOffset.__init__(self, offset, name, dstoffset)
64
65class TestTZInfo(unittest.TestCase):
66
67 def test_non_abstractness(self):
68 # In order to allow subclasses to get pickled, the C implementation
69 # wasn't able to get away with having __init__ raise
70 # NotImplementedError.
71 useless = tzinfo()
72 dt = datetime.max
73 self.assertRaises(NotImplementedError, useless.tzname, dt)
74 self.assertRaises(NotImplementedError, useless.utcoffset, dt)
75 self.assertRaises(NotImplementedError, useless.dst, dt)
76
77 def test_subclass_must_override(self):
78 class NotEnough(tzinfo):
79 def __init__(self, offset, name):
80 self.__offset = offset
81 self.__name = name
82 self.failUnless(issubclass(NotEnough, tzinfo))
83 ne = NotEnough(3, "NotByALongShot")
84 self.failUnless(isinstance(ne, tzinfo))
85
86 dt = datetime.now()
87 self.assertRaises(NotImplementedError, ne.tzname, dt)
88 self.assertRaises(NotImplementedError, ne.utcoffset, dt)
89 self.assertRaises(NotImplementedError, ne.dst, dt)
90
91 def test_normal(self):
92 fo = FixedOffset(3, "Three")
93 self.failUnless(isinstance(fo, tzinfo))
94 for dt in datetime.now(), None:
95 self.assertEqual(fo.utcoffset(dt), timedelta(minutes=3))
96 self.assertEqual(fo.tzname(dt), "Three")
97 self.assertEqual(fo.dst(dt), timedelta(minutes=42))
98
99 def test_pickling_base(self):
100 # There's no point to pickling tzinfo objects on their own (they
101 # carry no data), but they need to be picklable anyway else
102 # concrete subclasses can't be pickled.
103 orig = tzinfo.__new__(tzinfo)
104 self.failUnless(type(orig) is tzinfo)
105 for pickler, unpickler, proto in pickle_choices:
106 green = pickler.dumps(orig, proto)
107 derived = unpickler.loads(green)
108 self.failUnless(type(derived) is tzinfo)
109
110 def test_pickling_subclass(self):
111 # Make sure we can pickle/unpickle an instance of a subclass.
112 offset = timedelta(minutes=-300)
113 orig = PicklableFixedOffset(offset, 'cookie')
114 self.failUnless(isinstance(orig, tzinfo))
115 self.failUnless(type(orig) is PicklableFixedOffset)
116 self.assertEqual(orig.utcoffset(None), offset)
117 self.assertEqual(orig.tzname(None), 'cookie')
118 for pickler, unpickler, proto in pickle_choices:
119 green = pickler.dumps(orig, proto)
120 derived = unpickler.loads(green)
121 self.failUnless(isinstance(derived, tzinfo))
122 self.failUnless(type(derived) is PicklableFixedOffset)
123 self.assertEqual(derived.utcoffset(None), offset)
124 self.assertEqual(derived.tzname(None), 'cookie')
125
126#############################################################################
127# Base clase for testing a particular aspect of timedelta, time, date and
128# datetime comparisons.
129
130class HarmlessMixedComparison(unittest.TestCase):
131 # Test that __eq__ and __ne__ don't complain for mixed-type comparisons.
132
133 # Subclasses must define 'theclass', and theclass(1, 1, 1) must be a
134 # legit constructor.
135
136 def test_harmless_mixed_comparison(self):
137 me = self.theclass(1, 1, 1)
138
139 self.failIf(me == ())
140 self.failUnless(me != ())
141 self.failIf(() == me)
142 self.failUnless(() != me)
143
144 self.failUnless(me in [1, 20L, [], me])
145 self.failIf(me not in [1, 20L, [], me])
146
147 self.failUnless([] in [me, 1, 20L, []])
148 self.failIf([] not in [me, 1, 20L, []])
149
150 def test_harmful_mixed_comparison(self):
151 me = self.theclass(1, 1, 1)
152
153 self.assertRaises(TypeError, lambda: me < ())
154 self.assertRaises(TypeError, lambda: me <= ())
155 self.assertRaises(TypeError, lambda: me > ())
156 self.assertRaises(TypeError, lambda: me >= ())
157
158 self.assertRaises(TypeError, lambda: () < me)
159 self.assertRaises(TypeError, lambda: () <= me)
160 self.assertRaises(TypeError, lambda: () > me)
161 self.assertRaises(TypeError, lambda: () >= me)
162
163 self.assertRaises(TypeError, cmp, (), me)
164 self.assertRaises(TypeError, cmp, me, ())
165
166#############################################################################
167# timedelta tests
168
169class TestTimeDelta(HarmlessMixedComparison):
170
171 theclass = timedelta
172
173 def test_constructor(self):
174 eq = self.assertEqual
175 td = timedelta
176
177 # Check keyword args to constructor
178 eq(td(), td(weeks=0, days=0, hours=0, minutes=0, seconds=0,
179 milliseconds=0, microseconds=0))
180 eq(td(1), td(days=1))
181 eq(td(0, 1), td(seconds=1))
182 eq(td(0, 0, 1), td(microseconds=1))
183 eq(td(weeks=1), td(days=7))
184 eq(td(days=1), td(hours=24))
185 eq(td(hours=1), td(minutes=60))
186 eq(td(minutes=1), td(seconds=60))
187 eq(td(seconds=1), td(milliseconds=1000))
188 eq(td(milliseconds=1), td(microseconds=1000))
189
190 # Check float args to constructor
191 eq(td(weeks=1.0/7), td(days=1))
192 eq(td(days=1.0/24), td(hours=1))
193 eq(td(hours=1.0/60), td(minutes=1))
194 eq(td(minutes=1.0/60), td(seconds=1))
195 eq(td(seconds=0.001), td(milliseconds=1))
196 eq(td(milliseconds=0.001), td(microseconds=1))
197
198 def test_computations(self):
199 eq = self.assertEqual
200 td = timedelta
201
202 a = td(7) # One week
203 b = td(0, 60) # One minute
204 c = td(0, 0, 1000) # One millisecond
205 eq(a+b+c, td(7, 60, 1000))
206 eq(a-b, td(6, 24*3600 - 60))
207 eq(-a, td(-7))
208 eq(+a, td(7))
209 eq(-b, td(-1, 24*3600 - 60))
210 eq(-c, td(-1, 24*3600 - 1, 999000))
211 eq(abs(a), a)
212 eq(abs(-a), a)
213 eq(td(6, 24*3600), a)
214 eq(td(0, 0, 60*1000000), b)
215 eq(a*10, td(70))
216 eq(a*10, 10*a)
217 eq(a*10L, 10*a)
218 eq(b*10, td(0, 600))
219 eq(10*b, td(0, 600))
220 eq(b*10L, td(0, 600))
221 eq(c*10, td(0, 0, 10000))
222 eq(10*c, td(0, 0, 10000))
223 eq(c*10L, td(0, 0, 10000))
224 eq(a*-1, -a)
225 eq(b*-2, -b-b)
226 eq(c*-2, -c+-c)
227 eq(b*(60*24), (b*60)*24)
228 eq(b*(60*24), (60*b)*24)
229 eq(c*1000, td(0, 1))
230 eq(1000*c, td(0, 1))
231 eq(a//7, td(1))
232 eq(b//10, td(0, 6))
233 eq(c//1000, td(0, 0, 1))
234 eq(a//10, td(0, 7*24*360))
235 eq(a//3600000, td(0, 0, 7*24*1000))
236
237 def test_disallowed_computations(self):
238 a = timedelta(42)
239
240 # Add/sub ints, longs, floats should be illegal
241 for i in 1, 1L, 1.0:
242 self.assertRaises(TypeError, lambda: a+i)
243 self.assertRaises(TypeError, lambda: a-i)
244 self.assertRaises(TypeError, lambda: i+a)
245 self.assertRaises(TypeError, lambda: i-a)
246
247 # Mul/div by float isn't supported.
248 x = 2.3
249 self.assertRaises(TypeError, lambda: a*x)
250 self.assertRaises(TypeError, lambda: x*a)
251 self.assertRaises(TypeError, lambda: a/x)
252 self.assertRaises(TypeError, lambda: x/a)
253 self.assertRaises(TypeError, lambda: a // x)
254 self.assertRaises(TypeError, lambda: x // a)
255
256 # Divison of int by timedelta doesn't make sense.
257 # Division by zero doesn't make sense.
258 for zero in 0, 0L:
259 self.assertRaises(TypeError, lambda: zero // a)
260 self.assertRaises(ZeroDivisionError, lambda: a // zero)
261
262 def test_basic_attributes(self):
263 days, seconds, us = 1, 7, 31
264 td = timedelta(days, seconds, us)
265 self.assertEqual(td.days, days)
266 self.assertEqual(td.seconds, seconds)
267 self.assertEqual(td.microseconds, us)
268
269 def test_carries(self):
270 t1 = timedelta(days=100,
271 weeks=-7,
272 hours=-24*(100-49),
273 minutes=-3,
274 seconds=12,
275 microseconds=(3*60 - 12) * 1e6 + 1)
276 t2 = timedelta(microseconds=1)
277 self.assertEqual(t1, t2)
278
279 def test_hash_equality(self):
280 t1 = timedelta(days=100,
281 weeks=-7,
282 hours=-24*(100-49),
283 minutes=-3,
284 seconds=12,
285 microseconds=(3*60 - 12) * 1000000)
286 t2 = timedelta()
287 self.assertEqual(hash(t1), hash(t2))
288
289 t1 += timedelta(weeks=7)
290 t2 += timedelta(days=7*7)
291 self.assertEqual(t1, t2)
292 self.assertEqual(hash(t1), hash(t2))
293
294 d = {t1: 1}
295 d[t2] = 2
296 self.assertEqual(len(d), 1)
297 self.assertEqual(d[t1], 2)
298
299 def test_pickling(self):
300 args = 12, 34, 56
301 orig = timedelta(*args)
302 for pickler, unpickler, proto in pickle_choices:
303 green = pickler.dumps(orig, proto)
304 derived = unpickler.loads(green)
305 self.assertEqual(orig, derived)
306
307 def test_compare(self):
308 t1 = timedelta(2, 3, 4)
309 t2 = timedelta(2, 3, 4)
310 self.failUnless(t1 == t2)
311 self.failUnless(t1 <= t2)
312 self.failUnless(t1 >= t2)
313 self.failUnless(not t1 != t2)
314 self.failUnless(not t1 < t2)
315 self.failUnless(not t1 > t2)
316 self.assertEqual(cmp(t1, t2), 0)
317 self.assertEqual(cmp(t2, t1), 0)
318
319 for args in (3, 3, 3), (2, 4, 4), (2, 3, 5):
320 t2 = timedelta(*args) # this is larger than t1
321 self.failUnless(t1 < t2)
322 self.failUnless(t2 > t1)
323 self.failUnless(t1 <= t2)
324 self.failUnless(t2 >= t1)
325 self.failUnless(t1 != t2)
326 self.failUnless(t2 != t1)
327 self.failUnless(not t1 == t2)
328 self.failUnless(not t2 == t1)
329 self.failUnless(not t1 > t2)
330 self.failUnless(not t2 < t1)
331 self.failUnless(not t1 >= t2)
332 self.failUnless(not t2 <= t1)
333 self.assertEqual(cmp(t1, t2), -1)
334 self.assertEqual(cmp(t2, t1), 1)
335
336 for badarg in OTHERSTUFF:
337 self.assertEqual(t1 == badarg, False)
338 self.assertEqual(t1 != badarg, True)
339 self.assertEqual(badarg == t1, False)
340 self.assertEqual(badarg != t1, True)
341
342 self.assertRaises(TypeError, lambda: t1 <= badarg)
343 self.assertRaises(TypeError, lambda: t1 < badarg)
344 self.assertRaises(TypeError, lambda: t1 > badarg)
345 self.assertRaises(TypeError, lambda: t1 >= badarg)
346 self.assertRaises(TypeError, lambda: badarg <= t1)
347 self.assertRaises(TypeError, lambda: badarg < t1)
348 self.assertRaises(TypeError, lambda: badarg > t1)
349 self.assertRaises(TypeError, lambda: badarg >= t1)
350
351 def test_str(self):
352 td = timedelta
353 eq = self.assertEqual
354
355 eq(str(td(1)), "1 day, 0:00:00")
356 eq(str(td(-1)), "-1 day, 0:00:00")
357 eq(str(td(2)), "2 days, 0:00:00")
358 eq(str(td(-2)), "-2 days, 0:00:00")
359
360 eq(str(td(hours=12, minutes=58, seconds=59)), "12:58:59")
361 eq(str(td(hours=2, minutes=3, seconds=4)), "2:03:04")
362 eq(str(td(weeks=-30, hours=23, minutes=12, seconds=34)),
363 "-210 days, 23:12:34")
364
365 eq(str(td(milliseconds=1)), "0:00:00.001000")
366 eq(str(td(microseconds=3)), "0:00:00.000003")
367
368 eq(str(td(days=999999999, hours=23, minutes=59, seconds=59,
369 microseconds=999999)),
370 "999999999 days, 23:59:59.999999")
371
372 def test_roundtrip(self):
373 for td in (timedelta(days=999999999, hours=23, minutes=59,
374 seconds=59, microseconds=999999),
375 timedelta(days=-999999999),
376 timedelta(days=1, seconds=2, microseconds=3)):
377
378 # Verify td -> string -> td identity.
379 s = repr(td)
380 self.failUnless(s.startswith('datetime.'))
381 s = s[9:]
382 td2 = eval(s)
383 self.assertEqual(td, td2)
384
385 # Verify identity via reconstructing from pieces.
386 td2 = timedelta(td.days, td.seconds, td.microseconds)
387 self.assertEqual(td, td2)
388
389 def test_resolution_info(self):
390 self.assert_(isinstance(timedelta.min, timedelta))
391 self.assert_(isinstance(timedelta.max, timedelta))
392 self.assert_(isinstance(timedelta.resolution, timedelta))
393 self.assert_(timedelta.max > timedelta.min)
394 self.assertEqual(timedelta.min, timedelta(-999999999))
395 self.assertEqual(timedelta.max, timedelta(999999999, 24*3600-1, 1e6-1))
396 self.assertEqual(timedelta.resolution, timedelta(0, 0, 1))
397
398 def test_overflow(self):
399 tiny = timedelta.resolution
400
401 td = timedelta.min + tiny
402 td -= tiny # no problem
403 self.assertRaises(OverflowError, td.__sub__, tiny)
404 self.assertRaises(OverflowError, td.__add__, -tiny)
405
406 td = timedelta.max - tiny
407 td += tiny # no problem
408 self.assertRaises(OverflowError, td.__add__, tiny)
409 self.assertRaises(OverflowError, td.__sub__, -tiny)
410
411 self.assertRaises(OverflowError, lambda: -timedelta.max)
412
413 def test_microsecond_rounding(self):
414 td = timedelta
415 eq = self.assertEqual
416
417 # Single-field rounding.
418 eq(td(milliseconds=0.4/1000), td(0)) # rounds to 0
419 eq(td(milliseconds=-0.4/1000), td(0)) # rounds to 0
420 eq(td(milliseconds=0.6/1000), td(microseconds=1))
421 eq(td(milliseconds=-0.6/1000), td(microseconds=-1))
422
423 # Rounding due to contributions from more than one field.
424 us_per_hour = 3600e6
425 us_per_day = us_per_hour * 24
426 eq(td(days=.4/us_per_day), td(0))
427 eq(td(hours=.2/us_per_hour), td(0))
428 eq(td(days=.4/us_per_day, hours=.2/us_per_hour), td(microseconds=1))
429
430 eq(td(days=-.4/us_per_day), td(0))
431 eq(td(hours=-.2/us_per_hour), td(0))
432 eq(td(days=-.4/us_per_day, hours=-.2/us_per_hour), td(microseconds=-1))
433
434 def test_massive_normalization(self):
435 td = timedelta(microseconds=-1)
436 self.assertEqual((td.days, td.seconds, td.microseconds),
437 (-1, 24*3600-1, 999999))
438
439 def test_bool(self):
440 self.failUnless(timedelta(1))
441 self.failUnless(timedelta(0, 1))
442 self.failUnless(timedelta(0, 0, 1))
443 self.failUnless(timedelta(microseconds=1))
444 self.failUnless(not timedelta(0))
445
446 def test_subclass_timedelta(self):
447
448 class T(timedelta):
449 def from_td(td):
450 return T(td.days, td.seconds, td.microseconds)
451 from_td = staticmethod(from_td)
452
453 def as_hours(self):
454 sum = (self.days * 24 +
455 self.seconds / 3600.0 +
456 self.microseconds / 3600e6)
457 return round(sum)
458
459 t1 = T(days=1)
460 self.assert_(type(t1) is T)
461 self.assertEqual(t1.as_hours(), 24)
462
463 t2 = T(days=-1, seconds=-3600)
464 self.assert_(type(t2) is T)
465 self.assertEqual(t2.as_hours(), -25)
466
467 t3 = t1 + t2
468 self.assert_(type(t3) is timedelta)
469 t4 = T.from_td(t3)
470 self.assert_(type(t4) is T)
471 self.assertEqual(t3.days, t4.days)
472 self.assertEqual(t3.seconds, t4.seconds)
473 self.assertEqual(t3.microseconds, t4.microseconds)
474 self.assertEqual(str(t3), str(t4))
475 self.assertEqual(t4.as_hours(), -1)
476
477#############################################################################
478# date tests
479
480class TestDateOnly(unittest.TestCase):
481 # Tests here won't pass if also run on datetime objects, so don't
482 # subclass this to test datetimes too.
483
484 def test_delta_non_days_ignored(self):
485 dt = date(2000, 1, 2)
486 delta = timedelta(days=1, hours=2, minutes=3, seconds=4,
487 microseconds=5)
488 days = timedelta(delta.days)
489 self.assertEqual(days, timedelta(1))
490
491 dt2 = dt + delta
492 self.assertEqual(dt2, dt + days)
493
494 dt2 = delta + dt
495 self.assertEqual(dt2, dt + days)
496
497 dt2 = dt - delta
498 self.assertEqual(dt2, dt - days)
499
500 delta = -delta
501 days = timedelta(delta.days)
502 self.assertEqual(days, timedelta(-2))
503
504 dt2 = dt + delta
505 self.assertEqual(dt2, dt + days)
506
507 dt2 = delta + dt
508 self.assertEqual(dt2, dt + days)
509
510 dt2 = dt - delta
511 self.assertEqual(dt2, dt - days)
512
513class SubclassDate(date):
514 sub_var = 1
515
516class TestDate(HarmlessMixedComparison):
517 # Tests here should pass for both dates and datetimes, except for a
518 # few tests that TestDateTime overrides.
519
520 theclass = date
521
522 def test_basic_attributes(self):
523 dt = self.theclass(2002, 3, 1)
524 self.assertEqual(dt.year, 2002)
525 self.assertEqual(dt.month, 3)
526 self.assertEqual(dt.day, 1)
527
528 def test_roundtrip(self):
529 for dt in (self.theclass(1, 2, 3),
530 self.theclass.today()):
531 # Verify dt -> string -> date identity.
532 s = repr(dt)
533 self.failUnless(s.startswith('datetime.'))
534 s = s[9:]
535 dt2 = eval(s)
536 self.assertEqual(dt, dt2)
537
538 # Verify identity via reconstructing from pieces.
539 dt2 = self.theclass(dt.year, dt.month, dt.day)
540 self.assertEqual(dt, dt2)
541
542 def test_ordinal_conversions(self):
543 # Check some fixed values.
544 for y, m, d, n in [(1, 1, 1, 1), # calendar origin
545 (1, 12, 31, 365),
546 (2, 1, 1, 366),
547 # first example from "Calendrical Calculations"
548 (1945, 11, 12, 710347)]:
549 d = self.theclass(y, m, d)
550 self.assertEqual(n, d.toordinal())
551 fromord = self.theclass.fromordinal(n)
552 self.assertEqual(d, fromord)
553 if hasattr(fromord, "hour"):
554 # if we're checking something fancier than a date, verify
555 # the extra fields have been zeroed out
556 self.assertEqual(fromord.hour, 0)
557 self.assertEqual(fromord.minute, 0)
558 self.assertEqual(fromord.second, 0)
559 self.assertEqual(fromord.microsecond, 0)
560
561 # Check first and last days of year spottily across the whole
562 # range of years supported.
563 for year in xrange(MINYEAR, MAXYEAR+1, 7):
564 # Verify (year, 1, 1) -> ordinal -> y, m, d is identity.
565 d = self.theclass(year, 1, 1)
566 n = d.toordinal()
567 d2 = self.theclass.fromordinal(n)
568 self.assertEqual(d, d2)
569 # Verify that moving back a day gets to the end of year-1.
570 if year > 1:
571 d = self.theclass.fromordinal(n-1)
572 d2 = self.theclass(year-1, 12, 31)
573 self.assertEqual(d, d2)
574 self.assertEqual(d2.toordinal(), n-1)
575
576 # Test every day in a leap-year and a non-leap year.
577 dim = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
578 for year, isleap in (2000, True), (2002, False):
579 n = self.theclass(year, 1, 1).toordinal()
580 for month, maxday in zip(range(1, 13), dim):
581 if month == 2 and isleap:
582 maxday += 1
583 for day in range(1, maxday+1):
584 d = self.theclass(year, month, day)
585 self.assertEqual(d.toordinal(), n)
586 self.assertEqual(d, self.theclass.fromordinal(n))
587 n += 1
588
589 def test_extreme_ordinals(self):
590 a = self.theclass.min
591 a = self.theclass(a.year, a.month, a.day) # get rid of time parts
592 aord = a.toordinal()
593 b = a.fromordinal(aord)
594 self.assertEqual(a, b)
595
596 self.assertRaises(ValueError, lambda: a.fromordinal(aord - 1))
597
598 b = a + timedelta(days=1)
599 self.assertEqual(b.toordinal(), aord + 1)
600 self.assertEqual(b, self.theclass.fromordinal(aord + 1))
601
602 a = self.theclass.max
603 a = self.theclass(a.year, a.month, a.day) # get rid of time parts
604 aord = a.toordinal()
605 b = a.fromordinal(aord)
606 self.assertEqual(a, b)
607
608 self.assertRaises(ValueError, lambda: a.fromordinal(aord + 1))
609
610 b = a - timedelta(days=1)
611 self.assertEqual(b.toordinal(), aord - 1)
612 self.assertEqual(b, self.theclass.fromordinal(aord - 1))
613
614 def test_bad_constructor_arguments(self):
615 # bad years
616 self.theclass(MINYEAR, 1, 1) # no exception
617 self.theclass(MAXYEAR, 1, 1) # no exception
618 self.assertRaises(ValueError, self.theclass, MINYEAR-1, 1, 1)
619 self.assertRaises(ValueError, self.theclass, MAXYEAR+1, 1, 1)
620 # bad months
621 self.theclass(2000, 1, 1) # no exception
622 self.theclass(2000, 12, 1) # no exception
623 self.assertRaises(ValueError, self.theclass, 2000, 0, 1)
624 self.assertRaises(ValueError, self.theclass, 2000, 13, 1)
625 # bad days
626 self.theclass(2000, 2, 29) # no exception
627 self.theclass(2004, 2, 29) # no exception
628 self.theclass(2400, 2, 29) # no exception
629 self.assertRaises(ValueError, self.theclass, 2000, 2, 30)
630 self.assertRaises(ValueError, self.theclass, 2001, 2, 29)
631 self.assertRaises(ValueError, self.theclass, 2100, 2, 29)
632 self.assertRaises(ValueError, self.theclass, 1900, 2, 29)
633 self.assertRaises(ValueError, self.theclass, 2000, 1, 0)
634 self.assertRaises(ValueError, self.theclass, 2000, 1, 32)
635
636 def test_hash_equality(self):
637 d = self.theclass(2000, 12, 31)
638 # same thing
639 e = self.theclass(2000, 12, 31)
640 self.assertEqual(d, e)
641 self.assertEqual(hash(d), hash(e))
642
643 dic = {d: 1}
644 dic[e] = 2
645 self.assertEqual(len(dic), 1)
646 self.assertEqual(dic[d], 2)
647 self.assertEqual(dic[e], 2)
648
649 d = self.theclass(2001, 1, 1)
650 # same thing
651 e = self.theclass(2001, 1, 1)
652 self.assertEqual(d, e)
653 self.assertEqual(hash(d), hash(e))
654
655 dic = {d: 1}
656 dic[e] = 2
657 self.assertEqual(len(dic), 1)
658 self.assertEqual(dic[d], 2)
659 self.assertEqual(dic[e], 2)
660
661 def test_computations(self):
662 a = self.theclass(2002, 1, 31)
663 b = self.theclass(1956, 1, 31)
664
665 diff = a-b
666 self.assertEqual(diff.days, 46*365 + len(range(1956, 2002, 4)))
667 self.assertEqual(diff.seconds, 0)
668 self.assertEqual(diff.microseconds, 0)
669
670 day = timedelta(1)
671 week = timedelta(7)
672 a = self.theclass(2002, 3, 2)
673 self.assertEqual(a + day, self.theclass(2002, 3, 3))
674 self.assertEqual(day + a, self.theclass(2002, 3, 3))
675 self.assertEqual(a - day, self.theclass(2002, 3, 1))
676 self.assertEqual(-day + a, self.theclass(2002, 3, 1))
677 self.assertEqual(a + week, self.theclass(2002, 3, 9))
678 self.assertEqual(a - week, self.theclass(2002, 2, 23))
679 self.assertEqual(a + 52*week, self.theclass(2003, 3, 1))
680 self.assertEqual(a - 52*week, self.theclass(2001, 3, 3))
681 self.assertEqual((a + week) - a, week)
682 self.assertEqual((a + day) - a, day)
683 self.assertEqual((a - week) - a, -week)
684 self.assertEqual((a - day) - a, -day)
685 self.assertEqual(a - (a + week), -week)
686 self.assertEqual(a - (a + day), -day)
687 self.assertEqual(a - (a - week), week)
688 self.assertEqual(a - (a - day), day)
689
690 # Add/sub ints, longs, floats should be illegal
691 for i in 1, 1L, 1.0:
692 self.assertRaises(TypeError, lambda: a+i)
693 self.assertRaises(TypeError, lambda: a-i)
694 self.assertRaises(TypeError, lambda: i+a)
695 self.assertRaises(TypeError, lambda: i-a)
696
697 # delta - date is senseless.
698 self.assertRaises(TypeError, lambda: day - a)
699 # mixing date and (delta or date) via * or // is senseless
700 self.assertRaises(TypeError, lambda: day * a)
701 self.assertRaises(TypeError, lambda: a * day)
702 self.assertRaises(TypeError, lambda: day // a)
703 self.assertRaises(TypeError, lambda: a // day)
704 self.assertRaises(TypeError, lambda: a * a)
705 self.assertRaises(TypeError, lambda: a // a)
706 # date + date is senseless
707 self.assertRaises(TypeError, lambda: a + a)
708
709 def test_overflow(self):
710 tiny = self.theclass.resolution
711
712 dt = self.theclass.min + tiny
713 dt -= tiny # no problem
714 self.assertRaises(OverflowError, dt.__sub__, tiny)
715 self.assertRaises(OverflowError, dt.__add__, -tiny)
716
717 dt = self.theclass.max - tiny
718 dt += tiny # no problem
719 self.assertRaises(OverflowError, dt.__add__, tiny)
720 self.assertRaises(OverflowError, dt.__sub__, -tiny)
721
722 def test_fromtimestamp(self):
723 import time
724
725 # Try an arbitrary fixed value.
726 year, month, day = 1999, 9, 19
727 ts = time.mktime((year, month, day, 0, 0, 0, 0, 0, -1))
728 d = self.theclass.fromtimestamp(ts)
729 self.assertEqual(d.year, year)
730 self.assertEqual(d.month, month)
731 self.assertEqual(d.day, day)
732
733 def test_insane_fromtimestamp(self):
734 # It's possible that some platform maps time_t to double,
735 # and that this test will fail there. This test should
736 # exempt such platforms (provided they return reasonable
737 # results!).
738 for insane in -1e200, 1e200:
739 self.assertRaises(ValueError, self.theclass.fromtimestamp,
740 insane)
741
742 def test_today(self):
743 import time
744
745 # We claim that today() is like fromtimestamp(time.time()), so
746 # prove it.
747 for dummy in range(3):
748 today = self.theclass.today()
749 ts = time.time()
750 todayagain = self.theclass.fromtimestamp(ts)
751 if today == todayagain:
752 break
753 # There are several legit reasons that could fail:
754 # 1. It recently became midnight, between the today() and the
755 # time() calls.
756 # 2. The platform time() has such fine resolution that we'll
757 # never get the same value twice.
758 # 3. The platform time() has poor resolution, and we just
759 # happened to call today() right before a resolution quantum
760 # boundary.
761 # 4. The system clock got fiddled between calls.
762 # In any case, wait a little while and try again.
763 time.sleep(0.1)
764
765 # It worked or it didn't. If it didn't, assume it's reason #2, and
766 # let the test pass if they're within half a second of each other.
767 self.failUnless(today == todayagain or
768 abs(todayagain - today) < timedelta(seconds=0.5))
769
770 def test_weekday(self):
771 for i in range(7):
772 # March 4, 2002 is a Monday
773 self.assertEqual(self.theclass(2002, 3, 4+i).weekday(), i)
774 self.assertEqual(self.theclass(2002, 3, 4+i).isoweekday(), i+1)
775 # January 2, 1956 is a Monday
776 self.assertEqual(self.theclass(1956, 1, 2+i).weekday(), i)
777 self.assertEqual(self.theclass(1956, 1, 2+i).isoweekday(), i+1)
778
779 def test_isocalendar(self):
780 # Check examples from
781 # http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
782 for i in range(7):
783 d = self.theclass(2003, 12, 22+i)
784 self.assertEqual(d.isocalendar(), (2003, 52, i+1))
785 d = self.theclass(2003, 12, 29) + timedelta(i)
786 self.assertEqual(d.isocalendar(), (2004, 1, i+1))
787 d = self.theclass(2004, 1, 5+i)
788 self.assertEqual(d.isocalendar(), (2004, 2, i+1))
789 d = self.theclass(2009, 12, 21+i)
790 self.assertEqual(d.isocalendar(), (2009, 52, i+1))
791 d = self.theclass(2009, 12, 28) + timedelta(i)
792 self.assertEqual(d.isocalendar(), (2009, 53, i+1))
793 d = self.theclass(2010, 1, 4+i)
794 self.assertEqual(d.isocalendar(), (2010, 1, i+1))
795
796 def test_iso_long_years(self):
797 # Calculate long ISO years and compare to table from
798 # http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
799 ISO_LONG_YEARS_TABLE = """
800 4 32 60 88
801 9 37 65 93
802 15 43 71 99
803 20 48 76
804 26 54 82
805
806 105 133 161 189
807 111 139 167 195
808 116 144 172
809 122 150 178
810 128 156 184
811
812 201 229 257 285
813 207 235 263 291
814 212 240 268 296
815 218 246 274
816 224 252 280
817
818 303 331 359 387
819 308 336 364 392
820 314 342 370 398
821 320 348 376
822 325 353 381
823 """
824 iso_long_years = map(int, ISO_LONG_YEARS_TABLE.split())
825 iso_long_years.sort()
826 L = []
827 for i in range(400):
828 d = self.theclass(2000+i, 12, 31)
829 d1 = self.theclass(1600+i, 12, 31)
830 self.assertEqual(d.isocalendar()[1:], d1.isocalendar()[1:])
831 if d.isocalendar()[1] == 53:
832 L.append(i)
833 self.assertEqual(L, iso_long_years)
834
835 def test_isoformat(self):
836 t = self.theclass(2, 3, 2)
837 self.assertEqual(t.isoformat(), "0002-03-02")
838
839 def test_ctime(self):
840 t = self.theclass(2002, 3, 2)
841 self.assertEqual(t.ctime(), "Sat Mar 2 00:00:00 2002")
842
843 def test_strftime(self):
844 t = self.theclass(2005, 3, 2)
845 self.assertEqual(t.strftime("m:%m d:%d y:%y"), "m:03 d:02 y:05")
846 self.assertEqual(t.strftime(""), "") # SF bug #761337
847
848 self.assertRaises(TypeError, t.strftime) # needs an arg
849 self.assertRaises(TypeError, t.strftime, "one", "two") # too many args
850 self.assertRaises(TypeError, t.strftime, 42) # arg wrong type
851
852 # A naive object replaces %z and %Z w/ empty strings.
853 self.assertEqual(t.strftime("'%z' '%Z'"), "'' ''")
854
855 def test_resolution_info(self):
856 self.assert_(isinstance(self.theclass.min, self.theclass))
857 self.assert_(isinstance(self.theclass.max, self.theclass))
858 self.assert_(isinstance(self.theclass.resolution, timedelta))
859 self.assert_(self.theclass.max > self.theclass.min)
860
861 def test_extreme_timedelta(self):
862 big = self.theclass.max - self.theclass.min
863 # 3652058 days, 23 hours, 59 minutes, 59 seconds, 999999 microseconds
864 n = (big.days*24*3600 + big.seconds)*1000000 + big.microseconds
865 # n == 315537897599999999 ~= 2**58.13
866 justasbig = timedelta(0, 0, n)
867 self.assertEqual(big, justasbig)
868 self.assertEqual(self.theclass.min + big, self.theclass.max)
869 self.assertEqual(self.theclass.max - big, self.theclass.min)
870
871 def test_timetuple(self):
872 for i in range(7):
873 # January 2, 1956 is a Monday (0)
874 d = self.theclass(1956, 1, 2+i)
875 t = d.timetuple()
876 self.assertEqual(t, (1956, 1, 2+i, 0, 0, 0, i, 2+i, -1))
877 # February 1, 1956 is a Wednesday (2)
878 d = self.theclass(1956, 2, 1+i)
879 t = d.timetuple()
880 self.assertEqual(t, (1956, 2, 1+i, 0, 0, 0, (2+i)%7, 32+i, -1))
881 # March 1, 1956 is a Thursday (3), and is the 31+29+1 = 61st day
882 # of the year.
883 d = self.theclass(1956, 3, 1+i)
884 t = d.timetuple()
885 self.assertEqual(t, (1956, 3, 1+i, 0, 0, 0, (3+i)%7, 61+i, -1))
886 self.assertEqual(t.tm_year, 1956)
887 self.assertEqual(t.tm_mon, 3)
888 self.assertEqual(t.tm_mday, 1+i)
889 self.assertEqual(t.tm_hour, 0)
890 self.assertEqual(t.tm_min, 0)
891 self.assertEqual(t.tm_sec, 0)
892 self.assertEqual(t.tm_wday, (3+i)%7)
893 self.assertEqual(t.tm_yday, 61+i)
894 self.assertEqual(t.tm_isdst, -1)
895
896 def test_pickling(self):
897 args = 6, 7, 23
898 orig = self.theclass(*args)
899 for pickler, unpickler, proto in pickle_choices:
900 green = pickler.dumps(orig, proto)
901 derived = unpickler.loads(green)
902 self.assertEqual(orig, derived)
903
904 def test_compare(self):
905 t1 = self.theclass(2, 3, 4)
906 t2 = self.theclass(2, 3, 4)
907 self.failUnless(t1 == t2)
908 self.failUnless(t1 <= t2)
909 self.failUnless(t1 >= t2)
910 self.failUnless(not t1 != t2)
911 self.failUnless(not t1 < t2)
912 self.failUnless(not t1 > t2)
913 self.assertEqual(cmp(t1, t2), 0)
914 self.assertEqual(cmp(t2, t1), 0)
915
916 for args in (3, 3, 3), (2, 4, 4), (2, 3, 5):
917 t2 = self.theclass(*args) # this is larger than t1
918 self.failUnless(t1 < t2)
919 self.failUnless(t2 > t1)
920 self.failUnless(t1 <= t2)
921 self.failUnless(t2 >= t1)
922 self.failUnless(t1 != t2)
923 self.failUnless(t2 != t1)
924 self.failUnless(not t1 == t2)
925 self.failUnless(not t2 == t1)
926 self.failUnless(not t1 > t2)
927 self.failUnless(not t2 < t1)
928 self.failUnless(not t1 >= t2)
929 self.failUnless(not t2 <= t1)
930 self.assertEqual(cmp(t1, t2), -1)
931 self.assertEqual(cmp(t2, t1), 1)
932
933 for badarg in OTHERSTUFF:
934 self.assertEqual(t1 == badarg, False)
935 self.assertEqual(t1 != badarg, True)
936 self.assertEqual(badarg == t1, False)
937 self.assertEqual(badarg != t1, True)
938
939 self.assertRaises(TypeError, lambda: t1 < badarg)
940 self.assertRaises(TypeError, lambda: t1 > badarg)
941 self.assertRaises(TypeError, lambda: t1 >= badarg)
942 self.assertRaises(TypeError, lambda: badarg <= t1)
943 self.assertRaises(TypeError, lambda: badarg < t1)
944 self.assertRaises(TypeError, lambda: badarg > t1)
945 self.assertRaises(TypeError, lambda: badarg >= t1)
946
947 def test_mixed_compare(self):
948 our = self.theclass(2000, 4, 5)
949 self.assertRaises(TypeError, cmp, our, 1)
950 self.assertRaises(TypeError, cmp, 1, our)
951
952 class AnotherDateTimeClass(object):
953 def __cmp__(self, other):
954 # Return "equal" so calling this can't be confused with
955 # compare-by-address (which never says "equal" for distinct
956 # objects).
957 return 0
958
959 # This still errors, because date and datetime comparison raise
960 # TypeError instead of NotImplemented when they don't know what to
961 # do, in order to stop comparison from falling back to the default
962 # compare-by-address.
963 their = AnotherDateTimeClass()
964 self.assertRaises(TypeError, cmp, our, their)
965 # Oops: The next stab raises TypeError in the C implementation,
966 # but not in the Python implementation of datetime. The difference
967 # is due to that the Python implementation defines __cmp__ but
968 # the C implementation defines tp_richcompare. This is more pain
969 # to fix than it's worth, so commenting out the test.
970 # self.assertEqual(cmp(their, our), 0)
971
972 # But date and datetime comparison return NotImplemented instead if the
973 # other object has a timetuple attr. This gives the other object a
974 # chance to do the comparison.
975 class Comparable(AnotherDateTimeClass):
976 def timetuple(self):
977 return ()
978
979 their = Comparable()
980 self.assertEqual(cmp(our, their), 0)
981 self.assertEqual(cmp(their, our), 0)
982 self.failUnless(our == their)
983 self.failUnless(their == our)
984
985 def test_bool(self):
986 # All dates are considered true.
987 self.failUnless(self.theclass.min)
988 self.failUnless(self.theclass.max)
989
990 def test_srftime_out_of_range(self):
991 # For nasty technical reasons, we can't handle years before 1900.
992 cls = self.theclass
993 self.assertEqual(cls(1900, 1, 1).strftime("%Y"), "1900")
994 for y in 1, 49, 51, 99, 100, 1000, 1899:
995 self.assertRaises(ValueError, cls(y, 1, 1).strftime, "%Y")
996
997 def test_replace(self):
998 cls = self.theclass
999 args = [1, 2, 3]
1000 base = cls(*args)
1001 self.assertEqual(base, base.replace())
1002
1003 i = 0
1004 for name, newval in (("year", 2),
1005 ("month", 3),
1006 ("day", 4)):
1007 newargs = args[:]
1008 newargs[i] = newval
1009 expected = cls(*newargs)
1010 got = base.replace(**{name: newval})
1011 self.assertEqual(expected, got)
1012 i += 1
1013
1014 # Out of bounds.
1015 base = cls(2000, 2, 29)
1016 self.assertRaises(ValueError, base.replace, year=2001)
1017
1018 def test_subclass_date(self):
1019
1020 class C(self.theclass):
1021 theAnswer = 42
1022
1023 def __new__(cls, *args, **kws):
1024 temp = kws.copy()
1025 extra = temp.pop('extra')
1026 result = self.theclass.__new__(cls, *args, **temp)
1027 result.extra = extra
1028 return result
1029
1030 def newmeth(self, start):
1031 return start + self.year + self.month
1032
1033 args = 2003, 4, 14
1034
1035 dt1 = self.theclass(*args)
1036 dt2 = C(*args, **{'extra': 7})
1037
1038 self.assertEqual(dt2.__class__, C)
1039 self.assertEqual(dt2.theAnswer, 42)
1040 self.assertEqual(dt2.extra, 7)
1041 self.assertEqual(dt1.toordinal(), dt2.toordinal())
1042 self.assertEqual(dt2.newmeth(-7), dt1.year + dt1.month - 7)
1043
1044 def test_pickling_subclass_date(self):
1045
1046 args = 6, 7, 23
1047 orig = SubclassDate(*args)
1048 for pickler, unpickler, proto in pickle_choices:
1049 green = pickler.dumps(orig, proto)
1050 derived = unpickler.loads(green)
1051 self.assertEqual(orig, derived)
1052
1053 def test_backdoor_resistance(self):
1054 # For fast unpickling, the constructor accepts a pickle string.
1055 # This is a low-overhead backdoor. A user can (by intent or
1056 # mistake) pass a string directly, which (if it's the right length)
1057 # will get treated like a pickle, and bypass the normal sanity
1058 # checks in the constructor. This can create insane objects.
1059 # The constructor doesn't want to burn the time to validate all
1060 # fields, but does check the month field. This stops, e.g.,
1061 # datetime.datetime('1995-03-25') from yielding an insane object.
1062 base = '1995-03-25'
1063 if not issubclass(self.theclass, datetime):
1064 base = base[:4]
1065 for month_byte in '9', chr(0), chr(13), '\xff':
1066 self.assertRaises(TypeError, self.theclass,
1067 base[:2] + month_byte + base[3:])
1068 for ord_byte in range(1, 13):
1069 # This shouldn't blow up because of the month byte alone. If
1070 # the implementation changes to do more-careful checking, it may
1071 # blow up because other fields are insane.
1072 self.theclass(base[:2] + chr(ord_byte) + base[3:])
1073
1074#############################################################################
1075# datetime tests
1076
1077class SubclassDatetime(datetime):
1078 sub_var = 1
1079
1080class TestDateTime(TestDate):
1081
1082 theclass = datetime
1083
1084 def test_basic_attributes(self):
1085 dt = self.theclass(2002, 3, 1, 12, 0)
1086 self.assertEqual(dt.year, 2002)
1087 self.assertEqual(dt.month, 3)
1088 self.assertEqual(dt.day, 1)
1089 self.assertEqual(dt.hour, 12)
1090 self.assertEqual(dt.minute, 0)
1091 self.assertEqual(dt.second, 0)
1092 self.assertEqual(dt.microsecond, 0)
1093
1094 def test_basic_attributes_nonzero(self):
1095 # Make sure all attributes are non-zero so bugs in
1096 # bit-shifting access show up.
1097 dt = self.theclass(2002, 3, 1, 12, 59, 59, 8000)
1098 self.assertEqual(dt.year, 2002)
1099 self.assertEqual(dt.month, 3)
1100 self.assertEqual(dt.day, 1)
1101 self.assertEqual(dt.hour, 12)
1102 self.assertEqual(dt.minute, 59)
1103 self.assertEqual(dt.second, 59)
1104 self.assertEqual(dt.microsecond, 8000)
1105
1106 def test_roundtrip(self):
1107 for dt in (self.theclass(1, 2, 3, 4, 5, 6, 7),
1108 self.theclass.now()):
1109 # Verify dt -> string -> datetime identity.
1110 s = repr(dt)
1111 self.failUnless(s.startswith('datetime.'))
1112 s = s[9:]
1113 dt2 = eval(s)
1114 self.assertEqual(dt, dt2)
1115
1116 # Verify identity via reconstructing from pieces.
1117 dt2 = self.theclass(dt.year, dt.month, dt.day,
1118 dt.hour, dt.minute, dt.second,
1119 dt.microsecond)
1120 self.assertEqual(dt, dt2)
1121
1122 def test_isoformat(self):
1123 t = self.theclass(2, 3, 2, 4, 5, 1, 123)
1124 self.assertEqual(t.isoformat(), "0002-03-02T04:05:01.000123")
1125 self.assertEqual(t.isoformat('T'), "0002-03-02T04:05:01.000123")
1126 self.assertEqual(t.isoformat(' '), "0002-03-02 04:05:01.000123")
1127 # str is ISO format with the separator forced to a blank.
1128 self.assertEqual(str(t), "0002-03-02 04:05:01.000123")
1129
1130 t = self.theclass(2, 3, 2)
1131 self.assertEqual(t.isoformat(), "0002-03-02T00:00:00")
1132 self.assertEqual(t.isoformat('T'), "0002-03-02T00:00:00")
1133 self.assertEqual(t.isoformat(' '), "0002-03-02 00:00:00")
1134 # str is ISO format with the separator forced to a blank.
1135 self.assertEqual(str(t), "0002-03-02 00:00:00")
1136
1137 def test_more_ctime(self):
1138 # Test fields that TestDate doesn't touch.
1139 import time
1140
1141 t = self.theclass(2002, 3, 2, 18, 3, 5, 123)
1142 self.assertEqual(t.ctime(), "Sat Mar 2 18:03:05 2002")
1143 # Oops! The next line fails on Win2K under MSVC 6, so it's commented
1144 # out. The difference is that t.ctime() produces " 2" for the day,
1145 # but platform ctime() produces "02" for the day. According to
1146 # C99, t.ctime() is correct here.
1147 # self.assertEqual(t.ctime(), time.ctime(time.mktime(t.timetuple())))
1148
1149 # So test a case where that difference doesn't matter.
1150 t = self.theclass(2002, 3, 22, 18, 3, 5, 123)
1151 self.assertEqual(t.ctime(), time.ctime(time.mktime(t.timetuple())))
1152
1153 def test_tz_independent_comparing(self):
1154 dt1 = self.theclass(2002, 3, 1, 9, 0, 0)
1155 dt2 = self.theclass(2002, 3, 1, 10, 0, 0)
1156 dt3 = self.theclass(2002, 3, 1, 9, 0, 0)
1157 self.assertEqual(dt1, dt3)
1158 self.assert_(dt2 > dt3)
1159
1160 # Make sure comparison doesn't forget microseconds, and isn't done
1161 # via comparing a float timestamp (an IEEE double doesn't have enough
1162 # precision to span microsecond resolution across years 1 thru 9999,
1163 # so comparing via timestamp necessarily calls some distinct values
1164 # equal).
1165 dt1 = self.theclass(MAXYEAR, 12, 31, 23, 59, 59, 999998)
1166 us = timedelta(microseconds=1)
1167 dt2 = dt1 + us
1168 self.assertEqual(dt2 - dt1, us)
1169 self.assert_(dt1 < dt2)
1170
1171 def test_bad_constructor_arguments(self):
1172 # bad years
1173 self.theclass(MINYEAR, 1, 1) # no exception
1174 self.theclass(MAXYEAR, 1, 1) # no exception
1175 self.assertRaises(ValueError, self.theclass, MINYEAR-1, 1, 1)
1176 self.assertRaises(ValueError, self.theclass, MAXYEAR+1, 1, 1)
1177 # bad months
1178 self.theclass(2000, 1, 1) # no exception
1179 self.theclass(2000, 12, 1) # no exception
1180 self.assertRaises(ValueError, self.theclass, 2000, 0, 1)
1181 self.assertRaises(ValueError, self.theclass, 2000, 13, 1)
1182 # bad days
1183 self.theclass(2000, 2, 29) # no exception
1184 self.theclass(2004, 2, 29) # no exception
1185 self.theclass(2400, 2, 29) # no exception
1186 self.assertRaises(ValueError, self.theclass, 2000, 2, 30)
1187 self.assertRaises(ValueError, self.theclass, 2001, 2, 29)
1188 self.assertRaises(ValueError, self.theclass, 2100, 2, 29)
1189 self.assertRaises(ValueError, self.theclass, 1900, 2, 29)
1190 self.assertRaises(ValueError, self.theclass, 2000, 1, 0)
1191 self.assertRaises(ValueError, self.theclass, 2000, 1, 32)
1192 # bad hours
1193 self.theclass(2000, 1, 31, 0) # no exception
1194 self.theclass(2000, 1, 31, 23) # no exception
1195 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, -1)
1196 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, 24)
1197 # bad minutes
1198 self.theclass(2000, 1, 31, 23, 0) # no exception
1199 self.theclass(2000, 1, 31, 23, 59) # no exception
1200 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, 23, -1)
1201 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, 23, 60)
1202 # bad seconds
1203 self.theclass(2000, 1, 31, 23, 59, 0) # no exception
1204 self.theclass(2000, 1, 31, 23, 59, 59) # no exception
1205 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, 23, 59, -1)
1206 self.assertRaises(ValueError, self.theclass, 2000, 1, 31, 23, 59, 60)
1207 # bad microseconds
1208 self.theclass(2000, 1, 31, 23, 59, 59, 0) # no exception
1209 self.theclass(2000, 1, 31, 23, 59, 59, 999999) # no exception
1210 self.assertRaises(ValueError, self.theclass,
1211 2000, 1, 31, 23, 59, 59, -1)
1212 self.assertRaises(ValueError, self.theclass,
1213 2000, 1, 31, 23, 59, 59,
1214 1000000)
1215
1216 def test_hash_equality(self):
1217 d = self.theclass(2000, 12, 31, 23, 30, 17)
1218 e = self.theclass(2000, 12, 31, 23, 30, 17)
1219 self.assertEqual(d, e)
1220 self.assertEqual(hash(d), hash(e))
1221
1222 dic = {d: 1}
1223 dic[e] = 2
1224 self.assertEqual(len(dic), 1)
1225 self.assertEqual(dic[d], 2)
1226 self.assertEqual(dic[e], 2)
1227
1228 d = self.theclass(2001, 1, 1, 0, 5, 17)
1229 e = self.theclass(2001, 1, 1, 0, 5, 17)
1230 self.assertEqual(d, e)
1231 self.assertEqual(hash(d), hash(e))
1232
1233 dic = {d: 1}
1234 dic[e] = 2
1235 self.assertEqual(len(dic), 1)
1236 self.assertEqual(dic[d], 2)
1237 self.assertEqual(dic[e], 2)
1238
1239 def test_computations(self):
1240 a = self.theclass(2002, 1, 31)
1241 b = self.theclass(1956, 1, 31)
1242 diff = a-b
1243 self.assertEqual(diff.days, 46*365 + len(range(1956, 2002, 4)))
1244 self.assertEqual(diff.seconds, 0)
1245 self.assertEqual(diff.microseconds, 0)
1246 a = self.theclass(2002, 3, 2, 17, 6)
1247 millisec = timedelta(0, 0, 1000)
1248 hour = timedelta(0, 3600)
1249 day = timedelta(1)
1250 week = timedelta(7)
1251 self.assertEqual(a + hour, self.theclass(2002, 3, 2, 18, 6))
1252 self.assertEqual(hour + a, self.theclass(2002, 3, 2, 18, 6))
1253 self.assertEqual(a + 10*hour, self.theclass(2002, 3, 3, 3, 6))
1254 self.assertEqual(a - hour, self.theclass(2002, 3, 2, 16, 6))
1255 self.assertEqual(-hour + a, self.theclass(2002, 3, 2, 16, 6))
1256 self.assertEqual(a - hour, a + -hour)
1257 self.assertEqual(a - 20*hour, self.theclass(2002, 3, 1, 21, 6))
1258 self.assertEqual(a + day, self.theclass(2002, 3, 3, 17, 6))
1259 self.assertEqual(a - day, self.theclass(2002, 3, 1, 17, 6))
1260 self.assertEqual(a + week, self.theclass(2002, 3, 9, 17, 6))
1261 self.assertEqual(a - week, self.theclass(2002, 2, 23, 17, 6))
1262 self.assertEqual(a + 52*week, self.theclass(2003, 3, 1, 17, 6))
1263 self.assertEqual(a - 52*week, self.theclass(2001, 3, 3, 17, 6))
1264 self.assertEqual((a + week) - a, week)
1265 self.assertEqual((a + day) - a, day)
1266 self.assertEqual((a + hour) - a, hour)
1267 self.assertEqual((a + millisec) - a, millisec)
1268 self.assertEqual((a - week) - a, -week)
1269 self.assertEqual((a - day) - a, -day)
1270 self.assertEqual((a - hour) - a, -hour)
1271 self.assertEqual((a - millisec) - a, -millisec)
1272 self.assertEqual(a - (a + week), -week)
1273 self.assertEqual(a - (a + day), -day)
1274 self.assertEqual(a - (a + hour), -hour)
1275 self.assertEqual(a - (a + millisec), -millisec)
1276 self.assertEqual(a - (a - week), week)
1277 self.assertEqual(a - (a - day), day)
1278 self.assertEqual(a - (a - hour), hour)
1279 self.assertEqual(a - (a - millisec), millisec)
1280 self.assertEqual(a + (week + day + hour + millisec),
1281 self.theclass(2002, 3, 10, 18, 6, 0, 1000))
1282 self.assertEqual(a + (week + day + hour + millisec),
1283 (((a + week) + day) + hour) + millisec)
1284 self.assertEqual(a - (week + day + hour + millisec),
1285 self.theclass(2002, 2, 22, 16, 5, 59, 999000))
1286 self.assertEqual(a - (week + day + hour + millisec),
1287 (((a - week) - day) - hour) - millisec)
1288 # Add/sub ints, longs, floats should be illegal
1289 for i in 1, 1L, 1.0:
1290 self.assertRaises(TypeError, lambda: a+i)
1291 self.assertRaises(TypeError, lambda: a-i)
1292 self.assertRaises(TypeError, lambda: i+a)
1293 self.assertRaises(TypeError, lambda: i-a)
1294
1295 # delta - datetime is senseless.
1296 self.assertRaises(TypeError, lambda: day - a)
1297 # mixing datetime and (delta or datetime) via * or // is senseless
1298 self.assertRaises(TypeError, lambda: day * a)
1299 self.assertRaises(TypeError, lambda: a * day)
1300 self.assertRaises(TypeError, lambda: day // a)
1301 self.assertRaises(TypeError, lambda: a // day)
1302 self.assertRaises(TypeError, lambda: a * a)
1303 self.assertRaises(TypeError, lambda: a // a)
1304 # datetime + datetime is senseless
1305 self.assertRaises(TypeError, lambda: a + a)
1306
1307 def test_pickling(self):
1308 args = 6, 7, 23, 20, 59, 1, 64**2
1309 orig = self.theclass(*args)
1310 for pickler, unpickler, proto in pickle_choices:
1311 green = pickler.dumps(orig, proto)
1312 derived = unpickler.loads(green)
1313 self.assertEqual(orig, derived)
1314
1315 def test_more_pickling(self):
1316 a = self.theclass(2003, 2, 7, 16, 48, 37, 444116)
1317 s = pickle.dumps(a)
1318 b = pickle.loads(s)
1319 self.assertEqual(b.year, 2003)
1320 self.assertEqual(b.month, 2)
1321 self.assertEqual(b.day, 7)
1322
1323 def test_pickling_subclass_datetime(self):
1324 args = 6, 7, 23, 20, 59, 1, 64**2
1325 orig = SubclassDatetime(*args)
1326 for pickler, unpickler, proto in pickle_choices:
1327 green = pickler.dumps(orig, proto)
1328 derived = unpickler.loads(green)
1329 self.assertEqual(orig, derived)
1330
1331 def test_more_compare(self):
1332 # The test_compare() inherited from TestDate covers the error cases.
1333 # We just want to test lexicographic ordering on the members datetime
1334 # has that date lacks.
1335 args = [2000, 11, 29, 20, 58, 16, 999998]
1336 t1 = self.theclass(*args)
1337 t2 = self.theclass(*args)
1338 self.failUnless(t1 == t2)
1339 self.failUnless(t1 <= t2)
1340 self.failUnless(t1 >= t2)
1341 self.failUnless(not t1 != t2)
1342 self.failUnless(not t1 < t2)
1343 self.failUnless(not t1 > t2)
1344 self.assertEqual(cmp(t1, t2), 0)
1345 self.assertEqual(cmp(t2, t1), 0)
1346
1347 for i in range(len(args)):
1348 newargs = args[:]
1349 newargs[i] = args[i] + 1
1350 t2 = self.theclass(*newargs) # this is larger than t1
1351 self.failUnless(t1 < t2)
1352 self.failUnless(t2 > t1)
1353 self.failUnless(t1 <= t2)
1354 self.failUnless(t2 >= t1)
1355 self.failUnless(t1 != t2)
1356 self.failUnless(t2 != t1)
1357 self.failUnless(not t1 == t2)
1358 self.failUnless(not t2 == t1)
1359 self.failUnless(not t1 > t2)
1360 self.failUnless(not t2 < t1)
1361 self.failUnless(not t1 >= t2)
1362 self.failUnless(not t2 <= t1)
1363 self.assertEqual(cmp(t1, t2), -1)
1364 self.assertEqual(cmp(t2, t1), 1)
1365
1366
1367 # A helper for timestamp constructor tests.
1368 def verify_field_equality(self, expected, got):
1369 self.assertEqual(expected.tm_year, got.year)
1370 self.assertEqual(expected.tm_mon, got.month)
1371 self.assertEqual(expected.tm_mday, got.day)
1372 self.assertEqual(expected.tm_hour, got.hour)
1373 self.assertEqual(expected.tm_min, got.minute)
1374 self.assertEqual(expected.tm_sec, got.second)
1375
1376 def test_fromtimestamp(self):
1377 import time
1378
1379 ts = time.time()
1380 expected = time.localtime(ts)
1381 got = self.theclass.fromtimestamp(ts)
1382 self.verify_field_equality(expected, got)
1383
1384 def test_utcfromtimestamp(self):
1385 import time
1386
1387 ts = time.time()
1388 expected = time.gmtime(ts)
1389 got = self.theclass.utcfromtimestamp(ts)
1390 self.verify_field_equality(expected, got)
1391
1392 def test_insane_fromtimestamp(self):
1393 # It's possible that some platform maps time_t to double,
1394 # and that this test will fail there. This test should
1395 # exempt such platforms (provided they return reasonable
1396 # results!).
1397 for insane in -1e200, 1e200:
1398 self.assertRaises(ValueError, self.theclass.fromtimestamp,
1399 insane)
1400
1401 def test_insane_utcfromtimestamp(self):
1402 # It's possible that some platform maps time_t to double,
1403 # and that this test will fail there. This test should
1404 # exempt such platforms (provided they return reasonable
1405 # results!).
1406 for insane in -1e200, 1e200:
1407 self.assertRaises(ValueError, self.theclass.utcfromtimestamp,
1408 insane)
1409
1410 def test_utcnow(self):
1411 import time
1412
1413 # Call it a success if utcnow() and utcfromtimestamp() are within
1414 # a second of each other.
1415 tolerance = timedelta(seconds=1)
1416 for dummy in range(3):
1417 from_now = self.theclass.utcnow()
1418 from_timestamp = self.theclass.utcfromtimestamp(time.time())
1419 if abs(from_timestamp - from_now) <= tolerance:
1420 break
1421 # Else try again a few times.
1422 self.failUnless(abs(from_timestamp - from_now) <= tolerance)
1423
1424 def test_more_timetuple(self):
1425 # This tests fields beyond those tested by the TestDate.test_timetuple.
1426 t = self.theclass(2004, 12, 31, 6, 22, 33)
1427 self.assertEqual(t.timetuple(), (2004, 12, 31, 6, 22, 33, 4, 366, -1))
1428 self.assertEqual(t.timetuple(),
1429 (t.year, t.month, t.day,
1430 t.hour, t.minute, t.second,
1431 t.weekday(),
1432 t.toordinal() - date(t.year, 1, 1).toordinal() + 1,
1433 -1))
1434 tt = t.timetuple()
1435 self.assertEqual(tt.tm_year, t.year)
1436 self.assertEqual(tt.tm_mon, t.month)
1437 self.assertEqual(tt.tm_mday, t.day)
1438 self.assertEqual(tt.tm_hour, t.hour)
1439 self.assertEqual(tt.tm_min, t.minute)
1440 self.assertEqual(tt.tm_sec, t.second)
1441 self.assertEqual(tt.tm_wday, t.weekday())
1442 self.assertEqual(tt.tm_yday, t.toordinal() -
1443 date(t.year, 1, 1).toordinal() + 1)
1444 self.assertEqual(tt.tm_isdst, -1)
1445
1446 def test_more_strftime(self):
1447 # This tests fields beyond those tested by the TestDate.test_strftime.
1448 t = self.theclass(2004, 12, 31, 6, 22, 33)
1449 self.assertEqual(t.strftime("%m %d %y %S %M %H %j"),
1450 "12 31 04 33 22 06 366")
1451
1452 def test_extract(self):
1453 dt = self.theclass(2002, 3, 4, 18, 45, 3, 1234)
1454 self.assertEqual(dt.date(), date(2002, 3, 4))
1455 self.assertEqual(dt.time(), time(18, 45, 3, 1234))
1456
1457 def test_combine(self):
1458 d = date(2002, 3, 4)
1459 t = time(18, 45, 3, 1234)
1460 expected = self.theclass(2002, 3, 4, 18, 45, 3, 1234)
1461 combine = self.theclass.combine
1462 dt = combine(d, t)
1463 self.assertEqual(dt, expected)
1464
1465 dt = combine(time=t, date=d)
1466 self.assertEqual(dt, expected)
1467
1468 self.assertEqual(d, dt.date())
1469 self.assertEqual(t, dt.time())
1470 self.assertEqual(dt, combine(dt.date(), dt.time()))
1471
1472 self.assertRaises(TypeError, combine) # need an arg
1473 self.assertRaises(TypeError, combine, d) # need two args
1474 self.assertRaises(TypeError, combine, t, d) # args reversed
1475 self.assertRaises(TypeError, combine, d, t, 1) # too many args
1476 self.assertRaises(TypeError, combine, "date", "time") # wrong types
1477
1478 def test_replace(self):
1479 cls = self.theclass
1480 args = [1, 2, 3, 4, 5, 6, 7]
1481 base = cls(*args)
1482 self.assertEqual(base, base.replace())
1483
1484 i = 0
1485 for name, newval in (("year", 2),
1486 ("month", 3),
1487 ("day", 4),
1488 ("hour", 5),
1489 ("minute", 6),
1490 ("second", 7),
1491 ("microsecond", 8)):
1492 newargs = args[:]
1493 newargs[i] = newval
1494 expected = cls(*newargs)
1495 got = base.replace(**{name: newval})
1496 self.assertEqual(expected, got)
1497 i += 1
1498
1499 # Out of bounds.
1500 base = cls(2000, 2, 29)
1501 self.assertRaises(ValueError, base.replace, year=2001)
1502
1503 def test_astimezone(self):
1504 # Pretty boring! The TZ test is more interesting here. astimezone()
1505 # simply can't be applied to a naive object.
1506 dt = self.theclass.now()
1507 f = FixedOffset(44, "")
1508 self.assertRaises(TypeError, dt.astimezone) # not enough args
1509 self.assertRaises(TypeError, dt.astimezone, f, f) # too many args
1510 self.assertRaises(TypeError, dt.astimezone, dt) # arg wrong type
1511 self.assertRaises(ValueError, dt.astimezone, f) # naive
1512 self.assertRaises(ValueError, dt.astimezone, tz=f) # naive
1513
1514 class Bogus(tzinfo):
1515 def utcoffset(self, dt): return None
1516 def dst(self, dt): return timedelta(0)
1517 bog = Bogus()
1518 self.assertRaises(ValueError, dt.astimezone, bog) # naive
1519
1520 class AlsoBogus(tzinfo):
1521 def utcoffset(self, dt): return timedelta(0)
1522 def dst(self, dt): return None
1523 alsobog = AlsoBogus()
1524 self.assertRaises(ValueError, dt.astimezone, alsobog) # also naive
1525
1526 def test_subclass_datetime(self):
1527
1528 class C(self.theclass):
1529 theAnswer = 42
1530
1531 def __new__(cls, *args, **kws):
1532 temp = kws.copy()
1533 extra = temp.pop('extra')
1534 result = self.theclass.__new__(cls, *args, **temp)
1535 result.extra = extra
1536 return result
1537
1538 def newmeth(self, start):
1539 return start + self.year + self.month + self.second
1540
1541 args = 2003, 4, 14, 12, 13, 41
1542
1543 dt1 = self.theclass(*args)
1544 dt2 = C(*args, **{'extra': 7})
1545
1546 self.assertEqual(dt2.__class__, C)
1547 self.assertEqual(dt2.theAnswer, 42)
1548 self.assertEqual(dt2.extra, 7)
1549 self.assertEqual(dt1.toordinal(), dt2.toordinal())
1550 self.assertEqual(dt2.newmeth(-7), dt1.year + dt1.month +
1551 dt1.second - 7)
1552
1553class SubclassTime(time):
1554 sub_var = 1
1555
1556class TestTime(HarmlessMixedComparison):
1557
1558 theclass = time
1559
1560 def test_basic_attributes(self):
1561 t = self.theclass(12, 0)
1562 self.assertEqual(t.hour, 12)
1563 self.assertEqual(t.minute, 0)
1564 self.assertEqual(t.second, 0)
1565 self.assertEqual(t.microsecond, 0)
1566
1567 def test_basic_attributes_nonzero(self):
1568 # Make sure all attributes are non-zero so bugs in
1569 # bit-shifting access show up.
1570 t = self.theclass(12, 59, 59, 8000)
1571 self.assertEqual(t.hour, 12)
1572 self.assertEqual(t.minute, 59)
1573 self.assertEqual(t.second, 59)
1574 self.assertEqual(t.microsecond, 8000)
1575
1576 def test_roundtrip(self):
1577 t = self.theclass(1, 2, 3, 4)
1578
1579 # Verify t -> string -> time identity.
1580 s = repr(t)
1581 self.failUnless(s.startswith('datetime.'))
1582 s = s[9:]
1583 t2 = eval(s)
1584 self.assertEqual(t, t2)
1585
1586 # Verify identity via reconstructing from pieces.
1587 t2 = self.theclass(t.hour, t.minute, t.second,
1588 t.microsecond)
1589 self.assertEqual(t, t2)
1590
1591 def test_comparing(self):
1592 args = [1, 2, 3, 4]
1593 t1 = self.theclass(*args)
1594 t2 = self.theclass(*args)
1595 self.failUnless(t1 == t2)
1596 self.failUnless(t1 <= t2)
1597 self.failUnless(t1 >= t2)
1598 self.failUnless(not t1 != t2)
1599 self.failUnless(not t1 < t2)
1600 self.failUnless(not t1 > t2)
1601 self.assertEqual(cmp(t1, t2), 0)
1602 self.assertEqual(cmp(t2, t1), 0)
1603
1604 for i in range(len(args)):
1605 newargs = args[:]
1606 newargs[i] = args[i] + 1
1607 t2 = self.theclass(*newargs) # this is larger than t1
1608 self.failUnless(t1 < t2)
1609 self.failUnless(t2 > t1)
1610 self.failUnless(t1 <= t2)
1611 self.failUnless(t2 >= t1)
1612 self.failUnless(t1 != t2)
1613 self.failUnless(t2 != t1)
1614 self.failUnless(not t1 == t2)
1615 self.failUnless(not t2 == t1)
1616 self.failUnless(not t1 > t2)
1617 self.failUnless(not t2 < t1)
1618 self.failUnless(not t1 >= t2)
1619 self.failUnless(not t2 <= t1)
1620 self.assertEqual(cmp(t1, t2), -1)
1621 self.assertEqual(cmp(t2, t1), 1)
1622
1623 for badarg in OTHERSTUFF:
1624 self.assertEqual(t1 == badarg, False)
1625 self.assertEqual(t1 != badarg, True)
1626 self.assertEqual(badarg == t1, False)
1627 self.assertEqual(badarg != t1, True)
1628
1629 self.assertRaises(TypeError, lambda: t1 <= badarg)
1630 self.assertRaises(TypeError, lambda: t1 < badarg)
1631 self.assertRaises(TypeError, lambda: t1 > badarg)
1632 self.assertRaises(TypeError, lambda: t1 >= badarg)
1633 self.assertRaises(TypeError, lambda: badarg <= t1)
1634 self.assertRaises(TypeError, lambda: badarg < t1)
1635 self.assertRaises(TypeError, lambda: badarg > t1)
1636 self.assertRaises(TypeError, lambda: badarg >= t1)
1637
1638 def test_bad_constructor_arguments(self):
1639 # bad hours
1640 self.theclass(0, 0) # no exception
1641 self.theclass(23, 0) # no exception
1642 self.assertRaises(ValueError, self.theclass, -1, 0)
1643 self.assertRaises(ValueError, self.theclass, 24, 0)
1644 # bad minutes
1645 self.theclass(23, 0) # no exception
1646 self.theclass(23, 59) # no exception
1647 self.assertRaises(ValueError, self.theclass, 23, -1)
1648 self.assertRaises(ValueError, self.theclass, 23, 60)
1649 # bad seconds
1650 self.theclass(23, 59, 0) # no exception
1651 self.theclass(23, 59, 59) # no exception
1652 self.assertRaises(ValueError, self.theclass, 23, 59, -1)
1653 self.assertRaises(ValueError, self.theclass, 23, 59, 60)
1654 # bad microseconds
1655 self.theclass(23, 59, 59, 0) # no exception
1656 self.theclass(23, 59, 59, 999999) # no exception
1657 self.assertRaises(ValueError, self.theclass, 23, 59, 59, -1)
1658 self.assertRaises(ValueError, self.theclass, 23, 59, 59, 1000000)
1659
1660 def test_hash_equality(self):
1661 d = self.theclass(23, 30, 17)
1662 e = self.theclass(23, 30, 17)
1663 self.assertEqual(d, e)
1664 self.assertEqual(hash(d), hash(e))
1665
1666 dic = {d: 1}
1667 dic[e] = 2
1668 self.assertEqual(len(dic), 1)
1669 self.assertEqual(dic[d], 2)
1670 self.assertEqual(dic[e], 2)
1671
1672 d = self.theclass(0, 5, 17)
1673 e = self.theclass(0, 5, 17)
1674 self.assertEqual(d, e)
1675 self.assertEqual(hash(d), hash(e))
1676
1677 dic = {d: 1}
1678 dic[e] = 2
1679 self.assertEqual(len(dic), 1)
1680 self.assertEqual(dic[d], 2)
1681 self.assertEqual(dic[e], 2)
1682
1683 def test_isoformat(self):
1684 t = self.theclass(4, 5, 1, 123)
1685 self.assertEqual(t.isoformat(), "04:05:01.000123")
1686 self.assertEqual(t.isoformat(), str(t))
1687
1688 t = self.theclass()
1689 self.assertEqual(t.isoformat(), "00:00:00")
1690 self.assertEqual(t.isoformat(), str(t))
1691
1692 t = self.theclass(microsecond=1)
1693 self.assertEqual(t.isoformat(), "00:00:00.000001")
1694 self.assertEqual(t.isoformat(), str(t))
1695
1696 t = self.theclass(microsecond=10)
1697 self.assertEqual(t.isoformat(), "00:00:00.000010")
1698 self.assertEqual(t.isoformat(), str(t))
1699
1700 t = self.theclass(microsecond=100)
1701 self.assertEqual(t.isoformat(), "00:00:00.000100")
1702 self.assertEqual(t.isoformat(), str(t))
1703
1704 t = self.theclass(microsecond=1000)
1705 self.assertEqual(t.isoformat(), "00:00:00.001000")
1706 self.assertEqual(t.isoformat(), str(t))
1707
1708 t = self.theclass(microsecond=10000)
1709 self.assertEqual(t.isoformat(), "00:00:00.010000")
1710 self.assertEqual(t.isoformat(), str(t))
1711
1712 t = self.theclass(microsecond=100000)
1713 self.assertEqual(t.isoformat(), "00:00:00.100000")
1714 self.assertEqual(t.isoformat(), str(t))
1715
1716 def test_strftime(self):
1717 t = self.theclass(1, 2, 3, 4)
1718 self.assertEqual(t.strftime('%H %M %S'), "01 02 03")
1719 # A naive object replaces %z and %Z with empty strings.
1720 self.assertEqual(t.strftime("'%z' '%Z'"), "'' ''")
1721
1722 def test_str(self):
1723 self.assertEqual(str(self.theclass(1, 2, 3, 4)), "01:02:03.000004")
1724 self.assertEqual(str(self.theclass(10, 2, 3, 4000)), "10:02:03.004000")
1725 self.assertEqual(str(self.theclass(0, 2, 3, 400000)), "00:02:03.400000")
1726 self.assertEqual(str(self.theclass(12, 2, 3, 0)), "12:02:03")
1727 self.assertEqual(str(self.theclass(23, 15, 0, 0)), "23:15:00")
1728
1729 def test_repr(self):
1730 name = 'datetime.' + self.theclass.__name__
1731 self.assertEqual(repr(self.theclass(1, 2, 3, 4)),
1732 "%s(1, 2, 3, 4)" % name)
1733 self.assertEqual(repr(self.theclass(10, 2, 3, 4000)),
1734 "%s(10, 2, 3, 4000)" % name)
1735 self.assertEqual(repr(self.theclass(0, 2, 3, 400000)),
1736 "%s(0, 2, 3, 400000)" % name)
1737 self.assertEqual(repr(self.theclass(12, 2, 3, 0)),
1738 "%s(12, 2, 3)" % name)
1739 self.assertEqual(repr(self.theclass(23, 15, 0, 0)),
1740 "%s(23, 15)" % name)
1741
1742 def test_resolution_info(self):
1743 self.assert_(isinstance(self.theclass.min, self.theclass))
1744 self.assert_(isinstance(self.theclass.max, self.theclass))
1745 self.assert_(isinstance(self.theclass.resolution, timedelta))
1746 self.assert_(self.theclass.max > self.theclass.min)
1747
1748 def test_pickling(self):
1749 args = 20, 59, 16, 64**2
1750 orig = self.theclass(*args)
1751 for pickler, unpickler, proto in pickle_choices:
1752 green = pickler.dumps(orig, proto)
1753 derived = unpickler.loads(green)
1754 self.assertEqual(orig, derived)
1755
1756 def test_pickling_subclass_time(self):
1757 args = 20, 59, 16, 64**2
1758 orig = SubclassTime(*args)
1759 for pickler, unpickler, proto in pickle_choices:
1760 green = pickler.dumps(orig, proto)
1761 derived = unpickler.loads(green)
1762 self.assertEqual(orig, derived)
1763
1764 def test_bool(self):
1765 cls = self.theclass
1766 self.failUnless(cls(1))
1767 self.failUnless(cls(0, 1))
1768 self.failUnless(cls(0, 0, 1))
1769 self.failUnless(cls(0, 0, 0, 1))
1770 self.failUnless(not cls(0))
1771 self.failUnless(not cls())
1772
1773 def test_replace(self):
1774 cls = self.theclass
1775 args = [1, 2, 3, 4]
1776 base = cls(*args)
1777 self.assertEqual(base, base.replace())
1778
1779 i = 0
1780 for name, newval in (("hour", 5),
1781 ("minute", 6),
1782 ("second", 7),
1783 ("microsecond", 8)):
1784 newargs = args[:]
1785 newargs[i] = newval
1786 expected = cls(*newargs)
1787 got = base.replace(**{name: newval})
1788 self.assertEqual(expected, got)
1789 i += 1
1790
1791 # Out of bounds.
1792 base = cls(1)
1793 self.assertRaises(ValueError, base.replace, hour=24)
1794 self.assertRaises(ValueError, base.replace, minute=-1)
1795 self.assertRaises(ValueError, base.replace, second=100)
1796 self.assertRaises(ValueError, base.replace, microsecond=1000000)
1797
1798 def test_subclass_time(self):
1799
1800 class C(self.theclass):
1801 theAnswer = 42
1802
1803 def __new__(cls, *args, **kws):
1804 temp = kws.copy()
1805 extra = temp.pop('extra')
1806 result = self.theclass.__new__(cls, *args, **temp)
1807 result.extra = extra
1808 return result
1809
1810 def newmeth(self, start):
1811 return start + self.hour + self.second
1812
1813 args = 4, 5, 6
1814
1815 dt1 = self.theclass(*args)
1816 dt2 = C(*args, **{'extra': 7})
1817
1818 self.assertEqual(dt2.__class__, C)
1819 self.assertEqual(dt2.theAnswer, 42)
1820 self.assertEqual(dt2.extra, 7)
1821 self.assertEqual(dt1.isoformat(), dt2.isoformat())
1822 self.assertEqual(dt2.newmeth(-7), dt1.hour + dt1.second - 7)
1823
1824# A mixin for classes with a tzinfo= argument. Subclasses must define
1825# theclass as a class atribute, and theclass(1, 1, 1, tzinfo=whatever)
1826# must be legit (which is true for time and datetime).
1827class TZInfoBase(unittest.TestCase):
1828
1829 def test_argument_passing(self):
1830 cls = self.theclass
1831 # A datetime passes itself on, a time passes None.
1832 class introspective(tzinfo):
1833 def tzname(self, dt): return dt and "real" or "none"
1834 def utcoffset(self, dt):
1835 return timedelta(minutes = dt and 42 or -42)
1836 dst = utcoffset
1837
1838 obj = cls(1, 2, 3, tzinfo=introspective())
1839
1840 expected = cls is time and "none" or "real"
1841 self.assertEqual(obj.tzname(), expected)
1842
1843 expected = timedelta(minutes=(cls is time and -42 or 42))
1844 self.assertEqual(obj.utcoffset(), expected)
1845 self.assertEqual(obj.dst(), expected)
1846
1847 def test_bad_tzinfo_classes(self):
1848 cls = self.theclass
1849 self.assertRaises(TypeError, cls, 1, 1, 1, tzinfo=12)
1850
1851 class NiceTry(object):
1852 def __init__(self): pass
1853 def utcoffset(self, dt): pass
1854 self.assertRaises(TypeError, cls, 1, 1, 1, tzinfo=NiceTry)
1855
1856 class BetterTry(tzinfo):
1857 def __init__(self): pass
1858 def utcoffset(self, dt): pass
1859 b = BetterTry()
1860 t = cls(1, 1, 1, tzinfo=b)
1861 self.failUnless(t.tzinfo is b)
1862
1863 def test_utc_offset_out_of_bounds(self):
1864 class Edgy(tzinfo):
1865 def __init__(self, offset):
1866 self.offset = timedelta(minutes=offset)
1867 def utcoffset(self, dt):
1868 return self.offset
1869
1870 cls = self.theclass
1871 for offset, legit in ((-1440, False),
1872 (-1439, True),
1873 (1439, True),
1874 (1440, False)):
1875 if cls is time:
1876 t = cls(1, 2, 3, tzinfo=Edgy(offset))
1877 elif cls is datetime:
1878 t = cls(6, 6, 6, 1, 2, 3, tzinfo=Edgy(offset))
1879 else:
1880 assert 0, "impossible"
1881 if legit:
1882 aofs = abs(offset)
1883 h, m = divmod(aofs, 60)
1884 tag = "%c%02d:%02d" % (offset < 0 and '-' or '+', h, m)
1885 if isinstance(t, datetime):
1886 t = t.timetz()
1887 self.assertEqual(str(t), "01:02:03" + tag)
1888 else:
1889 self.assertRaises(ValueError, str, t)
1890
1891 def test_tzinfo_classes(self):
1892 cls = self.theclass
1893 class C1(tzinfo):
1894 def utcoffset(self, dt): return None
1895 def dst(self, dt): return None
1896 def tzname(self, dt): return None
1897 for t in (cls(1, 1, 1),
1898 cls(1, 1, 1, tzinfo=None),
1899 cls(1, 1, 1, tzinfo=C1())):
1900 self.failUnless(t.utcoffset() is None)
1901 self.failUnless(t.dst() is None)
1902 self.failUnless(t.tzname() is None)
1903
1904 class C3(tzinfo):
1905 def utcoffset(self, dt): return timedelta(minutes=-1439)
1906 def dst(self, dt): return timedelta(minutes=1439)
1907 def tzname(self, dt): return "aname"
1908 t = cls(1, 1, 1, tzinfo=C3())
1909 self.assertEqual(t.utcoffset(), timedelta(minutes=-1439))
1910 self.assertEqual(t.dst(), timedelta(minutes=1439))
1911 self.assertEqual(t.tzname(), "aname")
1912
1913 # Wrong types.
1914 class C4(tzinfo):
1915 def utcoffset(self, dt): return "aname"
1916 def dst(self, dt): return 7
1917 def tzname(self, dt): return 0
1918 t = cls(1, 1, 1, tzinfo=C4())
1919 self.assertRaises(TypeError, t.utcoffset)
1920 self.assertRaises(TypeError, t.dst)
1921 self.assertRaises(TypeError, t.tzname)
1922
1923 # Offset out of range.
1924 class C6(tzinfo):
1925 def utcoffset(self, dt): return timedelta(hours=-24)
1926 def dst(self, dt): return timedelta(hours=24)
1927 t = cls(1, 1, 1, tzinfo=C6())
1928 self.assertRaises(ValueError, t.utcoffset)
1929 self.assertRaises(ValueError, t.dst)
1930
1931 # Not a whole number of minutes.
1932 class C7(tzinfo):
1933 def utcoffset(self, dt): return timedelta(seconds=61)
1934 def dst(self, dt): return timedelta(microseconds=-81)
1935 t = cls(1, 1, 1, tzinfo=C7())
1936 self.assertRaises(ValueError, t.utcoffset)
1937 self.assertRaises(ValueError, t.dst)
1938
1939 def test_aware_compare(self):
1940 cls = self.theclass
1941
1942 # Ensure that utcoffset() gets ignored if the comparands have
1943 # the same tzinfo member.
1944 class OperandDependentOffset(tzinfo):
1945 def utcoffset(self, t):
1946 if t.minute < 10:
1947 # d0 and d1 equal after adjustment
1948 return timedelta(minutes=t.minute)
1949 else:
1950 # d2 off in the weeds
1951 return timedelta(minutes=59)
1952
1953 base = cls(8, 9, 10, tzinfo=OperandDependentOffset())
1954 d0 = base.replace(minute=3)
1955 d1 = base.replace(minute=9)
1956 d2 = base.replace(minute=11)
1957 for x in d0, d1, d2:
1958 for y in d0, d1, d2:
1959 got = cmp(x, y)
1960 expected = cmp(x.minute, y.minute)
1961 self.assertEqual(got, expected)
1962
1963 # However, if they're different members, uctoffset is not ignored.
1964 # Note that a time can't actually have an operand-depedent offset,
1965 # though (and time.utcoffset() passes None to tzinfo.utcoffset()),
1966 # so skip this test for time.
1967 if cls is not time:
1968 d0 = base.replace(minute=3, tzinfo=OperandDependentOffset())
1969 d1 = base.replace(minute=9, tzinfo=OperandDependentOffset())
1970 d2 = base.replace(minute=11, tzinfo=OperandDependentOffset())
1971 for x in d0, d1, d2:
1972 for y in d0, d1, d2:
1973 got = cmp(x, y)
1974 if (x is d0 or x is d1) and (y is d0 or y is d1):
1975 expected = 0
1976 elif x is y is d2:
1977 expected = 0
1978 elif x is d2:
1979 expected = -1
1980 else:
1981 assert y is d2
1982 expected = 1
1983 self.assertEqual(got, expected)
1984
1985
1986# Testing time objects with a non-None tzinfo.
1987class TestTimeTZ(TestTime, TZInfoBase):
1988 theclass = time
1989
1990 def test_empty(self):
1991 t = self.theclass()
1992 self.assertEqual(t.hour, 0)
1993 self.assertEqual(t.minute, 0)
1994 self.assertEqual(t.second, 0)
1995 self.assertEqual(t.microsecond, 0)
1996 self.failUnless(t.tzinfo is None)
1997
1998 def test_zones(self):
1999 est = FixedOffset(-300, "EST", 1)
2000 utc = FixedOffset(0, "UTC", -2)
2001 met = FixedOffset(60, "MET", 3)
2002 t1 = time( 7, 47, tzinfo=est)
2003 t2 = time(12, 47, tzinfo=utc)
2004 t3 = time(13, 47, tzinfo=met)
2005 t4 = time(microsecond=40)
2006 t5 = time(microsecond=40, tzinfo=utc)
2007
2008 self.assertEqual(t1.tzinfo, est)
2009 self.assertEqual(t2.tzinfo, utc)
2010 self.assertEqual(t3.tzinfo, met)
2011 self.failUnless(t4.tzinfo is None)
2012 self.assertEqual(t5.tzinfo, utc)
2013
2014 self.assertEqual(t1.utcoffset(), timedelta(minutes=-300))
2015 self.assertEqual(t2.utcoffset(), timedelta(minutes=0))
2016 self.assertEqual(t3.utcoffset(), timedelta(minutes=60))
2017 self.failUnless(t4.utcoffset() is None)
2018 self.assertRaises(TypeError, t1.utcoffset, "no args")
2019
2020 self.assertEqual(t1.tzname(), "EST")
2021 self.assertEqual(t2.tzname(), "UTC")
2022 self.assertEqual(t3.tzname(), "MET")
2023 self.failUnless(t4.tzname() is None)
2024 self.assertRaises(TypeError, t1.tzname, "no args")
2025
2026 self.assertEqual(t1.dst(), timedelta(minutes=1))
2027 self.assertEqual(t2.dst(), timedelta(minutes=-2))
2028 self.assertEqual(t3.dst(), timedelta(minutes=3))
2029 self.failUnless(t4.dst() is None)
2030 self.assertRaises(TypeError, t1.dst, "no args")
2031
2032 self.assertEqual(hash(t1), hash(t2))
2033 self.assertEqual(hash(t1), hash(t3))
2034 self.assertEqual(hash(t2), hash(t3))
2035
2036 self.assertEqual(t1, t2)
2037 self.assertEqual(t1, t3)
2038 self.assertEqual(t2, t3)
2039 self.assertRaises(TypeError, lambda: t4 == t5) # mixed tz-aware & naive
2040 self.assertRaises(TypeError, lambda: t4 < t5) # mixed tz-aware & naive
2041 self.assertRaises(TypeError, lambda: t5 < t4) # mixed tz-aware & naive
2042
2043 self.assertEqual(str(t1), "07:47:00-05:00")
2044 self.assertEqual(str(t2), "12:47:00+00:00")
2045 self.assertEqual(str(t3), "13:47:00+01:00")
2046 self.assertEqual(str(t4), "00:00:00.000040")
2047 self.assertEqual(str(t5), "00:00:00.000040+00:00")
2048
2049 self.assertEqual(t1.isoformat(), "07:47:00-05:00")
2050 self.assertEqual(t2.isoformat(), "12:47:00+00:00")
2051 self.assertEqual(t3.isoformat(), "13:47:00+01:00")
2052 self.assertEqual(t4.isoformat(), "00:00:00.000040")
2053 self.assertEqual(t5.isoformat(), "00:00:00.000040+00:00")
2054
2055 d = 'datetime.time'
2056 self.assertEqual(repr(t1), d + "(7, 47, tzinfo=est)")
2057 self.assertEqual(repr(t2), d + "(12, 47, tzinfo=utc)")
2058 self.assertEqual(repr(t3), d + "(13, 47, tzinfo=met)")
2059 self.assertEqual(repr(t4), d + "(0, 0, 0, 40)")
2060 self.assertEqual(repr(t5), d + "(0, 0, 0, 40, tzinfo=utc)")
2061
2062 self.assertEqual(t1.strftime("%H:%M:%S %%Z=%Z %%z=%z"),
2063 "07:47:00 %Z=EST %z=-0500")
2064 self.assertEqual(t2.strftime("%H:%M:%S %Z %z"), "12:47:00 UTC +0000")
2065 self.assertEqual(t3.strftime("%H:%M:%S %Z %z"), "13:47:00 MET +0100")
2066
2067 yuck = FixedOffset(-1439, "%z %Z %%z%%Z")
2068 t1 = time(23, 59, tzinfo=yuck)
2069 self.assertEqual(t1.strftime("%H:%M %%Z='%Z' %%z='%z'"),
2070 "23:59 %Z='%z %Z %%z%%Z' %z='-2359'")
2071
2072 # Check that an invalid tzname result raises an exception.
2073 class Badtzname(tzinfo):
2074 def tzname(self, dt): return 42
2075 t = time(2, 3, 4, tzinfo=Badtzname())
2076 self.assertEqual(t.strftime("%H:%M:%S"), "02:03:04")
2077 self.assertRaises(TypeError, t.strftime, "%Z")
2078
2079 def test_hash_edge_cases(self):
2080 # Offsets that overflow a basic time.
2081 t1 = self.theclass(0, 1, 2, 3, tzinfo=FixedOffset(1439, ""))
2082 t2 = self.theclass(0, 0, 2, 3, tzinfo=FixedOffset(1438, ""))
2083 self.assertEqual(hash(t1), hash(t2))
2084
2085 t1 = self.theclass(23, 58, 6, 100, tzinfo=FixedOffset(-1000, ""))
2086 t2 = self.theclass(23, 48, 6, 100, tzinfo=FixedOffset(-1010, ""))
2087 self.assertEqual(hash(t1), hash(t2))
2088
2089 def test_pickling(self):
2090 # Try one without a tzinfo.
2091 args = 20, 59, 16, 64**2
2092 orig = self.theclass(*args)
2093 for pickler, unpickler, proto in pickle_choices:
2094 green = pickler.dumps(orig, proto)
2095 derived = unpickler.loads(green)
2096 self.assertEqual(orig, derived)
2097
2098 # Try one with a tzinfo.
2099 tinfo = PicklableFixedOffset(-300, 'cookie')
2100 orig = self.theclass(5, 6, 7, tzinfo=tinfo)
2101 for pickler, unpickler, proto in pickle_choices:
2102 green = pickler.dumps(orig, proto)
2103 derived = unpickler.loads(green)
2104 self.assertEqual(orig, derived)
2105 self.failUnless(isinstance(derived.tzinfo, PicklableFixedOffset))
2106 self.assertEqual(derived.utcoffset(), timedelta(minutes=-300))
2107 self.assertEqual(derived.tzname(), 'cookie')
2108
2109 def test_more_bool(self):
2110 # Test cases with non-None tzinfo.
2111 cls = self.theclass
2112
2113 t = cls(0, tzinfo=FixedOffset(-300, ""))
2114 self.failUnless(t)
2115
2116 t = cls(5, tzinfo=FixedOffset(-300, ""))
2117 self.failUnless(t)
2118
2119 t = cls(5, tzinfo=FixedOffset(300, ""))
2120 self.failUnless(not t)
2121
2122 t = cls(23, 59, tzinfo=FixedOffset(23*60 + 59, ""))
2123 self.failUnless(not t)
2124
2125 # Mostly ensuring this doesn't overflow internally.
2126 t = cls(0, tzinfo=FixedOffset(23*60 + 59, ""))
2127 self.failUnless(t)
2128
2129 # But this should yield a value error -- the utcoffset is bogus.
2130 t = cls(0, tzinfo=FixedOffset(24*60, ""))
2131 self.assertRaises(ValueError, lambda: bool(t))
2132
2133 # Likewise.
2134 t = cls(0, tzinfo=FixedOffset(-24*60, ""))
2135 self.assertRaises(ValueError, lambda: bool(t))
2136
2137 def test_replace(self):
2138 cls = self.theclass
2139 z100 = FixedOffset(100, "+100")
2140 zm200 = FixedOffset(timedelta(minutes=-200), "-200")
2141 args = [1, 2, 3, 4, z100]
2142 base = cls(*args)
2143 self.assertEqual(base, base.replace())
2144
2145 i = 0
2146 for name, newval in (("hour", 5),
2147 ("minute", 6),
2148 ("second", 7),
2149 ("microsecond", 8),
2150 ("tzinfo", zm200)):
2151 newargs = args[:]
2152 newargs[i] = newval
2153 expected = cls(*newargs)
2154 got = base.replace(**{name: newval})
2155 self.assertEqual(expected, got)
2156 i += 1
2157
2158 # Ensure we can get rid of a tzinfo.
2159 self.assertEqual(base.tzname(), "+100")
2160 base2 = base.replace(tzinfo=None)
2161 self.failUnless(base2.tzinfo is None)
2162 self.failUnless(base2.tzname() is None)
2163
2164 # Ensure we can add one.
2165 base3 = base2.replace(tzinfo=z100)
2166 self.assertEqual(base, base3)
2167 self.failUnless(base.tzinfo is base3.tzinfo)
2168
2169 # Out of bounds.
2170 base = cls(1)
2171 self.assertRaises(ValueError, base.replace, hour=24)
2172 self.assertRaises(ValueError, base.replace, minute=-1)
2173 self.assertRaises(ValueError, base.replace, second=100)
2174 self.assertRaises(ValueError, base.replace, microsecond=1000000)
2175
2176 def test_mixed_compare(self):
2177 t1 = time(1, 2, 3)
2178 t2 = time(1, 2, 3)
2179 self.assertEqual(t1, t2)
2180 t2 = t2.replace(tzinfo=None)
2181 self.assertEqual(t1, t2)
2182 t2 = t2.replace(tzinfo=FixedOffset(None, ""))
2183 self.assertEqual(t1, t2)
2184 t2 = t2.replace(tzinfo=FixedOffset(0, ""))
2185 self.assertRaises(TypeError, lambda: t1 == t2)
2186
2187 # In time w/ identical tzinfo objects, utcoffset is ignored.
2188 class Varies(tzinfo):
2189 def __init__(self):
2190 self.offset = timedelta(minutes=22)
2191 def utcoffset(self, t):
2192 self.offset += timedelta(minutes=1)
2193 return self.offset
2194
2195 v = Varies()
2196 t1 = t2.replace(tzinfo=v)
2197 t2 = t2.replace(tzinfo=v)
2198 self.assertEqual(t1.utcoffset(), timedelta(minutes=23))
2199 self.assertEqual(t2.utcoffset(), timedelta(minutes=24))
2200 self.assertEqual(t1, t2)
2201
2202 # But if they're not identical, it isn't ignored.
2203 t2 = t2.replace(tzinfo=Varies())
2204 self.failUnless(t1 < t2) # t1's offset counter still going up
2205
2206 def test_subclass_timetz(self):
2207
2208 class C(self.theclass):
2209 theAnswer = 42
2210
2211 def __new__(cls, *args, **kws):
2212 temp = kws.copy()
2213 extra = temp.pop('extra')
2214 result = self.theclass.__new__(cls, *args, **temp)
2215 result.extra = extra
2216 return result
2217
2218 def newmeth(self, start):
2219 return start + self.hour + self.second
2220
2221 args = 4, 5, 6, 500, FixedOffset(-300, "EST", 1)
2222
2223 dt1 = self.theclass(*args)
2224 dt2 = C(*args, **{'extra': 7})
2225
2226 self.assertEqual(dt2.__class__, C)
2227 self.assertEqual(dt2.theAnswer, 42)
2228 self.assertEqual(dt2.extra, 7)
2229 self.assertEqual(dt1.utcoffset(), dt2.utcoffset())
2230 self.assertEqual(dt2.newmeth(-7), dt1.hour + dt1.second - 7)
2231
2232
2233# Testing datetime objects with a non-None tzinfo.
2234
2235class TestDateTimeTZ(TestDateTime, TZInfoBase):
2236 theclass = datetime
2237
2238 def test_trivial(self):
2239 dt = self.theclass(1, 2, 3, 4, 5, 6, 7)
2240 self.assertEqual(dt.year, 1)
2241 self.assertEqual(dt.month, 2)
2242 self.assertEqual(dt.day, 3)
2243 self.assertEqual(dt.hour, 4)
2244 self.assertEqual(dt.minute, 5)
2245 self.assertEqual(dt.second, 6)
2246 self.assertEqual(dt.microsecond, 7)
2247 self.assertEqual(dt.tzinfo, None)
2248
2249 def test_even_more_compare(self):
2250 # The test_compare() and test_more_compare() inherited from TestDate
2251 # and TestDateTime covered non-tzinfo cases.
2252
2253 # Smallest possible after UTC adjustment.
2254 t1 = self.theclass(1, 1, 1, tzinfo=FixedOffset(1439, ""))
2255 # Largest possible after UTC adjustment.
2256 t2 = self.theclass(MAXYEAR, 12, 31, 23, 59, 59, 999999,
2257 tzinfo=FixedOffset(-1439, ""))
2258
2259 # Make sure those compare correctly, and w/o overflow.
2260 self.failUnless(t1 < t2)
2261 self.failUnless(t1 != t2)
2262 self.failUnless(t2 > t1)
2263
2264 self.failUnless(t1 == t1)
2265 self.failUnless(t2 == t2)
2266
2267 # Equal afer adjustment.
2268 t1 = self.theclass(1, 12, 31, 23, 59, tzinfo=FixedOffset(1, ""))
2269 t2 = self.theclass(2, 1, 1, 3, 13, tzinfo=FixedOffset(3*60+13+2, ""))
2270 self.assertEqual(t1, t2)
2271
2272 # Change t1 not to subtract a minute, and t1 should be larger.
2273 t1 = self.theclass(1, 12, 31, 23, 59, tzinfo=FixedOffset(0, ""))
2274 self.failUnless(t1 > t2)
2275
2276 # Change t1 to subtract 2 minutes, and t1 should be smaller.
2277 t1 = self.theclass(1, 12, 31, 23, 59, tzinfo=FixedOffset(2, ""))
2278 self.failUnless(t1 < t2)
2279
2280 # Back to the original t1, but make seconds resolve it.
2281 t1 = self.theclass(1, 12, 31, 23, 59, tzinfo=FixedOffset(1, ""),
2282 second=1)
2283 self.failUnless(t1 > t2)
2284
2285 # Likewise, but make microseconds resolve it.
2286 t1 = self.theclass(1, 12, 31, 23, 59, tzinfo=FixedOffset(1, ""),
2287 microsecond=1)
2288 self.failUnless(t1 > t2)
2289
2290 # Make t2 naive and it should fail.
2291 t2 = self.theclass.min
2292 self.assertRaises(TypeError, lambda: t1 == t2)
2293 self.assertEqual(t2, t2)
2294
2295 # It's also naive if it has tzinfo but tzinfo.utcoffset() is None.
2296 class Naive(tzinfo):
2297 def utcoffset(self, dt): return None
2298 t2 = self.theclass(5, 6, 7, tzinfo=Naive())
2299 self.assertRaises(TypeError, lambda: t1 == t2)
2300 self.assertEqual(t2, t2)
2301
2302 # OTOH, it's OK to compare two of these mixing the two ways of being
2303 # naive.
2304 t1 = self.theclass(5, 6, 7)
2305 self.assertEqual(t1, t2)
2306
2307 # Try a bogus uctoffset.
2308 class Bogus(tzinfo):
2309 def utcoffset(self, dt):
2310 return timedelta(minutes=1440) # out of bounds
2311 t1 = self.theclass(2, 2, 2, tzinfo=Bogus())
2312 t2 = self.theclass(2, 2, 2, tzinfo=FixedOffset(0, ""))
2313 self.assertRaises(ValueError, lambda: t1 == t2)
2314
2315 def test_pickling(self):
2316 # Try one without a tzinfo.
2317 args = 6, 7, 23, 20, 59, 1, 64**2
2318 orig = self.theclass(*args)
2319 for pickler, unpickler, proto in pickle_choices:
2320 green = pickler.dumps(orig, proto)
2321 derived = unpickler.loads(green)
2322 self.assertEqual(orig, derived)
2323
2324 # Try one with a tzinfo.
2325 tinfo = PicklableFixedOffset(-300, 'cookie')
2326 orig = self.theclass(*args, **{'tzinfo': tinfo})
2327 derived = self.theclass(1, 1, 1, tzinfo=FixedOffset(0, "", 0))
2328 for pickler, unpickler, proto in pickle_choices:
2329 green = pickler.dumps(orig, proto)
2330 derived = unpickler.loads(green)
2331 self.assertEqual(orig, derived)
2332 self.failUnless(isinstance(derived.tzinfo,
2333 PicklableFixedOffset))
2334 self.assertEqual(derived.utcoffset(), timedelta(minutes=-300))
2335 self.assertEqual(derived.tzname(), 'cookie')
2336
2337 def test_extreme_hashes(self):
2338 # If an attempt is made to hash these via subtracting the offset
2339 # then hashing a datetime object, OverflowError results. The
2340 # Python implementation used to blow up here.
2341 t = self.theclass(1, 1, 1, tzinfo=FixedOffset(1439, ""))
2342 hash(t)
2343 t = self.theclass(MAXYEAR, 12, 31, 23, 59, 59, 999999,
2344 tzinfo=FixedOffset(-1439, ""))
2345 hash(t)
2346
2347 # OTOH, an OOB offset should blow up.
2348 t = self.theclass(5, 5, 5, tzinfo=FixedOffset(-1440, ""))
2349 self.assertRaises(ValueError, hash, t)
2350
2351 def test_zones(self):
2352 est = FixedOffset(-300, "EST")
2353 utc = FixedOffset(0, "UTC")
2354 met = FixedOffset(60, "MET")
2355 t1 = datetime(2002, 3, 19, 7, 47, tzinfo=est)
2356 t2 = datetime(2002, 3, 19, 12, 47, tzinfo=utc)
2357 t3 = datetime(2002, 3, 19, 13, 47, tzinfo=met)
2358 self.assertEqual(t1.tzinfo, est)
2359 self.assertEqual(t2.tzinfo, utc)
2360 self.assertEqual(t3.tzinfo, met)
2361 self.assertEqual(t1.utcoffset(), timedelta(minutes=-300))
2362 self.assertEqual(t2.utcoffset(), timedelta(minutes=0))
2363 self.assertEqual(t3.utcoffset(), timedelta(minutes=60))
2364 self.assertEqual(t1.tzname(), "EST")
2365 self.assertEqual(t2.tzname(), "UTC")
2366 self.assertEqual(t3.tzname(), "MET")
2367 self.assertEqual(hash(t1), hash(t2))
2368 self.assertEqual(hash(t1), hash(t3))
2369 self.assertEqual(hash(t2), hash(t3))
2370 self.assertEqual(t1, t2)
2371 self.assertEqual(t1, t3)
2372 self.assertEqual(t2, t3)
2373 self.assertEqual(str(t1), "2002-03-19 07:47:00-05:00")
2374 self.assertEqual(str(t2), "2002-03-19 12:47:00+00:00")
2375 self.assertEqual(str(t3), "2002-03-19 13:47:00+01:00")
2376 d = 'datetime.datetime(2002, 3, 19, '
2377 self.assertEqual(repr(t1), d + "7, 47, tzinfo=est)")
2378 self.assertEqual(repr(t2), d + "12, 47, tzinfo=utc)")
2379 self.assertEqual(repr(t3), d + "13, 47, tzinfo=met)")
2380
2381 def test_combine(self):
2382 met = FixedOffset(60, "MET")
2383 d = date(2002, 3, 4)
2384 tz = time(18, 45, 3, 1234, tzinfo=met)
2385 dt = datetime.combine(d, tz)
2386 self.assertEqual(dt, datetime(2002, 3, 4, 18, 45, 3, 1234,
2387 tzinfo=met))
2388
2389 def test_extract(self):
2390 met = FixedOffset(60, "MET")
2391 dt = self.theclass(2002, 3, 4, 18, 45, 3, 1234, tzinfo=met)
2392 self.assertEqual(dt.date(), date(2002, 3, 4))
2393 self.assertEqual(dt.time(), time(18, 45, 3, 1234))
2394 self.assertEqual(dt.timetz(), time(18, 45, 3, 1234, tzinfo=met))
2395
2396 def test_tz_aware_arithmetic(self):
2397 import random
2398
2399 now = self.theclass.now()
2400 tz55 = FixedOffset(-330, "west 5:30")
2401 timeaware = now.time().replace(tzinfo=tz55)
2402 nowaware = self.theclass.combine(now.date(), timeaware)
2403 self.failUnless(nowaware.tzinfo is tz55)
2404 self.assertEqual(nowaware.timetz(), timeaware)
2405
2406 # Can't mix aware and non-aware.
2407 self.assertRaises(TypeError, lambda: now - nowaware)
2408 self.assertRaises(TypeError, lambda: nowaware - now)
2409
2410 # And adding datetime's doesn't make sense, aware or not.
2411 self.assertRaises(TypeError, lambda: now + nowaware)
2412 self.assertRaises(TypeError, lambda: nowaware + now)
2413 self.assertRaises(TypeError, lambda: nowaware + nowaware)
2414
2415 # Subtracting should yield 0.
2416 self.assertEqual(now - now, timedelta(0))
2417 self.assertEqual(nowaware - nowaware, timedelta(0))
2418
2419 # Adding a delta should preserve tzinfo.
2420 delta = timedelta(weeks=1, minutes=12, microseconds=5678)
2421 nowawareplus = nowaware + delta
2422 self.failUnless(nowaware.tzinfo is tz55)
2423 nowawareplus2 = delta + nowaware
2424 self.failUnless(nowawareplus2.tzinfo is tz55)
2425 self.assertEqual(nowawareplus, nowawareplus2)
2426
2427 # that - delta should be what we started with, and that - what we
2428 # started with should be delta.
2429 diff = nowawareplus - delta
2430 self.failUnless(diff.tzinfo is tz55)
2431 self.assertEqual(nowaware, diff)
2432 self.assertRaises(TypeError, lambda: delta - nowawareplus)
2433 self.assertEqual(nowawareplus - nowaware, delta)
2434
2435 # Make up a random timezone.
2436 tzr = FixedOffset(random.randrange(-1439, 1440), "randomtimezone")
2437 # Attach it to nowawareplus.
2438 nowawareplus = nowawareplus.replace(tzinfo=tzr)
2439 self.failUnless(nowawareplus.tzinfo is tzr)
2440 # Make sure the difference takes the timezone adjustments into account.
2441 got = nowaware - nowawareplus
2442 # Expected: (nowaware base - nowaware offset) -
2443 # (nowawareplus base - nowawareplus offset) =
2444 # (nowaware base - nowawareplus base) +
2445 # (nowawareplus offset - nowaware offset) =
2446 # -delta + nowawareplus offset - nowaware offset
2447 expected = nowawareplus.utcoffset() - nowaware.utcoffset() - delta
2448 self.assertEqual(got, expected)
2449
2450 # Try max possible difference.
2451 min = self.theclass(1, 1, 1, tzinfo=FixedOffset(1439, "min"))
2452 max = self.theclass(MAXYEAR, 12, 31, 23, 59, 59, 999999,
2453 tzinfo=FixedOffset(-1439, "max"))
2454 maxdiff = max - min
2455 self.assertEqual(maxdiff, self.theclass.max - self.theclass.min +
2456 timedelta(minutes=2*1439))
2457
2458 def test_tzinfo_now(self):
2459 meth = self.theclass.now
2460 # Ensure it doesn't require tzinfo (i.e., that this doesn't blow up).
2461 base = meth()
2462 # Try with and without naming the keyword.
2463 off42 = FixedOffset(42, "42")
2464 another = meth(off42)
2465 again = meth(tz=off42)
2466 self.failUnless(another.tzinfo is again.tzinfo)
2467 self.assertEqual(another.utcoffset(), timedelta(minutes=42))
2468 # Bad argument with and w/o naming the keyword.
2469 self.assertRaises(TypeError, meth, 16)
2470 self.assertRaises(TypeError, meth, tzinfo=16)
2471 # Bad keyword name.
2472 self.assertRaises(TypeError, meth, tinfo=off42)
2473 # Too many args.
2474 self.assertRaises(TypeError, meth, off42, off42)
2475
2476 # We don't know which time zone we're in, and don't have a tzinfo
2477 # class to represent it, so seeing whether a tz argument actually
2478 # does a conversion is tricky.
2479 weirdtz = FixedOffset(timedelta(hours=15, minutes=58), "weirdtz", 0)
2480 utc = FixedOffset(0, "utc", 0)
2481 for dummy in range(3):
2482 now = datetime.now(weirdtz)
2483 self.failUnless(now.tzinfo is weirdtz)
2484 utcnow = datetime.utcnow().replace(tzinfo=utc)
2485 now2 = utcnow.astimezone(weirdtz)
2486 if abs(now - now2) < timedelta(seconds=30):
2487 break
2488 # Else the code is broken, or more than 30 seconds passed between
2489 # calls; assuming the latter, just try again.
2490 else:
2491 # Three strikes and we're out.
2492 self.fail("utcnow(), now(tz), or astimezone() may be broken")
2493
2494 def test_tzinfo_fromtimestamp(self):
2495 import time
2496 meth = self.theclass.fromtimestamp
2497 ts = time.time()
2498 # Ensure it doesn't require tzinfo (i.e., that this doesn't blow up).
2499 base = meth(ts)
2500 # Try with and without naming the keyword.
2501 off42 = FixedOffset(42, "42")
2502 another = meth(ts, off42)
2503 again = meth(ts, tz=off42)
2504 self.failUnless(another.tzinfo is again.tzinfo)
2505 self.assertEqual(another.utcoffset(), timedelta(minutes=42))
2506 # Bad argument with and w/o naming the keyword.
2507 self.assertRaises(TypeError, meth, ts, 16)
2508 self.assertRaises(TypeError, meth, ts, tzinfo=16)
2509 # Bad keyword name.
2510 self.assertRaises(TypeError, meth, ts, tinfo=off42)
2511 # Too many args.
2512 self.assertRaises(TypeError, meth, ts, off42, off42)
2513 # Too few args.
2514 self.assertRaises(TypeError, meth)
2515
2516 # Try to make sure tz= actually does some conversion.
2517 timestamp = 1000000000
2518 utcdatetime = datetime.utcfromtimestamp(timestamp)
2519 # In POSIX (epoch 1970), that's 2001-09-09 01:46:40 UTC, give or take.
2520 # But on some flavor of Mac, it's nowhere near that. So we can't have
2521 # any idea here what time that actually is, we can only test that
2522 # relative changes match.
2523 utcoffset = timedelta(hours=-15, minutes=39) # arbitrary, but not zero
2524 tz = FixedOffset(utcoffset, "tz", 0)
2525 expected = utcdatetime + utcoffset
2526 got = datetime.fromtimestamp(timestamp, tz)
2527 self.assertEqual(expected, got.replace(tzinfo=None))
2528
2529 def test_tzinfo_utcnow(self):
2530 meth = self.theclass.utcnow
2531 # Ensure it doesn't require tzinfo (i.e., that this doesn't blow up).
2532 base = meth()
2533 # Try with and without naming the keyword; for whatever reason,
2534 # utcnow() doesn't accept a tzinfo argument.
2535 off42 = FixedOffset(42, "42")
2536 self.assertRaises(TypeError, meth, off42)
2537 self.assertRaises(TypeError, meth, tzinfo=off42)
2538
2539 def test_tzinfo_utcfromtimestamp(self):
2540 import time
2541 meth = self.theclass.utcfromtimestamp
2542 ts = time.time()
2543 # Ensure it doesn't require tzinfo (i.e., that this doesn't blow up).
2544 base = meth(ts)
2545 # Try with and without naming the keyword; for whatever reason,
2546 # utcfromtimestamp() doesn't accept a tzinfo argument.
2547 off42 = FixedOffset(42, "42")
2548 self.assertRaises(TypeError, meth, ts, off42)
2549 self.assertRaises(TypeError, meth, ts, tzinfo=off42)
2550
2551 def test_tzinfo_timetuple(self):
2552 # TestDateTime tested most of this. datetime adds a twist to the
2553 # DST flag.
2554 class DST(tzinfo):
2555 def __init__(self, dstvalue):
2556 if isinstance(dstvalue, int):
2557 dstvalue = timedelta(minutes=dstvalue)
2558 self.dstvalue = dstvalue
2559 def dst(self, dt):
2560 return self.dstvalue
2561
2562 cls = self.theclass
2563 for dstvalue, flag in (-33, 1), (33, 1), (0, 0), (None, -1):
2564 d = cls(1, 1, 1, 10, 20, 30, 40, tzinfo=DST(dstvalue))
2565 t = d.timetuple()
2566 self.assertEqual(1, t.tm_year)
2567 self.assertEqual(1, t.tm_mon)
2568 self.assertEqual(1, t.tm_mday)
2569 self.assertEqual(10, t.tm_hour)
2570 self.assertEqual(20, t.tm_min)
2571 self.assertEqual(30, t.tm_sec)
2572 self.assertEqual(0, t.tm_wday)
2573 self.assertEqual(1, t.tm_yday)
2574 self.assertEqual(flag, t.tm_isdst)
2575
2576 # dst() returns wrong type.
2577 self.assertRaises(TypeError, cls(1, 1, 1, tzinfo=DST("x")).timetuple)
2578
2579 # dst() at the edge.
2580 self.assertEqual(cls(1,1,1, tzinfo=DST(1439)).timetuple().tm_isdst, 1)
2581 self.assertEqual(cls(1,1,1, tzinfo=DST(-1439)).timetuple().tm_isdst, 1)
2582
2583 # dst() out of range.
2584 self.assertRaises(ValueError, cls(1,1,1, tzinfo=DST(1440)).timetuple)
2585 self.assertRaises(ValueError, cls(1,1,1, tzinfo=DST(-1440)).timetuple)
2586
2587 def test_utctimetuple(self):
2588 class DST(tzinfo):
2589 def __init__(self, dstvalue):
2590 if isinstance(dstvalue, int):
2591 dstvalue = timedelta(minutes=dstvalue)
2592 self.dstvalue = dstvalue
2593 def dst(self, dt):
2594 return self.dstvalue
2595
2596 cls = self.theclass
2597 # This can't work: DST didn't implement utcoffset.
2598 self.assertRaises(NotImplementedError,
2599 cls(1, 1, 1, tzinfo=DST(0)).utcoffset)
2600
2601 class UOFS(DST):
2602 def __init__(self, uofs, dofs=None):
2603 DST.__init__(self, dofs)
2604 self.uofs = timedelta(minutes=uofs)
2605 def utcoffset(self, dt):
2606 return self.uofs
2607
2608 # Ensure tm_isdst is 0 regardless of what dst() says: DST is never
2609 # in effect for a UTC time.
2610 for dstvalue in -33, 33, 0, None:
2611 d = cls(1, 2, 3, 10, 20, 30, 40, tzinfo=UOFS(-53, dstvalue))
2612 t = d.utctimetuple()
2613 self.assertEqual(d.year, t.tm_year)
2614 self.assertEqual(d.month, t.tm_mon)
2615 self.assertEqual(d.day, t.tm_mday)
2616 self.assertEqual(11, t.tm_hour) # 20mm + 53mm = 1hn + 13mm
2617 self.assertEqual(13, t.tm_min)
2618 self.assertEqual(d.second, t.tm_sec)
2619 self.assertEqual(d.weekday(), t.tm_wday)
2620 self.assertEqual(d.toordinal() - date(1, 1, 1).toordinal() + 1,
2621 t.tm_yday)
2622 self.assertEqual(0, t.tm_isdst)
2623
2624 # At the edges, UTC adjustment can normalize into years out-of-range
2625 # for a datetime object. Ensure that a correct timetuple is
2626 # created anyway.
2627 tiny = cls(MINYEAR, 1, 1, 0, 0, 37, tzinfo=UOFS(1439))
2628 # That goes back 1 minute less than a full day.
2629 t = tiny.utctimetuple()
2630 self.assertEqual(t.tm_year, MINYEAR-1)
2631 self.assertEqual(t.tm_mon, 12)
2632 self.assertEqual(t.tm_mday, 31)
2633 self.assertEqual(t.tm_hour, 0)
2634 self.assertEqual(t.tm_min, 1)
2635 self.assertEqual(t.tm_sec, 37)
2636 self.assertEqual(t.tm_yday, 366) # "year 0" is a leap year
2637 self.assertEqual(t.tm_isdst, 0)
2638
2639 huge = cls(MAXYEAR, 12, 31, 23, 59, 37, 999999, tzinfo=UOFS(-1439))
2640 # That goes forward 1 minute less than a full day.
2641 t = huge.utctimetuple()
2642 self.assertEqual(t.tm_year, MAXYEAR+1)
2643 self.assertEqual(t.tm_mon, 1)
2644 self.assertEqual(t.tm_mday, 1)
2645 self.assertEqual(t.tm_hour, 23)
2646 self.assertEqual(t.tm_min, 58)
2647 self.assertEqual(t.tm_sec, 37)
2648 self.assertEqual(t.tm_yday, 1)
2649 self.assertEqual(t.tm_isdst, 0)
2650
2651 def test_tzinfo_isoformat(self):
2652 zero = FixedOffset(0, "+00:00")
2653 plus = FixedOffset(220, "+03:40")
2654 minus = FixedOffset(-231, "-03:51")
2655 unknown = FixedOffset(None, "")
2656
2657 cls = self.theclass
2658 datestr = '0001-02-03'
2659 for ofs in None, zero, plus, minus, unknown:
2660 for us in 0, 987001:
2661 d = cls(1, 2, 3, 4, 5, 59, us, tzinfo=ofs)
2662 timestr = '04:05:59' + (us and '.987001' or '')
2663 ofsstr = ofs is not None and d.tzname() or ''
2664 tailstr = timestr + ofsstr
2665 iso = d.isoformat()
2666 self.assertEqual(iso, datestr + 'T' + tailstr)
2667 self.assertEqual(iso, d.isoformat('T'))
2668 self.assertEqual(d.isoformat('k'), datestr + 'k' + tailstr)
2669 self.assertEqual(str(d), datestr + ' ' + tailstr)
2670
2671 def test_replace(self):
2672 cls = self.theclass
2673 z100 = FixedOffset(100, "+100")
2674 zm200 = FixedOffset(timedelta(minutes=-200), "-200")
2675 args = [1, 2, 3, 4, 5, 6, 7, z100]
2676 base = cls(*args)
2677 self.assertEqual(base, base.replace())
2678
2679 i = 0
2680 for name, newval in (("year", 2),
2681 ("month", 3),
2682 ("day", 4),
2683 ("hour", 5),
2684 ("minute", 6),
2685 ("second", 7),
2686 ("microsecond", 8),
2687 ("tzinfo", zm200)):
2688 newargs = args[:]
2689 newargs[i] = newval
2690 expected = cls(*newargs)
2691 got = base.replace(**{name: newval})
2692 self.assertEqual(expected, got)
2693 i += 1
2694
2695 # Ensure we can get rid of a tzinfo.
2696 self.assertEqual(base.tzname(), "+100")
2697 base2 = base.replace(tzinfo=None)
2698 self.failUnless(base2.tzinfo is None)
2699 self.failUnless(base2.tzname() is None)
2700
2701 # Ensure we can add one.
2702 base3 = base2.replace(tzinfo=z100)
2703 self.assertEqual(base, base3)
2704 self.failUnless(base.tzinfo is base3.tzinfo)
2705
2706 # Out of bounds.
2707 base = cls(2000, 2, 29)
2708 self.assertRaises(ValueError, base.replace, year=2001)
2709
2710 def test_more_astimezone(self):
2711 # The inherited test_astimezone covered some trivial and error cases.
2712 fnone = FixedOffset(None, "None")
2713 f44m = FixedOffset(44, "44")
2714 fm5h = FixedOffset(-timedelta(hours=5), "m300")
2715
2716 dt = self.theclass.now(tz=f44m)
2717 self.failUnless(dt.tzinfo is f44m)
2718 # Replacing with degenerate tzinfo raises an exception.
2719 self.assertRaises(ValueError, dt.astimezone, fnone)
2720 # Ditto with None tz.
2721 self.assertRaises(TypeError, dt.astimezone, None)
2722 # Replacing with same tzinfo makes no change.
2723 x = dt.astimezone(dt.tzinfo)
2724 self.failUnless(x.tzinfo is f44m)
2725 self.assertEqual(x.date(), dt.date())
2726 self.assertEqual(x.time(), dt.time())
2727
2728 # Replacing with different tzinfo does adjust.
2729 got = dt.astimezone(fm5h)
2730 self.failUnless(got.tzinfo is fm5h)
2731 self.assertEqual(got.utcoffset(), timedelta(hours=-5))
2732 expected = dt - dt.utcoffset() # in effect, convert to UTC
2733 expected += fm5h.utcoffset(dt) # and from there to local time
2734 expected = expected.replace(tzinfo=fm5h) # and attach new tzinfo
2735 self.assertEqual(got.date(), expected.date())
2736 self.assertEqual(got.time(), expected.time())
2737 self.assertEqual(got.timetz(), expected.timetz())
2738 self.failUnless(got.tzinfo is expected.tzinfo)
2739 self.assertEqual(got, expected)
2740
2741 def test_aware_subtract(self):
2742 cls = self.theclass
2743
2744 # Ensure that utcoffset() is ignored when the operands have the
2745 # same tzinfo member.
2746 class OperandDependentOffset(tzinfo):
2747 def utcoffset(self, t):
2748 if t.minute < 10:
2749 # d0 and d1 equal after adjustment
2750 return timedelta(minutes=t.minute)
2751 else:
2752 # d2 off in the weeds
2753 return timedelta(minutes=59)
2754
2755 base = cls(8, 9, 10, 11, 12, 13, 14, tzinfo=OperandDependentOffset())
2756 d0 = base.replace(minute=3)
2757 d1 = base.replace(minute=9)
2758 d2 = base.replace(minute=11)
2759 for x in d0, d1, d2:
2760 for y in d0, d1, d2:
2761 got = x - y
2762 expected = timedelta(minutes=x.minute - y.minute)
2763 self.assertEqual(got, expected)
2764
2765 # OTOH, if the tzinfo members are distinct, utcoffsets aren't
2766 # ignored.
2767 base = cls(8, 9, 10, 11, 12, 13, 14)
2768 d0 = base.replace(minute=3, tzinfo=OperandDependentOffset())
2769 d1 = base.replace(minute=9, tzinfo=OperandDependentOffset())
2770 d2 = base.replace(minute=11, tzinfo=OperandDependentOffset())
2771 for x in d0, d1, d2:
2772 for y in d0, d1, d2:
2773 got = x - y
2774 if (x is d0 or x is d1) and (y is d0 or y is d1):
2775 expected = timedelta(0)
2776 elif x is y is d2:
2777 expected = timedelta(0)
2778 elif x is d2:
2779 expected = timedelta(minutes=(11-59)-0)
2780 else:
2781 assert y is d2
2782 expected = timedelta(minutes=0-(11-59))
2783 self.assertEqual(got, expected)
2784
2785 def test_mixed_compare(self):
2786 t1 = datetime(1, 2, 3, 4, 5, 6, 7)
2787 t2 = datetime(1, 2, 3, 4, 5, 6, 7)
2788 self.assertEqual(t1, t2)
2789 t2 = t2.replace(tzinfo=None)
2790 self.assertEqual(t1, t2)
2791 t2 = t2.replace(tzinfo=FixedOffset(None, ""))
2792 self.assertEqual(t1, t2)
2793 t2 = t2.replace(tzinfo=FixedOffset(0, ""))
2794 self.assertRaises(TypeError, lambda: t1 == t2)
2795
2796 # In datetime w/ identical tzinfo objects, utcoffset is ignored.
2797 class Varies(tzinfo):
2798 def __init__(self):
2799 self.offset = timedelta(minutes=22)
2800 def utcoffset(self, t):
2801 self.offset += timedelta(minutes=1)
2802 return self.offset
2803
2804 v = Varies()
2805 t1 = t2.replace(tzinfo=v)
2806 t2 = t2.replace(tzinfo=v)
2807 self.assertEqual(t1.utcoffset(), timedelta(minutes=23))
2808 self.assertEqual(t2.utcoffset(), timedelta(minutes=24))
2809 self.assertEqual(t1, t2)
2810
2811 # But if they're not identical, it isn't ignored.
2812 t2 = t2.replace(tzinfo=Varies())
2813 self.failUnless(t1 < t2) # t1's offset counter still going up
2814
2815 def test_subclass_datetimetz(self):
2816
2817 class C(self.theclass):
2818 theAnswer = 42
2819
2820 def __new__(cls, *args, **kws):
2821 temp = kws.copy()
2822 extra = temp.pop('extra')
2823 result = self.theclass.__new__(cls, *args, **temp)
2824 result.extra = extra
2825 return result
2826
2827 def newmeth(self, start):
2828 return start + self.hour + self.year
2829
2830 args = 2002, 12, 31, 4, 5, 6, 500, FixedOffset(-300, "EST", 1)
2831
2832 dt1 = self.theclass(*args)
2833 dt2 = C(*args, **{'extra': 7})
2834
2835 self.assertEqual(dt2.__class__, C)
2836 self.assertEqual(dt2.theAnswer, 42)
2837 self.assertEqual(dt2.extra, 7)
2838 self.assertEqual(dt1.utcoffset(), dt2.utcoffset())
2839 self.assertEqual(dt2.newmeth(-7), dt1.hour + dt1.year - 7)
2840
2841# Pain to set up DST-aware tzinfo classes.
2842
2843def first_sunday_on_or_after(dt):
2844 days_to_go = 6 - dt.weekday()
2845 if days_to_go:
2846 dt += timedelta(days_to_go)
2847 return dt
2848
2849ZERO = timedelta(0)
2850HOUR = timedelta(hours=1)
2851DAY = timedelta(days=1)
2852# In the US, DST starts at 2am (standard time) on the first Sunday in April.
2853DSTSTART = datetime(1, 4, 1, 2)
2854# and ends at 2am (DST time; 1am standard time) on the last Sunday of Oct,
2855# which is the first Sunday on or after Oct 25. Because we view 1:MM as
2856# being standard time on that day, there is no spelling in local time of
2857# the last hour of DST (that's 1:MM DST, but 1:MM is taken as standard time).
2858DSTEND = datetime(1, 10, 25, 1)
2859
2860class USTimeZone(tzinfo):
2861
2862 def __init__(self, hours, reprname, stdname, dstname):
2863 self.stdoffset = timedelta(hours=hours)
2864 self.reprname = reprname
2865 self.stdname = stdname
2866 self.dstname = dstname
2867
2868 def __repr__(self):
2869 return self.reprname
2870
2871 def tzname(self, dt):
2872 if self.dst(dt):
2873 return self.dstname
2874 else:
2875 return self.stdname
2876
2877 def utcoffset(self, dt):
2878 return self.stdoffset + self.dst(dt)
2879
2880 def dst(self, dt):
2881 if dt is None or dt.tzinfo is None:
2882 # An exception instead may be sensible here, in one or more of
2883 # the cases.
2884 return ZERO
2885 assert dt.tzinfo is self
2886
2887 # Find first Sunday in April.
2888 start = first_sunday_on_or_after(DSTSTART.replace(year=dt.year))
2889 assert start.weekday() == 6 and start.month == 4 and start.day <= 7
2890
2891 # Find last Sunday in October.
2892 end = first_sunday_on_or_after(DSTEND.replace(year=dt.year))
2893 assert end.weekday() == 6 and end.month == 10 and end.day >= 25
2894
2895 # Can't compare naive to aware objects, so strip the timezone from
2896 # dt first.
2897 if start <= dt.replace(tzinfo=None) < end:
2898 return HOUR
2899 else:
2900 return ZERO
2901
2902Eastern = USTimeZone(-5, "Eastern", "EST", "EDT")
2903Central = USTimeZone(-6, "Central", "CST", "CDT")
2904Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")
2905Pacific = USTimeZone(-8, "Pacific", "PST", "PDT")
2906utc_real = FixedOffset(0, "UTC", 0)
2907# For better test coverage, we want another flavor of UTC that's west of
2908# the Eastern and Pacific timezones.
2909utc_fake = FixedOffset(-12*60, "UTCfake", 0)
2910
2911class TestTimezoneConversions(unittest.TestCase):
2912 # The DST switch times for 2002, in std time.
2913 dston = datetime(2002, 4, 7, 2)
2914 dstoff = datetime(2002, 10, 27, 1)
2915
2916 theclass = datetime
2917
2918 # Check a time that's inside DST.
2919 def checkinside(self, dt, tz, utc, dston, dstoff):
2920 self.assertEqual(dt.dst(), HOUR)
2921
2922 # Conversion to our own timezone is always an identity.
2923 self.assertEqual(dt.astimezone(tz), dt)
2924
2925 asutc = dt.astimezone(utc)
2926 there_and_back = asutc.astimezone(tz)
2927
2928 # Conversion to UTC and back isn't always an identity here,
2929 # because there are redundant spellings (in local time) of
2930 # UTC time when DST begins: the clock jumps from 1:59:59
2931 # to 3:00:00, and a local time of 2:MM:SS doesn't really
2932 # make sense then. The classes above treat 2:MM:SS as
2933 # daylight time then (it's "after 2am"), really an alias
2934 # for 1:MM:SS standard time. The latter form is what
2935 # conversion back from UTC produces.
2936 if dt.date() == dston.date() and dt.hour == 2:
2937 # We're in the redundant hour, and coming back from
2938 # UTC gives the 1:MM:SS standard-time spelling.
2939 self.assertEqual(there_and_back + HOUR, dt)
2940 # Although during was considered to be in daylight
2941 # time, there_and_back is not.
2942 self.assertEqual(there_and_back.dst(), ZERO)
2943 # They're the same times in UTC.
2944 self.assertEqual(there_and_back.astimezone(utc),
2945 dt.astimezone(utc))
2946 else:
2947 # We're not in the redundant hour.
2948 self.assertEqual(dt, there_and_back)
2949
2950 # Because we have a redundant spelling when DST begins, there is
2951 # (unforunately) an hour when DST ends that can't be spelled at all in
2952 # local time. When DST ends, the clock jumps from 1:59 back to 1:00
2953 # again. The hour 1:MM DST has no spelling then: 1:MM is taken to be
2954 # standard time. 1:MM DST == 0:MM EST, but 0:MM is taken to be
2955 # daylight time. The hour 1:MM daylight == 0:MM standard can't be
2956 # expressed in local time. Nevertheless, we want conversion back
2957 # from UTC to mimic the local clock's "repeat an hour" behavior.
2958 nexthour_utc = asutc + HOUR
2959 nexthour_tz = nexthour_utc.astimezone(tz)
2960 if dt.date() == dstoff.date() and dt.hour == 0:
2961 # We're in the hour before the last DST hour. The last DST hour
2962 # is ineffable. We want the conversion back to repeat 1:MM.
2963 self.assertEqual(nexthour_tz, dt.replace(hour=1))
2964 nexthour_utc += HOUR
2965 nexthour_tz = nexthour_utc.astimezone(tz)
2966 self.assertEqual(nexthour_tz, dt.replace(hour=1))
2967 else:
2968 self.assertEqual(nexthour_tz - dt, HOUR)
2969
2970 # Check a time that's outside DST.
2971 def checkoutside(self, dt, tz, utc):
2972 self.assertEqual(dt.dst(), ZERO)
2973
2974 # Conversion to our own timezone is always an identity.
2975 self.assertEqual(dt.astimezone(tz), dt)
2976
2977 # Converting to UTC and back is an identity too.
2978 asutc = dt.astimezone(utc)
2979 there_and_back = asutc.astimezone(tz)
2980 self.assertEqual(dt, there_and_back)
2981
2982 def convert_between_tz_and_utc(self, tz, utc):
2983 dston = self.dston.replace(tzinfo=tz)
2984 # Because 1:MM on the day DST ends is taken as being standard time,
2985 # there is no spelling in tz for the last hour of daylight time.
2986 # For purposes of the test, the last hour of DST is 0:MM, which is
2987 # taken as being daylight time (and 1:MM is taken as being standard
2988 # time).
2989 dstoff = self.dstoff.replace(tzinfo=tz)
2990 for delta in (timedelta(weeks=13),
2991 DAY,
2992 HOUR,
2993 timedelta(minutes=1),
2994 timedelta(microseconds=1)):
2995
2996 self.checkinside(dston, tz, utc, dston, dstoff)
2997 for during in dston + delta, dstoff - delta:
2998 self.checkinside(during, tz, utc, dston, dstoff)
2999
3000 self.checkoutside(dstoff, tz, utc)
3001 for outside in dston - delta, dstoff + delta:
3002 self.checkoutside(outside, tz, utc)
3003
3004 def test_easy(self):
3005 # Despite the name of this test, the endcases are excruciating.
3006 self.convert_between_tz_and_utc(Eastern, utc_real)
3007 self.convert_between_tz_and_utc(Pacific, utc_real)
3008 self.convert_between_tz_and_utc(Eastern, utc_fake)
3009 self.convert_between_tz_and_utc(Pacific, utc_fake)
3010 # The next is really dancing near the edge. It works because
3011 # Pacific and Eastern are far enough apart that their "problem
3012 # hours" don't overlap.
3013 self.convert_between_tz_and_utc(Eastern, Pacific)
3014 self.convert_between_tz_and_utc(Pacific, Eastern)
3015 # OTOH, these fail! Don't enable them. The difficulty is that
3016 # the edge case tests assume that every hour is representable in
3017 # the "utc" class. This is always true for a fixed-offset tzinfo
3018 # class (lke utc_real and utc_fake), but not for Eastern or Central.
3019 # For these adjacent DST-aware time zones, the range of time offsets
3020 # tested ends up creating hours in the one that aren't representable
3021 # in the other. For the same reason, we would see failures in the
3022 # Eastern vs Pacific tests too if we added 3*HOUR to the list of
3023 # offset deltas in convert_between_tz_and_utc().
3024 #
3025 # self.convert_between_tz_and_utc(Eastern, Central) # can't work
3026 # self.convert_between_tz_and_utc(Central, Eastern) # can't work
3027
3028 def test_tricky(self):
3029 # 22:00 on day before daylight starts.
3030 fourback = self.dston - timedelta(hours=4)
3031 ninewest = FixedOffset(-9*60, "-0900", 0)
3032 fourback = fourback.replace(tzinfo=ninewest)
3033 # 22:00-0900 is 7:00 UTC == 2:00 EST == 3:00 DST. Since it's "after
3034 # 2", we should get the 3 spelling.
3035 # If we plug 22:00 the day before into Eastern, it "looks like std
3036 # time", so its offset is returned as -5, and -5 - -9 = 4. Adding 4
3037 # to 22:00 lands on 2:00, which makes no sense in local time (the
3038 # local clock jumps from 1 to 3). The point here is to make sure we
3039 # get the 3 spelling.
3040 expected = self.dston.replace(hour=3)
3041 got = fourback.astimezone(Eastern).replace(tzinfo=None)
3042 self.assertEqual(expected, got)
3043
3044 # Similar, but map to 6:00 UTC == 1:00 EST == 2:00 DST. In that
3045 # case we want the 1:00 spelling.
3046 sixutc = self.dston.replace(hour=6, tzinfo=utc_real)
3047 # Now 6:00 "looks like daylight", so the offset wrt Eastern is -4,
3048 # and adding -4-0 == -4 gives the 2:00 spelling. We want the 1:00 EST
3049 # spelling.
3050 expected = self.dston.replace(hour=1)
3051 got = sixutc.astimezone(Eastern).replace(tzinfo=None)
3052 self.assertEqual(expected, got)
3053
3054 # Now on the day DST ends, we want "repeat an hour" behavior.
3055 # UTC 4:MM 5:MM 6:MM 7:MM checking these
3056 # EST 23:MM 0:MM 1:MM 2:MM
3057 # EDT 0:MM 1:MM 2:MM 3:MM
3058 # wall 0:MM 1:MM 1:MM 2:MM against these
3059 for utc in utc_real, utc_fake:
3060 for tz in Eastern, Pacific:
3061 first_std_hour = self.dstoff - timedelta(hours=2) # 23:MM
3062 # Convert that to UTC.
3063 first_std_hour -= tz.utcoffset(None)
3064 # Adjust for possibly fake UTC.
3065 asutc = first_std_hour + utc.utcoffset(None)
3066 # First UTC hour to convert; this is 4:00 when utc=utc_real &
3067 # tz=Eastern.
3068 asutcbase = asutc.replace(tzinfo=utc)
3069 for tzhour in (0, 1, 1, 2):
3070 expectedbase = self.dstoff.replace(hour=tzhour)
3071 for minute in 0, 30, 59:
3072 expected = expectedbase.replace(minute=minute)
3073 asutc = asutcbase.replace(minute=minute)
3074 astz = asutc.astimezone(tz)
3075 self.assertEqual(astz.replace(tzinfo=None), expected)
3076 asutcbase += HOUR
3077
3078
3079 def test_bogus_dst(self):
3080 class ok(tzinfo):
3081 def utcoffset(self, dt): return HOUR
3082 def dst(self, dt): return HOUR
3083
3084 now = self.theclass.now().replace(tzinfo=utc_real)
3085 # Doesn't blow up.
3086 now.astimezone(ok())
3087
3088 # Does blow up.
3089 class notok(ok):
3090 def dst(self, dt): return None
3091 self.assertRaises(ValueError, now.astimezone, notok())
3092
3093 def test_fromutc(self):
3094 self.assertRaises(TypeError, Eastern.fromutc) # not enough args
3095 now = datetime.utcnow().replace(tzinfo=utc_real)
3096 self.assertRaises(ValueError, Eastern.fromutc, now) # wrong tzinfo
3097 now = now.replace(tzinfo=Eastern) # insert correct tzinfo
3098 enow = Eastern.fromutc(now) # doesn't blow up
3099 self.assertEqual(enow.tzinfo, Eastern) # has right tzinfo member
3100 self.assertRaises(TypeError, Eastern.fromutc, now, now) # too many args
3101 self.assertRaises(TypeError, Eastern.fromutc, date.today()) # wrong type
3102
3103 # Always converts UTC to standard time.
3104 class FauxUSTimeZone(USTimeZone):
3105 def fromutc(self, dt):
3106 return dt + self.stdoffset
3107 FEastern = FauxUSTimeZone(-5, "FEastern", "FEST", "FEDT")
3108
3109 # UTC 4:MM 5:MM 6:MM 7:MM 8:MM 9:MM
3110 # EST 23:MM 0:MM 1:MM 2:MM 3:MM 4:MM
3111 # EDT 0:MM 1:MM 2:MM 3:MM 4:MM 5:MM
3112
3113 # Check around DST start.
3114 start = self.dston.replace(hour=4, tzinfo=Eastern)
3115 fstart = start.replace(tzinfo=FEastern)
3116 for wall in 23, 0, 1, 3, 4, 5:
3117 expected = start.replace(hour=wall)
3118 if wall == 23:
3119 expected -= timedelta(days=1)
3120 got = Eastern.fromutc(start)
3121 self.assertEqual(expected, got)
3122
3123 expected = fstart + FEastern.stdoffset
3124 got = FEastern.fromutc(fstart)
3125 self.assertEqual(expected, got)
3126
3127 # Ensure astimezone() calls fromutc() too.
3128 got = fstart.replace(tzinfo=utc_real).astimezone(FEastern)
3129 self.assertEqual(expected, got)
3130
3131 start += HOUR
3132 fstart += HOUR
3133
3134 # Check around DST end.
3135 start = self.dstoff.replace(hour=4, tzinfo=Eastern)
3136 fstart = start.replace(tzinfo=FEastern)
3137 for wall in 0, 1, 1, 2, 3, 4:
3138 expected = start.replace(hour=wall)
3139 got = Eastern.fromutc(start)
3140 self.assertEqual(expected, got)
3141
3142 expected = fstart + FEastern.stdoffset
3143 got = FEastern.fromutc(fstart)
3144 self.assertEqual(expected, got)
3145
3146 # Ensure astimezone() calls fromutc() too.
3147 got = fstart.replace(tzinfo=utc_real).astimezone(FEastern)
3148 self.assertEqual(expected, got)
3149
3150 start += HOUR
3151 fstart += HOUR
3152
3153
3154#############################################################################
3155# oddballs
3156
3157class Oddballs(unittest.TestCase):
3158
3159 def test_bug_1028306(self):
3160 # Trying to compare a date to a datetime should act like a mixed-
3161 # type comparison, despite that datetime is a subclass of date.
3162 as_date = date.today()
3163 as_datetime = datetime.combine(as_date, time())
3164 self.assert_(as_date != as_datetime)
3165 self.assert_(as_datetime != as_date)
3166 self.assert_(not as_date == as_datetime)
3167 self.assert_(not as_datetime == as_date)
3168 self.assertRaises(TypeError, lambda: as_date < as_datetime)
3169 self.assertRaises(TypeError, lambda: as_datetime < as_date)
3170 self.assertRaises(TypeError, lambda: as_date <= as_datetime)
3171 self.assertRaises(TypeError, lambda: as_datetime <= as_date)
3172 self.assertRaises(TypeError, lambda: as_date > as_datetime)
3173 self.assertRaises(TypeError, lambda: as_datetime > as_date)
3174 self.assertRaises(TypeError, lambda: as_date >= as_datetime)
3175 self.assertRaises(TypeError, lambda: as_datetime >= as_date)
3176
3177 # Neverthelss, comparison should work with the base-class (date)
3178 # projection if use of a date method is forced.
3179 self.assert_(as_date.__eq__(as_datetime))
3180 different_day = (as_date.day + 1) % 20 + 1
3181 self.assert_(not as_date.__eq__(as_datetime.replace(day=
3182 different_day)))
3183
3184 # And date should compare with other subclasses of date. If a
3185 # subclass wants to stop this, it's up to the subclass to do so.
3186 date_sc = SubclassDate(as_date.year, as_date.month, as_date.day)
3187 self.assertEqual(as_date, date_sc)
3188 self.assertEqual(date_sc, as_date)
3189
3190 # Ditto for datetimes.
3191 datetime_sc = SubclassDatetime(as_datetime.year, as_datetime.month,
3192 as_date.day, 0, 0, 0)
3193 self.assertEqual(as_datetime, datetime_sc)
3194 self.assertEqual(datetime_sc, as_datetime)
3195
3196def test_suite():
3197 allsuites = [unittest.makeSuite(klass, 'test')
3198 for klass in (TestModule,
3199 TestTZInfo,
3200 TestTimeDelta,
3201 TestDateOnly,
3202 TestDate,
3203 TestDateTime,
3204 TestTime,
3205 TestTimeTZ,
3206 TestDateTimeTZ,
3207 TestTimezoneConversions,
3208 Oddballs,
3209 )
3210 ]
3211 return unittest.TestSuite(allsuites)
3212
3213def test_main():
3214 import gc
3215 import sys
3216
3217 thesuite = test_suite()
3218 lastrc = None
3219 while True:
3220 test_support.run_suite(thesuite)
3221 if 1: # change to 0, under a debug build, for some leak detection
3222 break
3223 gc.collect()
3224 if gc.garbage:
3225 raise SystemError("gc.garbage not empty after test run: %r" %
3226 gc.garbage)
3227 if hasattr(sys, 'gettotalrefcount'):
3228 thisrc = sys.gettotalrefcount()
3229 print >> sys.stderr, '*' * 10, 'total refs:', thisrc,
3230 if lastrc:
3231 print >> sys.stderr, 'delta:', thisrc - lastrc
3232 else:
3233 print >> sys.stderr
3234 lastrc = thisrc
3235
3236if __name__ == "__main__":
3237 test_main()