blob: 49a9d17710dfd49644b48f574ac559b88ba4d8dc [file] [log] [blame]
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001from test import support
Barry Warsawb0c22321996-12-06 23:30:07 +00002import time
Fred Drakebc561982001-05-22 17:02:02 +00003import unittest
Martin v. Löwis1b01ccd2009-05-30 06:13:40 +00004import locale
Barry Warsawb0c22321996-12-06 23:30:07 +00005
Fred Drakebc561982001-05-22 17:02:02 +00006class TimeTestCase(unittest.TestCase):
Barry Warsawb0c22321996-12-06 23:30:07 +00007
Fred Drakebc561982001-05-22 17:02:02 +00008 def setUp(self):
9 self.t = time.time()
Barry Warsawb0c22321996-12-06 23:30:07 +000010
Fred Drakebc561982001-05-22 17:02:02 +000011 def test_data_attributes(self):
12 time.altzone
13 time.daylight
14 time.timezone
15 time.tzname
Barry Warsawb0c22321996-12-06 23:30:07 +000016
Fred Drakebc561982001-05-22 17:02:02 +000017 def test_clock(self):
18 time.clock()
Barry Warsawb0c22321996-12-06 23:30:07 +000019
Fred Drakebc561982001-05-22 17:02:02 +000020 def test_conversions(self):
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000021 self.assertTrue(time.ctime(self.t)
Fred Drakebc561982001-05-22 17:02:02 +000022 == time.asctime(time.localtime(self.t)))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000023 self.assertTrue(int(time.mktime(time.localtime(self.t)))
Guido van Rossume2a383d2007-01-15 16:59:06 +000024 == int(self.t))
Fred Drakebc561982001-05-22 17:02:02 +000025
26 def test_sleep(self):
27 time.sleep(1.2)
28
29 def test_strftime(self):
30 tt = time.gmtime(self.t)
31 for directive in ('a', 'A', 'b', 'B', 'c', 'd', 'H', 'I',
32 'j', 'm', 'M', 'p', 'S',
33 'U', 'w', 'W', 'x', 'X', 'y', 'Y', 'Z', '%'):
34 format = ' %' + directive
35 try:
36 time.strftime(format, tt)
37 except ValueError:
38 self.fail('conversion specifier: %r failed.' % format)
39
Brett Cannond1080a32004-03-02 04:38:10 +000040 def test_strftime_bounds_checking(self):
41 # Make sure that strftime() checks the bounds of the various parts
Thomas Wouters0e3f5912006-08-11 14:57:12 +000042 #of the time tuple (0 is valid for *all* values).
Brett Cannond1080a32004-03-02 04:38:10 +000043
Thomas Wouters0e3f5912006-08-11 14:57:12 +000044 # Check year [1900, max(int)]
Brett Cannond1080a32004-03-02 04:38:10 +000045 self.assertRaises(ValueError, time.strftime, '',
46 (1899, 1, 1, 0, 0, 0, 0, 1, -1))
47 if time.accept2dyear:
48 self.assertRaises(ValueError, time.strftime, '',
49 (-1, 1, 1, 0, 0, 0, 0, 1, -1))
50 self.assertRaises(ValueError, time.strftime, '',
51 (100, 1, 1, 0, 0, 0, 0, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000052 # Check month [1, 12] + zero support
Brett Cannond1080a32004-03-02 04:38:10 +000053 self.assertRaises(ValueError, time.strftime, '',
Thomas Wouters0e3f5912006-08-11 14:57:12 +000054 (1900, -1, 1, 0, 0, 0, 0, 1, -1))
Brett Cannond1080a32004-03-02 04:38:10 +000055 self.assertRaises(ValueError, time.strftime, '',
56 (1900, 13, 1, 0, 0, 0, 0, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000057 # Check day of month [1, 31] + zero support
Brett Cannond1080a32004-03-02 04:38:10 +000058 self.assertRaises(ValueError, time.strftime, '',
Thomas Wouters0e3f5912006-08-11 14:57:12 +000059 (1900, 1, -1, 0, 0, 0, 0, 1, -1))
Brett Cannond1080a32004-03-02 04:38:10 +000060 self.assertRaises(ValueError, time.strftime, '',
61 (1900, 1, 32, 0, 0, 0, 0, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000062 # Check hour [0, 23]
Brett Cannond1080a32004-03-02 04:38:10 +000063 self.assertRaises(ValueError, time.strftime, '',
64 (1900, 1, 1, -1, 0, 0, 0, 1, -1))
65 self.assertRaises(ValueError, time.strftime, '',
66 (1900, 1, 1, 24, 0, 0, 0, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000067 # Check minute [0, 59]
Brett Cannond1080a32004-03-02 04:38:10 +000068 self.assertRaises(ValueError, time.strftime, '',
69 (1900, 1, 1, 0, -1, 0, 0, 1, -1))
70 self.assertRaises(ValueError, time.strftime, '',
71 (1900, 1, 1, 0, 60, 0, 0, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000072 # Check second [0, 61]
Brett Cannond1080a32004-03-02 04:38:10 +000073 self.assertRaises(ValueError, time.strftime, '',
74 (1900, 1, 1, 0, 0, -1, 0, 1, -1))
75 # C99 only requires allowing for one leap second, but Python's docs say
76 # allow two leap seconds (0..61)
77 self.assertRaises(ValueError, time.strftime, '',
78 (1900, 1, 1, 0, 0, 62, 0, 1, -1))
79 # No check for upper-bound day of week;
80 # value forced into range by a ``% 7`` calculation.
81 # Start check at -2 since gettmarg() increments value before taking
82 # modulo.
83 self.assertRaises(ValueError, time.strftime, '',
84 (1900, 1, 1, 0, 0, 0, -2, 1, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000085 # Check day of the year [1, 366] + zero support
Brett Cannond1080a32004-03-02 04:38:10 +000086 self.assertRaises(ValueError, time.strftime, '',
Thomas Wouters0e3f5912006-08-11 14:57:12 +000087 (1900, 1, 1, 0, 0, 0, 0, -1, -1))
Brett Cannond1080a32004-03-02 04:38:10 +000088 self.assertRaises(ValueError, time.strftime, '',
89 (1900, 1, 1, 0, 0, 0, 0, 367, -1))
Thomas Wouters0e3f5912006-08-11 14:57:12 +000090 # Check daylight savings flag [-1, 1]
Brett Cannond1080a32004-03-02 04:38:10 +000091 self.assertRaises(ValueError, time.strftime, '',
92 (1900, 1, 1, 0, 0, 0, 0, 1, -2))
93 self.assertRaises(ValueError, time.strftime, '',
94 (1900, 1, 1, 0, 0, 0, 0, 1, 2))
95
Thomas Wouters0e3f5912006-08-11 14:57:12 +000096 def test_default_values_for_zero(self):
97 # Make sure that using all zeros uses the proper default values.
98 # No test for daylight savings since strftime() does not change output
99 # based on its value.
100 expected = "2000 01 01 00 00 00 1 001"
101 result = time.strftime("%Y %m %d %H %M %S %w %j", (0,)*9)
102 self.assertEquals(expected, result)
103
Guido van Rossum00efe7e2002-07-19 17:04:46 +0000104 def test_strptime(self):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000105 # Should be able to go round-trip from strftime to strptime without
106 # throwing an exception.
Guido van Rossum00efe7e2002-07-19 17:04:46 +0000107 tt = time.gmtime(self.t)
108 for directive in ('a', 'A', 'b', 'B', 'c', 'd', 'H', 'I',
109 'j', 'm', 'M', 'p', 'S',
110 'U', 'w', 'W', 'x', 'X', 'y', 'Y', 'Z', '%'):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000111 format = '%' + directive
112 strf_output = time.strftime(format, tt)
Guido van Rossum00efe7e2002-07-19 17:04:46 +0000113 try:
Thomas Wouters89f507f2006-12-13 04:49:30 +0000114 time.strptime(strf_output, format)
Guido van Rossum00efe7e2002-07-19 17:04:46 +0000115 except ValueError:
Thomas Wouters89f507f2006-12-13 04:49:30 +0000116 self.fail("conversion specifier %r failed with '%s' input." %
117 (format, strf_output))
Guido van Rossum00efe7e2002-07-19 17:04:46 +0000118
Brett Cannon7f6b4f82009-03-30 21:30:26 +0000119 def test_strptime_bytes(self):
120 # Make sure only strings are accepted as arguments to strptime.
121 self.assertRaises(TypeError, time.strptime, b'2009', "%Y")
122 self.assertRaises(TypeError, time.strptime, '2009', b'%Y')
123
Fred Drakebc561982001-05-22 17:02:02 +0000124 def test_asctime(self):
125 time.asctime(time.gmtime(self.t))
126 self.assertRaises(TypeError, time.asctime, 0)
127
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000128 def test_tzset(self):
Guido van Rossumd2b738e2003-03-15 12:01:52 +0000129 if not hasattr(time, "tzset"):
130 return # Can't test this; don't want the test suite to fail
131
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000132 from os import environ
133
Tim Peters0eadaac2003-04-24 16:02:54 +0000134 # Epoch time of midnight Dec 25th 2002. Never DST in northern
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000135 # hemisphere.
Tim Peters0eadaac2003-04-24 16:02:54 +0000136 xmas2002 = 1040774400.0
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000137
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000138 # These formats are correct for 2002, and possibly future years
139 # This format is the 'standard' as documented at:
140 # http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html
141 # They are also documented in the tzset(3) man page on most Unix
142 # systems.
Tim Peters0eadaac2003-04-24 16:02:54 +0000143 eastern = 'EST+05EDT,M4.1.0,M10.5.0'
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000144 victoria = 'AEST-10AEDT-11,M10.5.0,M3.5.0'
145 utc='UTC+0'
146
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000147 org_TZ = environ.get('TZ',None)
148 try:
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000149 # Make sure we can switch to UTC time and results are correct
150 # Note that unknown timezones default to UTC.
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000151 # Note that altzone is undefined in UTC, as there is no DST
152 environ['TZ'] = eastern
153 time.tzset()
154 environ['TZ'] = utc
155 time.tzset()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000156 self.assertEqual(
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000157 time.gmtime(xmas2002), time.localtime(xmas2002)
158 )
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000159 self.assertEqual(time.daylight, 0)
160 self.assertEqual(time.timezone, 0)
161 self.assertEqual(time.localtime(xmas2002).tm_isdst, 0)
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000162
163 # Make sure we can switch to US/Eastern
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000164 environ['TZ'] = eastern
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000165 time.tzset()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000166 self.assertNotEqual(time.gmtime(xmas2002), time.localtime(xmas2002))
167 self.assertEqual(time.tzname, ('EST', 'EDT'))
168 self.assertEqual(len(time.tzname), 2)
169 self.assertEqual(time.daylight, 1)
170 self.assertEqual(time.timezone, 18000)
171 self.assertEqual(time.altzone, 14400)
172 self.assertEqual(time.localtime(xmas2002).tm_isdst, 0)
173 self.assertEqual(len(time.tzname), 2)
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000174
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000175 # Now go to the southern hemisphere.
176 environ['TZ'] = victoria
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000177 time.tzset()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000178 self.assertNotEqual(time.gmtime(xmas2002), time.localtime(xmas2002))
179 self.assertTrue(time.tzname[0] == 'AEST', str(time.tzname[0]))
180 self.assertTrue(time.tzname[1] == 'AEDT', str(time.tzname[1]))
181 self.assertEqual(len(time.tzname), 2)
182 self.assertEqual(time.daylight, 1)
183 self.assertEqual(time.timezone, -36000)
184 self.assertEqual(time.altzone, -39600)
185 self.assertEqual(time.localtime(xmas2002).tm_isdst, 1)
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000186
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000187 finally:
188 # Repair TZ environment variable in case any other tests
189 # rely on it.
190 if org_TZ is not None:
191 environ['TZ'] = org_TZ
Guido van Rossume2b70bc2006-08-18 22:13:04 +0000192 elif 'TZ' in environ:
Guido van Rossumd11b62e2003-03-14 21:51:36 +0000193 del environ['TZ']
Neal Norwitz7f2588c2003-04-11 15:35:53 +0000194 time.tzset()
Tim Peters0eadaac2003-04-24 16:02:54 +0000195
Tim Peters1b6f7a92004-06-20 02:50:16 +0000196 def test_insane_timestamps(self):
197 # It's possible that some platform maps time_t to double,
198 # and that this test will fail there. This test should
199 # exempt such platforms (provided they return reasonable
200 # results!).
201 for func in time.ctime, time.gmtime, time.localtime:
202 for unreasonable in -1e200, 1e200:
203 self.assertRaises(ValueError, func, unreasonable)
Fred Drakebc561982001-05-22 17:02:02 +0000204
Fred Drakef901abd2004-08-03 17:58:55 +0000205 def test_ctime_without_arg(self):
206 # Not sure how to check the values, since the clock could tick
207 # at any time. Make sure these are at least accepted and
208 # don't raise errors.
209 time.ctime()
210 time.ctime(None)
211
212 def test_gmtime_without_arg(self):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000213 gt0 = time.gmtime()
214 gt1 = time.gmtime(None)
215 t0 = time.mktime(gt0)
216 t1 = time.mktime(gt1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000217 self.assertTrue(0 <= (t1-t0) < 0.2)
Fred Drakef901abd2004-08-03 17:58:55 +0000218
219 def test_localtime_without_arg(self):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000220 lt0 = time.localtime()
221 lt1 = time.localtime(None)
222 t0 = time.mktime(lt0)
223 t1 = time.mktime(lt1)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000224 self.assertTrue(0 <= (t1-t0) < 0.2)
Fred Drakef901abd2004-08-03 17:58:55 +0000225
Martin v. Löwis1b01ccd2009-05-30 06:13:40 +0000226class TestLocale(unittest.TestCase):
227 def setUp(self):
228 self.oldloc = locale.setlocale(locale.LC_ALL)
Fred Drake2e2be372001-09-20 21:33:42 +0000229
Martin v. Löwis1b01ccd2009-05-30 06:13:40 +0000230 def tearDown(self):
231 locale.setlocale(locale.LC_ALL, self.oldloc)
232
Martin v. Löwisa6a9c4d2009-05-30 06:15:30 +0000233 def test_bug_3061(self):
Martin v. Löwis1b01ccd2009-05-30 06:13:40 +0000234 try:
235 tmp = locale.setlocale(locale.LC_ALL, "fr_FR")
236 except locale.Error:
237 # skip this test
238 return
239 # This should not cause an exception
240 time.strftime("%B", (2009,2,1,0,0,0,0,0,0))
241
242def test_main():
243 support.run_unittest(TimeTestCase, TestLocale)
Fred Drake2e2be372001-09-20 21:33:42 +0000244
245if __name__ == "__main__":
246 test_main()