cpython-lru_cache-weakref: Lib/datetime.py annotate

annotate Lib/datetime.py @ 87690:66c1c9f32567 default tip

Add use_weakref option to functools.lru_cache The use_weakref option makes lru_cache create weak references to the function arguments when creating the cache key, which prevents them from staying in the memory forever even after all other references to them are gone. This is a proof of concept for http://bugs.python.org/issue19859

author	Radomir Dopieralski <devel@sheep.art.pl>
date	Tue, 03 Dec 2013 16:02:48 +0100
parents	6ec5d188c4db
children

rev	line source
83300 70f9f6752d28 #17571: remove broken links in datetime.py docstring. Ezio Melotti <ezio.melotti@gmail.com> parents: 79136 diff changeset	1 """Concrete date/time and related types.
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2
83300 70f9f6752d28 #17571: remove broken links in datetime.py docstring. Ezio Melotti <ezio.melotti@gmail.com> parents: 79136 diff changeset	3 See http://www.iana.org/time-zones/repository/tz-link.html for
70f9f6752d28 #17571: remove broken links in datetime.py docstring. Ezio Melotti <ezio.melotti@gmail.com> parents: 79136 diff changeset	4 time zone and DST data sources.
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	5 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	6
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	7 import time as _time
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	8 import math as _math
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	9
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	10 def _cmp(x, y):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	11 return 0 if x == y else 1 if x > y else -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	12
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	13 MINYEAR = 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	14 MAXYEAR = 9999
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	15 _MAXORDINAL = 3652059 # date.max.toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	16
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	17 # Utility functions, adapted from Python's Demo/classes/Dates.py, which
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	18 # also assumes the current Gregorian calendar indefinitely extended in
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	19 # both directions. Difference: Dates.py calls January 1 of year 0 day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	20 # number 1. The code here calls January 1 of year 1 day number 1. This is
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	21 # to match the definition of the "proleptic Gregorian" calendar in Dershowitz
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	22 # and Reingold's "Calendrical Calculations", where it's the base calendar
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	23 # for all computations. See the book for algorithms for converting between
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	24 # proleptic Gregorian ordinals and many other calendar systems.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	25
85459 6ec5d188c4db improve comment Benjamin Peterson <benjamin@python.org> parents: 85458 diff changeset	26 # -1 is a placeholder for indexing purposes.
85458 a6df3f045e8b make lists uniformly integers for the benefit of pypy Benjamin Peterson <benjamin@python.org> parents: 85419 diff changeset	27 _DAYS_IN_MONTH = [-1, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	28
85459 6ec5d188c4db improve comment Benjamin Peterson <benjamin@python.org> parents: 85458 diff changeset	29 _DAYS_BEFORE_MONTH = [-1] # -1 is a placeholder for indexing purposes.
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	30 dbm = 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	31 for dim in _DAYS_IN_MONTH[1:]:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	32 _DAYS_BEFORE_MONTH.append(dbm)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	33 dbm += dim
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	34 del dbm, dim
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	35
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	36 def _is_leap(year):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	37 "year -> 1 if leap year, else 0."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	38 return year % 4 == 0 and (year % 100 != 0 or year % 400 == 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	39
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	40 def _days_before_year(year):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	41 "year -> number of days before January 1st of year."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	42 y = year - 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	43 return y*365 + y//4 - y//100 + y//400
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	44
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	45 def _days_in_month(year, month):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	46 "year, month -> number of days in that month in that year."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	47 assert 1 <= month <= 12, month
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	48 if month == 2 and _is_leap(year):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	49 return 29
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	50 return _DAYS_IN_MONTH[month]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	51
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	52 def _days_before_month(year, month):
85221 e07f104133d5 #18705: fix a number of typos. Patch by Févry Thibault. Ezio Melotti <ezio.melotti@gmail.com> parents: 83300 diff changeset	53 "year, month -> number of days in year preceding first day of month."
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	54 assert 1 <= month <= 12, 'month must be in 1..12'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	55 return _DAYS_BEFORE_MONTH[month] + (month > 2 and _is_leap(year))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	56
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	57 def _ymd2ord(year, month, day):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	58 "year, month, day -> ordinal, considering 01-Jan-0001 as day 1."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	59 assert 1 <= month <= 12, 'month must be in 1..12'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	60 dim = _days_in_month(year, month)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	61 assert 1 <= day <= dim, ('day must be in 1..%d' % dim)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	62 return (_days_before_year(year) +
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	63 _days_before_month(year, month) +
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	64 day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	65
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	66 _DI400Y = _days_before_year(401) # number of days in 400 years
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	67 _DI100Y = _days_before_year(101) # " " " " 100 "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	68 _DI4Y = _days_before_year(5) # " " " " 4 "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	69
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	70 # A 4-year cycle has an extra leap day over what we'd get from pasting
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	71 # together 4 single years.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	72 assert _DI4Y == 4 * 365 + 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	73
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	74 # Similarly, a 400-year cycle has an extra leap day over what we'd get from
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	75 # pasting together 4 100-year cycles.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	76 assert _DI400Y == 4 * _DI100Y + 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	77
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	78 # OTOH, a 100-year cycle has one fewer leap day than we'd get from
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	79 # pasting together 25 4-year cycles.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	80 assert _DI100Y == 25 * _DI4Y - 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	81
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	82 def _ord2ymd(n):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	83 "ordinal -> (year, month, day), considering 01-Jan-0001 as day 1."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	84
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	85 # n is a 1-based index, starting at 1-Jan-1. The pattern of leap years
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	86 # repeats exactly every 400 years. The basic strategy is to find the
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	87 # closest 400-year boundary at or before n, then work with the offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	88 # from that boundary to n. Life is much clearer if we subtract 1 from
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	89 # n first -- then the values of n at 400-year boundaries are exactly
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	90 # those divisible by _DI400Y:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	91 #
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	92 # D M Y n n-1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	93 # -- --- ---- ---------- ----------------
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	94 # 31 Dec -400 -_DI400Y -_DI400Y -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	95 # 1 Jan -399 -_DI400Y +1 -_DI400Y 400-year boundary
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	96 # ...
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	97 # 30 Dec 000 -1 -2
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	98 # 31 Dec 000 0 -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	99 # 1 Jan 001 1 0 400-year boundary
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	100 # 2 Jan 001 2 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	101 # 3 Jan 001 3 2
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	102 # ...
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	103 # 31 Dec 400 _DI400Y _DI400Y -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	104 # 1 Jan 401 _DI400Y +1 _DI400Y 400-year boundary
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	105 n -= 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	106 n400, n = divmod(n, _DI400Y)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	107 year = n400 * 400 + 1 # ..., -399, 1, 401, ...
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	108
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	109 # Now n is the (non-negative) offset, in days, from January 1 of year, to
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	110 # the desired date. Now compute how many 100-year cycles precede n.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	111 # Note that it's possible for n100 to equal 4! In that case 4 full
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	112 # 100-year cycles precede the desired day, which implies the desired
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	113 # day is December 31 at the end of a 400-year cycle.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	114 n100, n = divmod(n, _DI100Y)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	115
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	116 # Now compute how many 4-year cycles precede it.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	117 n4, n = divmod(n, _DI4Y)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	118
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	119 # And now how many single years. Again n1 can be 4, and again meaning
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	120 # that the desired day is December 31 at the end of the 4-year cycle.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	121 n1, n = divmod(n, 365)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	122
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	123 year += n100 * 100 + n4 * 4 + n1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	124 if n1 == 4 or n100 == 4:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	125 assert n == 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	126 return year-1, 12, 31
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	127
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	128 # Now the year is correct, and n is the offset from January 1. We find
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	129 # the month via an estimate that's either exact or one too large.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	130 leapyear = n1 == 3 and (n4 != 24 or n100 == 3)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	131 assert leapyear == _is_leap(year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	132 month = (n + 50) >> 5
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	133 preceding = _DAYS_BEFORE_MONTH[month] + (month > 2 and leapyear)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	134 if preceding > n: # estimate is too large
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	135 month -= 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	136 preceding -= _DAYS_IN_MONTH[month] + (month == 2 and leapyear)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	137 n -= preceding
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	138 assert 0 <= n < _days_in_month(year, month)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	139
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	140 # Now the year and month are correct, and n is the offset from the
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	141 # start of that month: we're done!
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	142 return year, month, n+1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	143
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	144 # Month and day names. For localized versions, see the calendar module.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	145 _MONTHNAMES = [None, "Jan", "Feb", "Mar", "Apr", "May", "Jun",
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	146 "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	147 _DAYNAMES = [None, "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	148
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	149
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	150 def _build_struct_time(y, m, d, hh, mm, ss, dstflag):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	151 wday = (_ymd2ord(y, m, d) + 6) % 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	152 dnum = _days_before_month(y, m) + d
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	153 return _time.struct_time((y, m, d, hh, mm, ss, wday, dnum, dstflag))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	154
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	155 def _format_time(hh, mm, ss, us):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	156 # Skip trailing microseconds when us==0.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	157 result = "%02d:%02d:%02d" % (hh, mm, ss)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	158 if us:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	159 result += ".%06d" % us
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	160 return result
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	161
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	162 # Correctly substitute for %z and %Z escapes in strftime formats.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	163 def _wrap_strftime(object, format, timetuple):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	164 # Don't call utcoffset() or tzname() unless actually needed.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	165 freplace = None # the string to use for %f
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	166 zreplace = None # the string to use for %z
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	167 Zreplace = None # the string to use for %Z
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	168
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	169 # Scan format for %z and %Z escapes, replacing as needed.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	170 newformat = []
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	171 push = newformat.append
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	172 i, n = 0, len(format)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	173 while i < n:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	174 ch = format[i]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	175 i += 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	176 if ch == '%':
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	177 if i < n:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	178 ch = format[i]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	179 i += 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	180 if ch == 'f':
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	181 if freplace is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	182 freplace = '%06d' % getattr(object,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	183 'microsecond', 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	184 newformat.append(freplace)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	185 elif ch == 'z':
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	186 if zreplace is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	187 zreplace = ""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	188 if hasattr(object, "utcoffset"):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	189 offset = object.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	190 if offset is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	191 sign = '+'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	192 if offset.days < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	193 offset = -offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	194 sign = '-'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	195 h, m = divmod(offset, timedelta(hours=1))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	196 assert not m % timedelta(minutes=1), "whole minute"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	197 m //= timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	198 zreplace = '%c%02d%02d' % (sign, h, m)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	199 assert '%' not in zreplace
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	200 newformat.append(zreplace)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	201 elif ch == 'Z':
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	202 if Zreplace is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	203 Zreplace = ""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	204 if hasattr(object, "tzname"):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	205 s = object.tzname()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	206 if s is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	207 # strftime is going to have at this: escape %
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	208 Zreplace = s.replace('%', '%%')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	209 newformat.append(Zreplace)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	210 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	211 push('%')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	212 push(ch)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	213 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	214 push('%')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	215 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	216 push(ch)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	217 newformat = "".join(newformat)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	218 return _time.strftime(newformat, timetuple)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	219
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	220 def _call_tzinfo_method(tzinfo, methname, tzinfoarg):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	221 if tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	222 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	223 return getattr(tzinfo, methname)(tzinfoarg)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	224
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	225 # Just raise TypeError if the arg isn't None or a string.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	226 def _check_tzname(name):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	227 if name is not None and not isinstance(name, str):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	228 raise TypeError("tzinfo.tzname() must return None or string, "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	229 "not '%s'" % type(name))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	230
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	231 # name is the offset-producing method, "utcoffset" or "dst".
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	232 # offset is what it returned.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	233 # If offset isn't None or timedelta, raises TypeError.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	234 # If offset is None, returns None.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	235 # Else offset is checked for being in range, and a whole # of minutes.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	236 # If it is, its integer value is returned. Else ValueError is raised.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	237 def _check_utc_offset(name, offset):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	238 assert name in ("utcoffset", "dst")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	239 if offset is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	240 return
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	241 if not isinstance(offset, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	242 raise TypeError("tzinfo.%s() must return None "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	243 "or timedelta, not '%s'" % (name, type(offset)))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	244 if offset % timedelta(minutes=1) or offset.microseconds:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	245 raise ValueError("tzinfo.%s() must return a whole number "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	246 "of minutes, got %s" % (name, offset))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	247 if not -timedelta(1) < offset < timedelta(1):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	248 raise ValueError("%s()=%s, must be must be strictly between"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	249 " -timedelta(hours=24) and timedelta(hours=24)"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	250 % (name, offset))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	251
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	252 def _check_date_fields(year, month, day):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	253 if not isinstance(year, int):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	254 raise TypeError('int expected')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	255 if not MINYEAR <= year <= MAXYEAR:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	256 raise ValueError('year must be in %d..%d' % (MINYEAR, MAXYEAR), year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	257 if not 1 <= month <= 12:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	258 raise ValueError('month must be in 1..12', month)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	259 dim = _days_in_month(year, month)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	260 if not 1 <= day <= dim:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	261 raise ValueError('day must be in 1..%d' % dim, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	262
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	263 def _check_time_fields(hour, minute, second, microsecond):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	264 if not isinstance(hour, int):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	265 raise TypeError('int expected')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	266 if not 0 <= hour <= 23:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	267 raise ValueError('hour must be in 0..23', hour)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	268 if not 0 <= minute <= 59:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	269 raise ValueError('minute must be in 0..59', minute)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	270 if not 0 <= second <= 59:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	271 raise ValueError('second must be in 0..59', second)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	272 if not 0 <= microsecond <= 999999:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	273 raise ValueError('microsecond must be in 0..999999', microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	274
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	275 def _check_tzinfo_arg(tz):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	276 if tz is not None and not isinstance(tz, tzinfo):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	277 raise TypeError("tzinfo argument must be None or of a tzinfo subclass")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	278
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	279 def _cmperror(x, y):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	280 raise TypeError("can't compare '%s' to '%s'" % (
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	281 type(x).__name__, type(y).__name__))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	282
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	283 class timedelta:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	284 """Represent the difference between two datetime objects.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	285
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	286 Supported operators:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	287
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	288 - add, subtract timedelta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	289 - unary plus, minus, abs
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	290 - compare to timedelta
85418 4d62a62ba44d Issue #18783: Removed existing mentions of Python long type in docstrings, Serhiy Storchaka <storchaka@gmail.com> parents: 85221 diff changeset	291 - multiply, divide by int
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	292
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	293 In addition, datetime supports subtraction of two datetime objects
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	294 returning a timedelta, and addition or subtraction of a datetime
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	295 and a timedelta giving a datetime.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	296
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	297 Representation: (days, seconds, microseconds). Why? Because I
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	298 felt like it.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	299 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	300 __slots__ = '_days', '_seconds', '_microseconds'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	301
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	302 def __new__(cls, days=0, seconds=0, microseconds=0,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	303 milliseconds=0, minutes=0, hours=0, weeks=0):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	304 # Doing this efficiently and accurately in C is going to be difficult
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	305 # and error-prone, due to ubiquitous overflow possibilities, and that
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	306 # C double doesn't have enough bits of precision to represent
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	307 # microseconds over 10K years faithfully. The code here tries to make
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	308 # explicit where go-fast assumptions can be relied on, in order to
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	309 # guide the C implementation; it's way more convoluted than speed-
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	310 # ignoring auto-overflow-to-long idiomatic Python could be.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	311
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	312 # XXX Check that all inputs are ints or floats.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	313
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	314 # Final values, all integer.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	315 # s and us fit in 32-bit signed ints; d isn't bounded.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	316 d = s = us = 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	317
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	318 # Normalize everything to days, seconds, microseconds.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	319 days += weeks*7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	320 seconds += minutes60 + hours3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	321 microseconds += milliseconds*1000
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	322
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	323 # Get rid of all fractions, and normalize s and us.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	324 # Take a deep breath <wink>.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	325 if isinstance(days, float):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	326 dayfrac, days = _math.modf(days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	327 daysecondsfrac, daysecondswhole = _math.modf(dayfrac * (24.*3600.))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	328 assert daysecondswhole == int(daysecondswhole) # can't overflow
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	329 s = int(daysecondswhole)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	330 assert days == int(days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	331 d = int(days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	332 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	333 daysecondsfrac = 0.0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	334 d = days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	335 assert isinstance(daysecondsfrac, float)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	336 assert abs(daysecondsfrac) <= 1.0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	337 assert isinstance(d, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	338 assert abs(s) <= 24 * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	339 # days isn't referenced again before redefinition
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	340
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	341 if isinstance(seconds, float):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	342 secondsfrac, seconds = _math.modf(seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	343 assert seconds == int(seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	344 seconds = int(seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	345 secondsfrac += daysecondsfrac
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	346 assert abs(secondsfrac) <= 2.0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	347 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	348 secondsfrac = daysecondsfrac
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	349 # daysecondsfrac isn't referenced again
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	350 assert isinstance(secondsfrac, float)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	351 assert abs(secondsfrac) <= 2.0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	352
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	353 assert isinstance(seconds, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	354 days, seconds = divmod(seconds, 24*3600)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	355 d += days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	356 s += int(seconds) # can't overflow
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	357 assert isinstance(s, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	358 assert abs(s) <= 2 * 24 * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	359 # seconds isn't referenced again before redefinition
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	360
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	361 usdouble = secondsfrac * 1e6
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	362 assert abs(usdouble) < 2.1e6 # exact value not critical
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	363 # secondsfrac isn't referenced again
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	364
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	365 if isinstance(microseconds, float):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	366 microseconds += usdouble
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	367 microseconds = round(microseconds, 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	368 seconds, microseconds = divmod(microseconds, 1e6)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	369 assert microseconds == int(microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	370 assert seconds == int(seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	371 days, seconds = divmod(seconds, 24.*3600.)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	372 assert days == int(days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	373 assert seconds == int(seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	374 d += int(days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	375 s += int(seconds) # can't overflow
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	376 assert isinstance(s, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	377 assert abs(s) <= 3 * 24 * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	378 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	379 seconds, microseconds = divmod(microseconds, 1000000)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	380 days, seconds = divmod(seconds, 24*3600)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	381 d += days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	382 s += int(seconds) # can't overflow
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	383 assert isinstance(s, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	384 assert abs(s) <= 3 * 24 * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	385 microseconds = float(microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	386 microseconds += usdouble
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	387 microseconds = round(microseconds, 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	388 assert abs(s) <= 3 * 24 * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	389 assert abs(microseconds) < 3.1e6
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	390
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	391 # Just a little bit of carrying possible for microseconds and seconds.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	392 assert isinstance(microseconds, float)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	393 assert int(microseconds) == microseconds
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	394 us = int(microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	395 seconds, us = divmod(us, 1000000)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	396 s += seconds # cant't overflow
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	397 assert isinstance(s, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	398 days, s = divmod(s, 24*3600)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	399 d += days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	400
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	401 assert isinstance(d, int)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	402 assert isinstance(s, int) and 0 <= s < 24*3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	403 assert isinstance(us, int) and 0 <= us < 1000000
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	404
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	405 self = object.__new__(cls)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	406
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	407 self._days = d
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	408 self._seconds = s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	409 self._microseconds = us
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	410 if abs(d) > 999999999:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	411 raise OverflowError("timedelta # of days is too large: %d" % d)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	412
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	413 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	414
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	415 def __repr__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	416 if self._microseconds:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	417 return "%s(%d, %d, %d)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	418 self._days,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	419 self._seconds,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	420 self._microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	421 if self._seconds:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	422 return "%s(%d, %d)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	423 self._days,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	424 self._seconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	425 return "%s(%d)" % ('datetime.' + self.__class__.__name__, self._days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	426
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	427 def __str__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	428 mm, ss = divmod(self._seconds, 60)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	429 hh, mm = divmod(mm, 60)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	430 s = "%d:%02d:%02d" % (hh, mm, ss)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	431 if self._days:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	432 def plural(n):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	433 return n, abs(n) != 1 and "s" or ""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	434 s = ("%d day%s, " % plural(self._days)) + s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	435 if self._microseconds:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	436 s = s + ".%06d" % self._microseconds
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	437 return s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	438
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	439 def total_seconds(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	440 """Total seconds in the duration."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	441 return ((self.days * 86400 + self.seconds)10*6 +
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	442 self.microseconds) / 10**6
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	443
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	444 # Read-only field accessors
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	445 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	446 def days(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	447 """days"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	448 return self._days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	449
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	450 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	451 def seconds(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	452 """seconds"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	453 return self._seconds
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	454
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	455 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	456 def microseconds(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	457 """microseconds"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	458 return self._microseconds
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	459
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	460 def __add__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	461 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	462 # for CPython compatibility, we cannot use
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	463 # our __class__ here, but need a real timedelta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	464 return timedelta(self._days + other._days,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	465 self._seconds + other._seconds,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	466 self._microseconds + other._microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	467 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	468
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	469 __radd__ = __add__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	470
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	471 def __sub__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	472 if isinstance(other, timedelta):
69163 76180cc853b6 Issue #11576: Fixed timedelta subtraction glitch on big timedelta values Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 67450 diff changeset	473 # for CPython compatibility, we cannot use
76180cc853b6 Issue #11576: Fixed timedelta subtraction glitch on big timedelta values Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 67450 diff changeset	474 # our __class__ here, but need a real timedelta
76180cc853b6 Issue #11576: Fixed timedelta subtraction glitch on big timedelta values Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 67450 diff changeset	475 return timedelta(self._days - other._days,
76180cc853b6 Issue #11576: Fixed timedelta subtraction glitch on big timedelta values Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 67450 diff changeset	476 self._seconds - other._seconds,
76180cc853b6 Issue #11576: Fixed timedelta subtraction glitch on big timedelta values Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 67450 diff changeset	477 self._microseconds - other._microseconds)
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	478 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	479
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	480 def __rsub__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	481 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	482 return -self + other
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	483 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	484
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	485 def __neg__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	486 # for CPython compatibility, we cannot use
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	487 # our __class__ here, but need a real timedelta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	488 return timedelta(-self._days,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	489 -self._seconds,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	490 -self._microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	491
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	492 def __pos__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	493 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	494
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	495 def __abs__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	496 if self._days < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	497 return -self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	498 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	499 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	500
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	501 def __mul__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	502 if isinstance(other, int):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	503 # for CPython compatibility, we cannot use
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	504 # our __class__ here, but need a real timedelta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	505 return timedelta(self._days * other,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	506 self._seconds * other,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	507 self._microseconds * other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	508 if isinstance(other, float):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	509 a, b = other.as_integer_ratio()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	510 return self * a / b
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	511 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	512
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	513 __rmul__ = __mul__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	514
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	515 def _to_microseconds(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	516 return ((self._days * (243600) + self._seconds) 1000000 +
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	517 self._microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	518
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	519 def __floordiv__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	520 if not isinstance(other, (int, timedelta)):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	521 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	522 usec = self._to_microseconds()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	523 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	524 return usec // other._to_microseconds()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	525 if isinstance(other, int):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	526 return timedelta(0, 0, usec // other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	527
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	528 def __truediv__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	529 if not isinstance(other, (int, float, timedelta)):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	530 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	531 usec = self._to_microseconds()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	532 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	533 return usec / other._to_microseconds()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	534 if isinstance(other, int):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	535 return timedelta(0, 0, usec / other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	536 if isinstance(other, float):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	537 a, b = other.as_integer_ratio()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	538 return timedelta(0, 0, b * usec / a)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	539
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	540 def __mod__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	541 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	542 r = self._to_microseconds() % other._to_microseconds()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	543 return timedelta(0, 0, r)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	544 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	545
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	546 def __divmod__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	547 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	548 q, r = divmod(self._to_microseconds(),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	549 other._to_microseconds())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	550 return q, timedelta(0, 0, r)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	551 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	552
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	553 # Comparisons of timedelta objects with other.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	554
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	555 def __eq__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	556 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	557 return self._cmp(other) == 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	558 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	559 return False
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	560
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	561 def __ne__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	562 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	563 return self._cmp(other) != 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	564 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	565 return True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	566
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	567 def __le__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	568 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	569 return self._cmp(other) <= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	570 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	571 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	572
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	573 def __lt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	574 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	575 return self._cmp(other) < 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	576 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	577 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	578
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	579 def __ge__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	580 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	581 return self._cmp(other) >= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	582 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	583 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	584
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	585 def __gt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	586 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	587 return self._cmp(other) > 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	588 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	589 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	590
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	591 def _cmp(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	592 assert isinstance(other, timedelta)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	593 return _cmp(self._getstate(), other._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	594
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	595 def __hash__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	596 return hash(self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	597
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	598 def __bool__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	599 return (self._days != 0 or
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	600 self._seconds != 0 or
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	601 self._microseconds != 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	602
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	603 # Pickle support.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	604
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	605 def _getstate(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	606 return (self._days, self._seconds, self._microseconds)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	607
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	608 def __reduce__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	609 return (self.__class__, self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	610
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	611 timedelta.min = timedelta(-999999999)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	612 timedelta.max = timedelta(days=999999999, hours=23, minutes=59, seconds=59,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	613 microseconds=999999)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	614 timedelta.resolution = timedelta(microseconds=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	615
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	616 class date:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	617 """Concrete date type.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	618
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	619 Constructors:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	620
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	621 __new__()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	622 fromtimestamp()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	623 today()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	624 fromordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	625
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	626 Operators:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	627
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	628 __repr__, __str__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	629 __cmp__, __hash__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	630 __add__, __radd__, __sub__ (add/radd only with timedelta arg)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	631
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	632 Methods:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	633
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	634 timetuple()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	635 toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	636 weekday()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	637 isoweekday(), isocalendar(), isoformat()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	638 ctime()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	639 strftime()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	640
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	641 Properties (readonly):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	642 year, month, day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	643 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	644 __slots__ = '_year', '_month', '_day'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	645
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	646 def __new__(cls, year, month=None, day=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	647 """Constructor.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	648
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	649 Arguments:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	650
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	651 year, month, day (required, base 1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	652 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	653 if (isinstance(year, bytes) and len(year) == 4 and
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	654 1 <= year[2] <= 12 and month is None): # Month is sane
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	655 # Pickle support
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	656 self = object.__new__(cls)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	657 self.__setstate(year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	658 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	659 _check_date_fields(year, month, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	660 self = object.__new__(cls)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	661 self._year = year
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	662 self._month = month
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	663 self._day = day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	664 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	665
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	666 # Additional constructors
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	667
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	668 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	669 def fromtimestamp(cls, t):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	670 "Construct a date from a POSIX timestamp (like time.time())."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	671 y, m, d, hh, mm, ss, weekday, jday, dst = _time.localtime(t)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	672 return cls(y, m, d)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	673
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	674 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	675 def today(cls):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	676 "Construct a date from time.time()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	677 t = _time.time()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	678 return cls.fromtimestamp(t)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	679
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	680 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	681 def fromordinal(cls, n):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	682 """Contruct a date from a proleptic Gregorian ordinal.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	683
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	684 January 1 of year 1 is day 1. Only the year, month and day are
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	685 non-zero in the result.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	686 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	687 y, m, d = _ord2ymd(n)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	688 return cls(y, m, d)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	689
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	690 # Conversions to string
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	691
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	692 def __repr__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	693 """Convert to formal string, for repr().
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	694
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	695 >>> dt = datetime(2010, 1, 1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	696 >>> repr(dt)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	697 'datetime.datetime(2010, 1, 1, 0, 0)'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	698
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	699 >>> dt = datetime(2010, 1, 1, tzinfo=timezone.utc)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	700 >>> repr(dt)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	701 'datetime.datetime(2010, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	702 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	703 return "%s(%d, %d, %d)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	704 self._year,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	705 self._month,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	706 self._day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	707 # XXX These shouldn't depend on time.localtime(), because that
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	708 # clips the usable dates to [1970 .. 2038). At least ctime() is
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	709 # easily done without using strftime() -- that's better too because
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	710 # strftime("%c", ...) is locale specific.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	711
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	712
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	713 def ctime(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	714 "Return ctime() style string."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	715 weekday = self.toordinal() % 7 or 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	716 return "%s %s %2d 00:00:00 %04d" % (
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	717 _DAYNAMES[weekday],
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	718 _MONTHNAMES[self._month],
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	719 self._day, self._year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	720
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	721 def strftime(self, fmt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	722 "Format using strftime()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	723 return _wrap_strftime(self, fmt, self.timetuple())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	724
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	725 def __format__(self, fmt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	726 if len(fmt) != 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	727 return self.strftime(fmt)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	728 return str(self)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	729
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	730 def isoformat(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	731 """Return the date formatted according to ISO.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	732
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	733 This is 'YYYY-MM-DD'.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	734
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	735 References:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	736 - http://www.w3.org/TR/NOTE-datetime
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	737 - http://www.cl.cam.ac.uk/~mgk25/iso-time.html
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	738 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	739 return "%04d-%02d-%02d" % (self._year, self._month, self._day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	740
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	741 __str__ = isoformat
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	742
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	743 # Read-only field accessors
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	744 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	745 def year(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	746 """year (1-9999)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	747 return self._year
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	748
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	749 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	750 def month(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	751 """month (1-12)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	752 return self._month
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	753
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	754 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	755 def day(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	756 """day (1-31)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	757 return self._day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	758
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	759 # Standard conversions, __cmp__, __hash__ (and helpers)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	760
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	761 def timetuple(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	762 "Return local time tuple compatible with time.localtime()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	763 return _build_struct_time(self._year, self._month, self._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	764 0, 0, 0, -1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	765
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	766 def toordinal(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	767 """Return proleptic Gregorian ordinal for the year, month and day.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	768
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	769 January 1 of year 1 is day 1. Only the year, month and day values
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	770 contribute to the result.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	771 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	772 return _ymd2ord(self._year, self._month, self._day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	773
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	774 def replace(self, year=None, month=None, day=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	775 """Return a new date with new values for the specified fields."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	776 if year is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	777 year = self._year
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	778 if month is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	779 month = self._month
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	780 if day is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	781 day = self._day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	782 _check_date_fields(year, month, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	783 return date(year, month, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	784
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	785 # Comparisons of date objects with other.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	786
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	787 def __eq__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	788 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	789 return self._cmp(other) == 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	790 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	791
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	792 def __ne__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	793 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	794 return self._cmp(other) != 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	795 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	796
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	797 def __le__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	798 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	799 return self._cmp(other) <= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	800 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	801
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	802 def __lt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	803 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	804 return self._cmp(other) < 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	805 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	806
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	807 def __ge__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	808 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	809 return self._cmp(other) >= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	810 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	811
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	812 def __gt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	813 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	814 return self._cmp(other) > 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	815 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	816
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	817 def _cmp(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	818 assert isinstance(other, date)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	819 y, m, d = self._year, self._month, self._day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	820 y2, m2, d2 = other._year, other._month, other._day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	821 return _cmp((y, m, d), (y2, m2, d2))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	822
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	823 def __hash__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	824 "Hash."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	825 return hash(self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	826
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	827 # Computations
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	828
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	829 def __add__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	830 "Add a date to a timedelta."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	831 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	832 o = self.toordinal() + other.days
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	833 if 0 < o <= _MAXORDINAL:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	834 return date.fromordinal(o)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	835 raise OverflowError("result out of range")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	836 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	837
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	838 __radd__ = __add__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	839
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	840 def __sub__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	841 """Subtract two dates, or a date and a timedelta."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	842 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	843 return self + timedelta(-other.days)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	844 if isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	845 days1 = self.toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	846 days2 = other.toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	847 return timedelta(days1 - days2)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	848 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	849
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	850 def weekday(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	851 "Return day of the week, where Monday == 0 ... Sunday == 6."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	852 return (self.toordinal() + 6) % 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	853
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	854 # Day-of-the-week and week-of-the-year, according to ISO
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	855
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	856 def isoweekday(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	857 "Return day of the week, where Monday == 1 ... Sunday == 7."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	858 # 1-Jan-0001 is a Monday
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	859 return self.toordinal() % 7 or 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	860
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	861 def isocalendar(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	862 """Return a 3-tuple containing ISO year, week number, and weekday.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	863
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	864 The first ISO week of the year is the (Mon-Sun) week
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	865 containing the year's first Thursday; everything else derives
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	866 from that.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	867
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	868 The first week is 1; Monday is 1 ... Sunday is 7.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	869
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	870 ISO calendar algorithm taken from
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	871 http://www.phys.uu.nl/~vgent/calendar/isocalendar.htm
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	872 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	873 year = self._year
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	874 week1monday = _isoweek1monday(year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	875 today = _ymd2ord(self._year, self._month, self._day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	876 # Internally, week and day have origin 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	877 week, day = divmod(today - week1monday, 7)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	878 if week < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	879 year -= 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	880 week1monday = _isoweek1monday(year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	881 week, day = divmod(today - week1monday, 7)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	882 elif week >= 52:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	883 if today >= _isoweek1monday(year+1):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	884 year += 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	885 week = 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	886 return year, week+1, day+1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	887
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	888 # Pickle support.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	889
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	890 def _getstate(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	891 yhi, ylo = divmod(self._year, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	892 return bytes([yhi, ylo, self._month, self._day]),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	893
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	894 def __setstate(self, string):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	895 if len(string) != 4 or not (1 <= string[2] <= 12):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	896 raise TypeError("not enough arguments")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	897 yhi, ylo, self._month, self._day = string
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	898 self._year = yhi * 256 + ylo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	899
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	900 def __reduce__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	901 return (self.__class__, self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	902
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	903 _date_class = date # so functions w/ args named "date" can get at the class
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	904
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	905 date.min = date(1, 1, 1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	906 date.max = date(9999, 12, 31)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	907 date.resolution = timedelta(days=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	908
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	909 class tzinfo:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	910 """Abstract base class for time zone info classes.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	911
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	912 Subclasses must override the name(), utcoffset() and dst() methods.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	913 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	914 __slots__ = ()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	915 def tzname(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	916 "datetime -> string name of time zone."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	917 raise NotImplementedError("tzinfo subclass must override tzname()")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	918
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	919 def utcoffset(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	920 "datetime -> minutes east of UTC (negative for west of UTC)"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	921 raise NotImplementedError("tzinfo subclass must override utcoffset()")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	922
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	923 def dst(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	924 """datetime -> DST offset in minutes east of UTC.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	925
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	926 Return 0 if DST not in effect. utcoffset() must include the DST
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	927 offset.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	928 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	929 raise NotImplementedError("tzinfo subclass must override dst()")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	930
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	931 def fromutc(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	932 "datetime in UTC -> datetime in local time."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	933
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	934 if not isinstance(dt, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	935 raise TypeError("fromutc() requires a datetime argument")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	936 if dt.tzinfo is not self:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	937 raise ValueError("dt.tzinfo is not self")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	938
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	939 dtoff = dt.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	940 if dtoff is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	941 raise ValueError("fromutc() requires a non-None utcoffset() "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	942 "result")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	943
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	944 # See the long comment block at the end of this file for an
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	945 # explanation of this algorithm.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	946 dtdst = dt.dst()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	947 if dtdst is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	948 raise ValueError("fromutc() requires a non-None dst() result")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	949 delta = dtoff - dtdst
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	950 if delta:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	951 dt += delta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	952 dtdst = dt.dst()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	953 if dtdst is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	954 raise ValueError("fromutc(): dt.dst gave inconsistent "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	955 "results; cannot convert")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	956 return dt + dtdst
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	957
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	958 # Pickle support.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	959
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	960 def __reduce__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	961 getinitargs = getattr(self, "__getinitargs__", None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	962 if getinitargs:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	963 args = getinitargs()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	964 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	965 args = ()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	966 getstate = getattr(self, "__getstate__", None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	967 if getstate:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	968 state = getstate()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	969 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	970 state = getattr(self, "__dict__", None) or None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	971 if state is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	972 return (self.__class__, args)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	973 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	974 return (self.__class__, args, state)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	975
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	976 _tzinfo_class = tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	977
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	978 class time:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	979 """Time with time zone.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	980
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	981 Constructors:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	982
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	983 __new__()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	984
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	985 Operators:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	986
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	987 __repr__, __str__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	988 __cmp__, __hash__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	989
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	990 Methods:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	991
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	992 strftime()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	993 isoformat()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	994 utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	995 tzname()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	996 dst()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	997
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	998 Properties (readonly):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	999 hour, minute, second, microsecond, tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1000 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1001
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1002 def __new__(cls, hour=0, minute=0, second=0, microsecond=0, tzinfo=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1003 """Constructor.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1004
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1005 Arguments:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1006
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1007 hour, minute (required)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1008 second, microsecond (default to zero)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1009 tzinfo (default to None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1010 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1011 self = object.__new__(cls)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1012 if isinstance(hour, bytes) and len(hour) == 6:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1013 # Pickle support
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1014 self.__setstate(hour, minute or None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1015 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1016 _check_tzinfo_arg(tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1017 _check_time_fields(hour, minute, second, microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1018 self._hour = hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1019 self._minute = minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1020 self._second = second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1021 self._microsecond = microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1022 self._tzinfo = tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1023 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1024
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1025 # Read-only field accessors
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1026 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1027 def hour(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1028 """hour (0-23)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1029 return self._hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1030
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1031 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1032 def minute(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1033 """minute (0-59)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1034 return self._minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1035
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1036 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1037 def second(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1038 """second (0-59)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1039 return self._second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1040
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1041 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1042 def microsecond(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1043 """microsecond (0-999999)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1044 return self._microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1045
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1046 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1047 def tzinfo(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1048 """timezone info object"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1049 return self._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1050
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1051 # Standard conversions, __hash__ (and helpers)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1052
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1053 # Comparisons of time objects with other.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1054
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1055 def __eq__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1056 if isinstance(other, time):
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1057 return self._cmp(other, allow_mixed=True) == 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1058 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1059 return False
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1060
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1061 def __ne__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1062 if isinstance(other, time):
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1063 return self._cmp(other, allow_mixed=True) != 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1064 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1065 return True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1066
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1067 def __le__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1068 if isinstance(other, time):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1069 return self._cmp(other) <= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1070 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1071 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1072
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1073 def __lt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1074 if isinstance(other, time):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1075 return self._cmp(other) < 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1076 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1077 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1078
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1079 def __ge__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1080 if isinstance(other, time):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1081 return self._cmp(other) >= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1082 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1083 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1084
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1085 def __gt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1086 if isinstance(other, time):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1087 return self._cmp(other) > 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1088 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1089 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1090
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1091 def _cmp(self, other, allow_mixed=False):
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1092 assert isinstance(other, time)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1093 mytz = self._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1094 ottz = other._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1095 myoff = otoff = None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1096
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1097 if mytz is ottz:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1098 base_compare = True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1099 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1100 myoff = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1101 otoff = other.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1102 base_compare = myoff == otoff
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1103
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1104 if base_compare:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1105 return _cmp((self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1106 self._microsecond),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1107 (other._hour, other._minute, other._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1108 other._microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1109 if myoff is None or otoff is None:
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1110 if allow_mixed:
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1111 return 2 # arbitrary non-zero value
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1112 else:
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1113 raise TypeError("cannot compare naive and aware times")
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1114 myhhmm = self._hour * 60 + self._minute - myoff//timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1115 othhmm = other._hour * 60 + other._minute - otoff//timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1116 return _cmp((myhhmm, self._second, self._microsecond),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1117 (othhmm, other._second, other._microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1118
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1119 def __hash__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1120 """Hash."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1121 tzoff = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1122 if not tzoff: # zero or None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1123 return hash(self._getstate()[0])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1124 h, m = divmod(timedelta(hours=self.hour, minutes=self.minute) - tzoff,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1125 timedelta(hours=1))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1126 assert not m % timedelta(minutes=1), "whole minute"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1127 m //= timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1128 if 0 <= h < 24:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1129 return hash(time(h, m, self.second, self.microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1130 return hash((h, m, self.second, self.microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1131
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1132 # Conversion to string
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1133
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1134 def _tzstr(self, sep=":"):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1135 """Return formatted timezone offset (+xx:xx) or None."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1136 off = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1137 if off is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1138 if off.days < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1139 sign = "-"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1140 off = -off
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1141 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1142 sign = "+"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1143 hh, mm = divmod(off, timedelta(hours=1))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1144 assert not mm % timedelta(minutes=1), "whole minute"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1145 mm //= timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1146 assert 0 <= hh < 24
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1147 off = "%s%02d%s%02d" % (sign, hh, sep, mm)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1148 return off
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1149
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1150 def __repr__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1151 """Convert to formal string, for repr()."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1152 if self._microsecond != 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1153 s = ", %d, %d" % (self._second, self._microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1154 elif self._second != 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1155 s = ", %d" % self._second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1156 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1157 s = ""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1158 s= "%s(%d, %d%s)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1159 self._hour, self._minute, s)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1160 if self._tzinfo is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1161 assert s[-1:] == ")"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1162 s = s[:-1] + ", tzinfo=%r" % self._tzinfo + ")"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1163 return s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1164
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1165 def isoformat(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1166 """Return the time formatted according to ISO.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1167
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1168 This is 'HH:MM:SS.mmmmmm+zz:zz', or 'HH:MM:SS+zz:zz' if
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1169 self.microsecond == 0.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1170 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1171 s = _format_time(self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1172 self._microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1173 tz = self._tzstr()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1174 if tz:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1175 s += tz
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1176 return s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1177
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1178 __str__ = isoformat
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1179
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1180 def strftime(self, fmt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1181 """Format using strftime(). The date part of the timestamp passed
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1182 to underlying strftime should not be used.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1183 """
67450 31465968ae26 Issue #1777412: extended year range of strftime down to 1000. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 65319 diff changeset	1184 # The year must be >= 1000 else Python's strftime implementation
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1185 # can raise a bogus exception.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1186 timetuple = (1900, 1, 1,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1187 self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1188 0, 1, -1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1189 return _wrap_strftime(self, fmt, timetuple)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1190
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1191 def __format__(self, fmt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1192 if len(fmt) != 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1193 return self.strftime(fmt)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1194 return str(self)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1195
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1196 # Timezone functions
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1197
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1198 def utcoffset(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1199 """Return the timezone offset in minutes east of UTC (negative west of
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1200 UTC)."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1201 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1202 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1203 offset = self._tzinfo.utcoffset(None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1204 _check_utc_offset("utcoffset", offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1205 return offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1206
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1207 def tzname(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1208 """Return the timezone name.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1209
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1210 Note that the name is 100% informational -- there's no requirement that
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1211 it mean anything in particular. For example, "GMT", "UTC", "-500",
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1212 "-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1213 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1214 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1215 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1216 name = self._tzinfo.tzname(None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1217 _check_tzname(name)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1218 return name
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1219
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1220 def dst(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1221 """Return 0 if DST is not in effect, or the DST offset (in minutes
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1222 eastward) if DST is in effect.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1223
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1224 This is purely informational; the DST offset has already been added to
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1225 the UTC offset returned by utcoffset() if applicable, so there's no
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1226 need to consult dst() unless you're interested in displaying the DST
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1227 info.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1228 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1229 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1230 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1231 offset = self._tzinfo.dst(None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1232 _check_utc_offset("dst", offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1233 return offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1234
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1235 def replace(self, hour=None, minute=None, second=None, microsecond=None,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1236 tzinfo=True):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1237 """Return a new time with new values for the specified fields."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1238 if hour is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1239 hour = self.hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1240 if minute is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1241 minute = self.minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1242 if second is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1243 second = self.second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1244 if microsecond is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1245 microsecond = self.microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1246 if tzinfo is True:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1247 tzinfo = self.tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1248 _check_time_fields(hour, minute, second, microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1249 _check_tzinfo_arg(tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1250 return time(hour, minute, second, microsecond, tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1251
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1252 def __bool__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1253 if self.second or self.microsecond:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1254 return True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1255 offset = self.utcoffset() or timedelta(0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1256 return timedelta(hours=self.hour, minutes=self.minute) != offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1257
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1258 # Pickle support.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1259
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1260 def _getstate(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1261 us2, us3 = divmod(self._microsecond, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1262 us1, us2 = divmod(us2, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1263 basestate = bytes([self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1264 us1, us2, us3])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1265 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1266 return (basestate,)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1267 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1268 return (basestate, self._tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1269
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1270 def __setstate(self, string, tzinfo):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1271 if len(string) != 6 or string[0] >= 24:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1272 raise TypeError("an integer is required")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1273 (self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1274 us1, us2, us3) = string
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1275 self._microsecond = (((us1 << 8) \| us2) << 8) \| us3
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1276 if tzinfo is None or isinstance(tzinfo, _tzinfo_class):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1277 self._tzinfo = tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1278 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1279 raise TypeError("bad tzinfo state arg %r" % tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1280
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1281 def __reduce__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1282 return (time, self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1283
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1284 _time_class = time # so functions w/ args named "time" can get at the class
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1285
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1286 time.min = time(0, 0, 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1287 time.max = time(23, 59, 59, 999999)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1288 time.resolution = timedelta(microseconds=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1289
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1290 class datetime(date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1291 """datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1292
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1293 The year, month and day arguments are required. tzinfo may be None, or an
85418 4d62a62ba44d Issue #18783: Removed existing mentions of Python long type in docstrings, Serhiy Storchaka <storchaka@gmail.com> parents: 85221 diff changeset	1294 instance of a tzinfo subclass. The remaining arguments may be ints.
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1295 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1296
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1297 __slots__ = date.__slots__ + (
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1298 '_hour', '_minute', '_second',
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1299 '_microsecond', '_tzinfo')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1300 def __new__(cls, year, month=None, day=None, hour=0, minute=0, second=0,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1301 microsecond=0, tzinfo=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1302 if isinstance(year, bytes) and len(year) == 10:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1303 # Pickle support
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1304 self = date.__new__(cls, year[:4])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1305 self.__setstate(year, month)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1306 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1307 _check_tzinfo_arg(tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1308 _check_time_fields(hour, minute, second, microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1309 self = date.__new__(cls, year, month, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1310 self._hour = hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1311 self._minute = minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1312 self._second = second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1313 self._microsecond = microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1314 self._tzinfo = tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1315 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1316
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1317 # Read-only field accessors
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1318 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1319 def hour(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1320 """hour (0-23)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1321 return self._hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1322
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1323 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1324 def minute(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1325 """minute (0-59)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1326 return self._minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1327
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1328 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1329 def second(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1330 """second (0-59)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1331 return self._second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1332
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1333 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1334 def microsecond(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1335 """microsecond (0-999999)"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1336 return self._microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1337
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1338 @property
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1339 def tzinfo(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1340 """timezone info object"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1341 return self._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1342
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1343 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1344 def fromtimestamp(cls, t, tz=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1345 """Construct a datetime from a POSIX timestamp (like time.time()).
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1346
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1347 A timezone info object may be passed in as well.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1348 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1349
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1350 _check_tzinfo_arg(tz)
63223 f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1351
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1352 converter = _time.localtime if tz is None else _time.gmtime
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1353
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1354 t, frac = divmod(t, 1.0)
75590 1e9cc1a03365 Close #14180: Factorize code to convert a number of seconds to time_t, timeval or timespec Victor Stinner <vstinner@wyplay.com> parents: 72986 diff changeset	1355 us = int(frac * 1e6)
63223 f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1356
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1357 # If timestamp is less than one microsecond smaller than a
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1358 # full second, us can be rounded up to 1000000. In this case,
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1359 # roll over to seconds, otherwise, ValueError is raised
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1360 # by the constructor.
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1361 if us == 1000000:
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1362 t += 1
f6b92808b9b3 Make python version of fromtimestamp behave more like C. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63187 diff changeset	1363 us = 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1364 y, m, d, hh, mm, ss, weekday, jday, dst = converter(t)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1365 ss = min(ss, 59) # clamp out leap seconds if the platform has them
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1366 result = cls(y, m, d, hh, mm, ss, us, tz)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1367 if tz is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1368 result = tz.fromutc(result)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1369 return result
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1370
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1371 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1372 def utcfromtimestamp(cls, t):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1373 "Construct a UTC datetime from a POSIX timestamp (like time.time())."
64883 2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1374 t, frac = divmod(t, 1.0)
75590 1e9cc1a03365 Close #14180: Factorize code to convert a number of seconds to time_t, timeval or timespec Victor Stinner <vstinner@wyplay.com> parents: 72986 diff changeset	1375 us = int(frac * 1e6)
64883 2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1376
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1377 # If timestamp is less than one microsecond smaller than a
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1378 # full second, us can be rounded up to 1000000. In this case,
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1379 # roll over to seconds, otherwise, ValueError is raised
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1380 # by the constructor.
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1381 if us == 1000000:
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1382 t += 1
2b9327777832 Fixed microsecond rounding in python version of utcfromtimestamp Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63223 diff changeset	1383 us = 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1384 y, m, d, hh, mm, ss, weekday, jday, dst = _time.gmtime(t)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1385 ss = min(ss, 59) # clamp out leap seconds if the platform has them
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1386 return cls(y, m, d, hh, mm, ss, us)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1387
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1388 # XXX This is supposed to do better than we can do by using time.time(),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1389 # XXX if the platform supports a more accurate way. The C implementation
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1390 # XXX uses gettimeofday on platforms that have it, but that isn't
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1391 # XXX available from Python. So now() may return different results
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1392 # XXX across the implementations.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1393 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1394 def now(cls, tz=None):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1395 "Construct a datetime from time.time() and optional time zone info."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1396 t = _time.time()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1397 return cls.fromtimestamp(t, tz)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1398
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1399 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1400 def utcnow(cls):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1401 "Construct a UTC datetime from time.time()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1402 t = _time.time()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1403 return cls.utcfromtimestamp(t)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1404
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1405 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1406 def combine(cls, date, time):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1407 "Construct a datetime from a given date and a given time."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1408 if not isinstance(date, _date_class):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1409 raise TypeError("date argument must be a date instance")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1410 if not isinstance(time, _time_class):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1411 raise TypeError("time argument must be a time instance")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1412 return cls(date.year, date.month, date.day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1413 time.hour, time.minute, time.second, time.microsecond,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1414 time.tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1415
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1416 def timetuple(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1417 "Return local time tuple compatible with time.localtime()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1418 dst = self.dst()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1419 if dst is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1420 dst = -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1421 elif dst:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1422 dst = 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1423 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1424 dst = 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1425 return _build_struct_time(self.year, self.month, self.day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1426 self.hour, self.minute, self.second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1427 dst)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1428
77384 6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1429 def timestamp(self):
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1430 "Return POSIX timestamp as float"
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1431 if self._tzinfo is None:
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1432 return _time.mktime((self.year, self.month, self.day,
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1433 self.hour, self.minute, self.second,
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1434 -1, -1, -1)) + self.microsecond / 1e6
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1435 else:
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1436 return (self - _EPOCH).total_seconds()
6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1437
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1438 def utctimetuple(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1439 "Return UTC time tuple compatible with time.gmtime()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1440 offset = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1441 if offset:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1442 self -= offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1443 y, m, d = self.year, self.month, self.day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1444 hh, mm, ss = self.hour, self.minute, self.second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1445 return _build_struct_time(y, m, d, hh, mm, ss, 0)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1446
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1447 def date(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1448 "Return the date part."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1449 return date(self._year, self._month, self._day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1450
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1451 def time(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1452 "Return the time part, with tzinfo None."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1453 return time(self.hour, self.minute, self.second, self.microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1454
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1455 def timetz(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1456 "Return the time part, with same tzinfo."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1457 return time(self.hour, self.minute, self.second, self.microsecond,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1458 self._tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1459
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1460 def replace(self, year=None, month=None, day=None, hour=None,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1461 minute=None, second=None, microsecond=None, tzinfo=True):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1462 """Return a new datetime with new values for the specified fields."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1463 if year is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1464 year = self.year
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1465 if month is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1466 month = self.month
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1467 if day is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1468 day = self.day
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1469 if hour is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1470 hour = self.hour
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1471 if minute is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1472 minute = self.minute
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1473 if second is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1474 second = self.second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1475 if microsecond is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1476 microsecond = self.microsecond
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1477 if tzinfo is True:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1478 tzinfo = self.tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1479 _check_date_fields(year, month, day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1480 _check_time_fields(hour, minute, second, microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1481 _check_tzinfo_arg(tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1482 return datetime(year, month, day, hour, minute, second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1483 microsecond, tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1484
77569 88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1485 def astimezone(self, tz=None):
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1486 if tz is None:
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1487 if self.tzinfo is None:
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1488 raise ValueError("astimezone() requires an aware datetime")
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1489 ts = (self - _EPOCH) // timedelta(seconds=1)
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1490 localtm = _time.localtime(ts)
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1491 local = datetime(*localtm[:6])
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1492 try:
77570 336c53c1f547 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77569 diff changeset	1493 # Extract TZ data if available
77569 88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1494 gmtoff = localtm.tm_gmtoff
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1495 zone = localtm.tm_zone
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1496 except AttributeError:
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1497 # Compute UTC offset and compare with the value implied
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1498 # by tm_isdst. If the values match, use the zone name
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1499 # implied by tm_isdst.
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1500 delta = local - datetime(*_time.gmtime(ts)[:6])
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1501 dst = _time.daylight and localtm.tm_isdst > 0
77582 0f0e3ec22fce Issue #9527: tm_gmtoff has 'correct' sign. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77570 diff changeset	1502 gmtoff = -(_time.altzone if dst else _time.timezone)
0f0e3ec22fce Issue #9527: tm_gmtoff has 'correct' sign. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77570 diff changeset	1503 if delta == timedelta(seconds=gmtoff):
77569 88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1504 tz = timezone(delta, _time.tzname[dst])
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1505 else:
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1506 tz = timezone(delta)
88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1507 else:
77582 0f0e3ec22fce Issue #9527: tm_gmtoff has 'correct' sign. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77570 diff changeset	1508 tz = timezone(timedelta(seconds=gmtoff), zone)
77570 336c53c1f547 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77569 diff changeset	1509
77569 88a5f2730579 Issue #9527: datetime.astimezone() method will now supply a class Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77458 diff changeset	1510 elif not isinstance(tz, tzinfo):
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1511 raise TypeError("tz argument must be an instance of tzinfo")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1512
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1513 mytz = self.tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1514 if mytz is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1515 raise ValueError("astimezone() requires an aware datetime")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1516
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1517 if tz is mytz:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1518 return self
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1519
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1520 # Convert self to UTC, and attach the new time zone object.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1521 myoffset = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1522 if myoffset is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1523 raise ValueError("astimezone() requires an aware datetime")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1524 utc = (self - myoffset).replace(tzinfo=tz)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1525
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1526 # Convert from UTC to tz's local time.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1527 return tz.fromutc(utc)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1528
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1529 # Ways to produce a string.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1530
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1531 def ctime(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1532 "Return ctime() style string."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1533 weekday = self.toordinal() % 7 or 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1534 return "%s %s %2d %02d:%02d:%02d %04d" % (
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1535 _DAYNAMES[weekday],
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1536 _MONTHNAMES[self._month],
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1537 self._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1538 self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1539 self._year)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1540
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1541 def isoformat(self, sep='T'):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1542 """Return the time formatted according to ISO.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1543
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1544 This is 'YYYY-MM-DD HH:MM:SS.mmmmmm', or 'YYYY-MM-DD HH:MM:SS' if
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1545 self.microsecond == 0.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1546
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1547 If self.tzinfo is not None, the UTC offset is also attached, giving
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1548 'YYYY-MM-DD HH:MM:SS.mmmmmm+HH:MM' or 'YYYY-MM-DD HH:MM:SS+HH:MM'.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1549
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1550 Optional argument sep specifies the separator between date and
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1551 time, default 'T'.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1552 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1553 s = ("%04d-%02d-%02d%c" % (self._year, self._month, self._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1554 sep) +
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1555 _format_time(self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1556 self._microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1557 off = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1558 if off is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1559 if off.days < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1560 sign = "-"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1561 off = -off
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1562 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1563 sign = "+"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1564 hh, mm = divmod(off, timedelta(hours=1))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1565 assert not mm % timedelta(minutes=1), "whole minute"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1566 mm //= timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1567 s += "%s%02d:%02d" % (sign, hh, mm)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1568 return s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1569
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1570 def __repr__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1571 """Convert to formal string, for repr()."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1572 L = [self._year, self._month, self._day, # These are never zero
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1573 self._hour, self._minute, self._second, self._microsecond]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1574 if L[-1] == 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1575 del L[-1]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1576 if L[-1] == 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1577 del L[-1]
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1578 s = ", ".join(map(str, L))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1579 s = "%s(%s)" % ('datetime.' + self.__class__.__name__, s)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1580 if self._tzinfo is not None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1581 assert s[-1:] == ")"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1582 s = s[:-1] + ", tzinfo=%r" % self._tzinfo + ")"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1583 return s
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1584
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1585 def __str__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1586 "Convert to string, for str()."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1587 return self.isoformat(sep=' ')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1588
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1589 @classmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1590 def strptime(cls, date_string, format):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1591 'string, format -> new datetime parsed from a string (like time.strptime()).'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1592 import _strptime
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1593 return _strptime._strptime_datetime(cls, date_string, format)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1594
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1595 def utcoffset(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1596 """Return the timezone offset in minutes east of UTC (negative west of
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1597 UTC)."""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1598 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1599 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1600 offset = self._tzinfo.utcoffset(self)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1601 _check_utc_offset("utcoffset", offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1602 return offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1603
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1604 def tzname(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1605 """Return the timezone name.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1606
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1607 Note that the name is 100% informational -- there's no requirement that
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1608 it mean anything in particular. For example, "GMT", "UTC", "-500",
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1609 "-5:00", "EDT", "US/Eastern", "America/New York" are all valid replies.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1610 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1611 name = _call_tzinfo_method(self._tzinfo, "tzname", self)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1612 _check_tzname(name)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1613 return name
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1614
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1615 def dst(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1616 """Return 0 if DST is not in effect, or the DST offset (in minutes
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1617 eastward) if DST is in effect.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1618
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1619 This is purely informational; the DST offset has already been added to
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1620 the UTC offset returned by utcoffset() if applicable, so there's no
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1621 need to consult dst() unless you're interested in displaying the DST
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1622 info.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1623 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1624 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1625 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1626 offset = self._tzinfo.dst(self)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1627 _check_utc_offset("dst", offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1628 return offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1629
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1630 # Comparisons of datetime objects with other.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1631
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1632 def __eq__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1633 if isinstance(other, datetime):
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1634 return self._cmp(other, allow_mixed=True) == 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1635 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1636 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1637 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1638 return False
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1639
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1640 def __ne__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1641 if isinstance(other, datetime):
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1642 return self._cmp(other, allow_mixed=True) != 0
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1643 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1644 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1645 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1646 return True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1647
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1648 def __le__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1649 if isinstance(other, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1650 return self._cmp(other) <= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1651 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1652 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1653 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1654 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1655
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1656 def __lt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1657 if isinstance(other, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1658 return self._cmp(other) < 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1659 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1660 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1661 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1662 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1663
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1664 def __ge__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1665 if isinstance(other, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1666 return self._cmp(other) >= 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1667 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1668 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1669 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1670 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1671
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1672 def __gt__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1673 if isinstance(other, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1674 return self._cmp(other) > 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1675 elif not isinstance(other, date):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1676 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1677 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1678 _cmperror(self, other)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1679
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1680 def _cmp(self, other, allow_mixed=False):
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1681 assert isinstance(other, datetime)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1682 mytz = self._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1683 ottz = other._tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1684 myoff = otoff = None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1685
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1686 if mytz is ottz:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1687 base_compare = True
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1688 else:
77451 14028bdd80bc Removed redundant code Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77384 diff changeset	1689 myoff = self.utcoffset()
14028bdd80bc Removed redundant code Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77384 diff changeset	1690 otoff = other.utcoffset()
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1691 base_compare = myoff == otoff
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1692
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1693 if base_compare:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1694 return _cmp((self._year, self._month, self._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1695 self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1696 self._microsecond),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1697 (other._year, other._month, other._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1698 other._hour, other._minute, other._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1699 other._microsecond))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1700 if myoff is None or otoff is None:
77458 8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1701 if allow_mixed:
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1702 return 2 # arbitrary non-zero value
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1703 else:
8272699973cb Issue #15006: Allow equality comparison between naive and aware time Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 77451 diff changeset	1704 raise TypeError("cannot compare naive and aware datetimes")
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1705 # XXX What follows could be done more efficiently...
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1706 diff = self - other # this will take offsets into account
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1707 if diff.days < 0:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1708 return -1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1709 return diff and 1 or 0
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1710
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1711 def __add__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1712 "Add a datetime and a timedelta."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1713 if not isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1714 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1715 delta = timedelta(self.toordinal(),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1716 hours=self._hour,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1717 minutes=self._minute,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1718 seconds=self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1719 microseconds=self._microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1720 delta += other
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1721 hour, rem = divmod(delta.seconds, 3600)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1722 minute, second = divmod(rem, 60)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1723 if 0 < delta.days <= _MAXORDINAL:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1724 return datetime.combine(date.fromordinal(delta.days),
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1725 time(hour, minute, second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1726 delta.microseconds,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1727 tzinfo=self._tzinfo))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1728 raise OverflowError("result out of range")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1729
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1730 __radd__ = __add__
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1731
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1732 def __sub__(self, other):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1733 "Subtract two datetimes, or a datetime and a timedelta."
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1734 if not isinstance(other, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1735 if isinstance(other, timedelta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1736 return self + -other
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1737 return NotImplemented
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1738
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1739 days1 = self.toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1740 days2 = other.toordinal()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1741 secs1 = self._second + self._minute * 60 + self._hour * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1742 secs2 = other._second + other._minute * 60 + other._hour * 3600
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1743 base = timedelta(days1 - days2,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1744 secs1 - secs2,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1745 self._microsecond - other._microsecond)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1746 if self._tzinfo is other._tzinfo:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1747 return base
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1748 myoff = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1749 otoff = other.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1750 if myoff == otoff:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1751 return base
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1752 if myoff is None or otoff is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1753 raise TypeError("cannot mix naive and timezone-aware time")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1754 return base + otoff - myoff
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1755
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1756 def __hash__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1757 tzoff = self.utcoffset()
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1758 if tzoff is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1759 return hash(self._getstate()[0])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1760 days = _ymd2ord(self.year, self.month, self.day)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1761 seconds = self.hour * 3600 + self.minute * 60 + self.second
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1762 return hash(timedelta(days, seconds, self.microsecond) - tzoff)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1763
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1764 # Pickle support.
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1765
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1766 def _getstate(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1767 yhi, ylo = divmod(self._year, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1768 us2, us3 = divmod(self._microsecond, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1769 us1, us2 = divmod(us2, 256)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1770 basestate = bytes([yhi, ylo, self._month, self._day,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1771 self._hour, self._minute, self._second,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1772 us1, us2, us3])
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1773 if self._tzinfo is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1774 return (basestate,)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1775 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1776 return (basestate, self._tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1777
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1778 def __setstate(self, string, tzinfo):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1779 (yhi, ylo, self._month, self._day, self._hour,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1780 self._minute, self._second, us1, us2, us3) = string
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1781 self._year = yhi * 256 + ylo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1782 self._microsecond = (((us1 << 8) \| us2) << 8) \| us3
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1783 if tzinfo is None or isinstance(tzinfo, _tzinfo_class):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1784 self._tzinfo = tzinfo
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1785 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1786 raise TypeError("bad tzinfo state arg %r" % tzinfo)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1787
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1788 def __reduce__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1789 return (self.__class__, self._getstate())
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1790
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1791
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1792 datetime.min = datetime(1, 1, 1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1793 datetime.max = datetime(9999, 12, 31, 23, 59, 59, 999999)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1794 datetime.resolution = timedelta(microseconds=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1795
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1796
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1797 def _isoweek1monday(year):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1798 # Helper to calculate the day number of the Monday starting week 1
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1799 # XXX This could be done more efficiently
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1800 THURSDAY = 3
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1801 firstday = _ymd2ord(year, 1, 1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1802 firstweekday = (firstday + 6) % 7 # See weekday() above
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1803 week1monday = firstday - firstweekday
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1804 if firstweekday > THURSDAY:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1805 week1monday += 7
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1806 return week1monday
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1807
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1808 class timezone(tzinfo):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1809 __slots__ = '_offset', '_name'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1810
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1811 # Sentinel value to disallow None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1812 _Omitted = object()
65319 078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1813 def __new__(cls, offset, name=_Omitted):
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1814 if not isinstance(offset, timedelta):
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1815 raise TypeError("offset must be a timedelta")
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1816 if name is cls._Omitted:
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1817 if not offset:
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1818 return cls.utc
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1819 name = None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1820 elif not isinstance(name, str):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1821 raise TypeError("name must be a string")
65319 078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1822 if not cls._minoffset <= offset <= cls._maxoffset:
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1823 raise ValueError("offset must be a timedelta"
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1824 " strictly between -timedelta(hours=24) and"
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1825 " timedelta(hours=24).")
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1826 if (offset.microseconds != 0 or
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1827 offset.seconds % 60 != 0):
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1828 raise ValueError("offset must be a timedelta"
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1829 " representing a whole number of minutes")
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1830 return cls._create(offset, name)
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1831
65319 078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1832 @classmethod
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1833 def _create(cls, offset, name=None):
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1834 self = tzinfo.__new__(cls)
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1835 self._offset = offset
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1836 self._name = name
65319 078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1837 return self
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1838
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1839 def __getinitargs__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1840 """pickle support"""
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1841 if self._name is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1842 return (self._offset,)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1843 return (self._offset, self._name)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1844
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1845 def __eq__(self, other):
79119 ec77f8fb9958 Closes #15973: fix a segmentation fault when comparing timezone objects. Georg Brandl <georg@python.org> parents: 77582 diff changeset	1846 if type(other) != timezone:
ec77f8fb9958 Closes #15973: fix a segmentation fault when comparing timezone objects. Georg Brandl <georg@python.org> parents: 77582 diff changeset	1847 return False
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1848 return self._offset == other._offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1849
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1850 def __hash__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1851 return hash(self._offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1852
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1853 def __repr__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1854 """Convert to formal string, for repr().
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1855
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1856 >>> tz = timezone.utc
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1857 >>> repr(tz)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1858 'datetime.timezone.utc'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1859 >>> tz = timezone(timedelta(hours=-5), 'EST')
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1860 >>> repr(tz)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1861 "datetime.timezone(datetime.timedelta(-1, 68400), 'EST')"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1862 """
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1863 if self is self.utc:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1864 return 'datetime.timezone.utc'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1865 if self._name is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1866 return "%s(%r)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1867 self._offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1868 return "%s(%r, %r)" % ('datetime.' + self.__class__.__name__,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1869 self._offset, self._name)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1870
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1871 def __str__(self):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1872 return self.tzname(None)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1873
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1874 def utcoffset(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1875 if isinstance(dt, datetime) or dt is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1876 return self._offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1877 raise TypeError("utcoffset() argument must be a datetime instance"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1878 " or None")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1879
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1880 def tzname(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1881 if isinstance(dt, datetime) or dt is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1882 if self._name is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1883 return self._name_from_offset(self._offset)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1884 return self._name
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1885 raise TypeError("tzname() argument must be a datetime instance"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1886 " or None")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1887
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1888 def dst(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1889 if isinstance(dt, datetime) or dt is None:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1890 return None
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1891 raise TypeError("dst() argument must be a datetime instance"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1892 " or None")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1893
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1894 def fromutc(self, dt):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1895 if isinstance(dt, datetime):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1896 if dt.tzinfo is not self:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1897 raise ValueError("fromutc: dt.tzinfo "
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1898 "is not self")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1899 return dt + self._offset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1900 raise TypeError("fromutc() argument must be a datetime instance"
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1901 " or None")
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1902
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1903 _maxoffset = timedelta(hours=23, minutes=59)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1904 _minoffset = -_maxoffset
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1905
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1906 @staticmethod
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1907 def _name_from_offset(delta):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1908 if delta < timedelta(0):
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1909 sign = '-'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1910 delta = -delta
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1911 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1912 sign = '+'
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1913 hours, rest = divmod(delta, timedelta(hours=1))
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1914 minutes = rest // timedelta(minutes=1)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1915 return 'UTC{}{:02d}:{:02d}'.format(sign, hours, minutes)
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1916
65319 078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1917 timezone.utc = timezone._create(timedelta(0))
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1918 timezone.min = timezone._create(timezone._minoffset)
078e2e47e52b Issue 9183: Intern UTC timezone. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 64883 diff changeset	1919 timezone.max = timezone._create(timezone._maxoffset)
77384 6671c5039e15 Issue #2736: Added datetime.timestamp() method. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 75590 diff changeset	1920 _EPOCH = datetime(1970, 1, 1, tzinfo=timezone.utc)
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	1921
82957 313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1922 # Some time zone algebra. For a datetime x, let
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1923 # x.n = x stripped of its timezone -- its naive time.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1924 # x.o = x.utcoffset(), and assuming that doesn't raise an exception or
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1925 # return None
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1926 # x.d = x.dst(), and assuming that doesn't raise an exception or
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1927 # return None
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1928 # x.s = x's standard offset, x.o - x.d
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1929 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1930 # Now some derived rules, where k is a duration (timedelta).
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1931 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1932 # 1. x.o = x.s + x.d
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1933 # This follows from the definition of x.s.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1934 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1935 # 2. If x and y have the same tzinfo member, x.s = y.s.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1936 # This is actually a requirement, an assumption we need to make about
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1937 # sane tzinfo classes.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1938 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1939 # 3. The naive UTC time corresponding to x is x.n - x.o.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1940 # This is again a requirement for a sane tzinfo class.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1941 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1942 # 4. (x+k).s = x.s
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1943 # This follows from #2, and that datimetimetz+timedelta preserves tzinfo.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1944 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1945 # 5. (x+k).n = x.n + k
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1946 # Again follows from how arithmetic is defined.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1947 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1948 # Now we can explain tz.fromutc(x). Let's assume it's an interesting case
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1949 # (meaning that the various tzinfo methods exist, and don't blow up or return
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1950 # None when called).
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1951 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1952 # The function wants to return a datetime y with timezone tz, equivalent to x.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1953 # x is already in UTC.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1954 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1955 # By #3, we want
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1956 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1957 # y.n - y.o = x.n [1]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1958 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1959 # The algorithm starts by attaching tz to x.n, and calling that y. So
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1960 # x.n = y.n at the start. Then it wants to add a duration k to y, so that [1]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1961 # becomes true; in effect, we want to solve [2] for k:
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1962 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1963 # (y+k).n - (y+k).o = x.n [2]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1964 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1965 # By #1, this is the same as
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1966 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1967 # (y+k).n - ((y+k).s + (y+k).d) = x.n [3]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1968 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1969 # By #5, (y+k).n = y.n + k, which equals x.n + k because x.n=y.n at the start.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1970 # Substituting that into [3],
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1971 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1972 # x.n + k - (y+k).s - (y+k).d = x.n; the x.n terms cancel, leaving
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1973 # k - (y+k).s - (y+k).d = 0; rearranging,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1974 # k = (y+k).s - (y+k).d; by #4, (y+k).s == y.s, so
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1975 # k = y.s - (y+k).d
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1976 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1977 # On the RHS, (y+k).d can't be computed directly, but y.s can be, and we
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1978 # approximate k by ignoring the (y+k).d term at first. Note that k can't be
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1979 # very large, since all offset-returning methods return a duration of magnitude
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1980 # less than 24 hours. For that reason, if y is firmly in std time, (y+k).d must
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1981 # be 0, so ignoring it has no consequence then.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1982 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1983 # In any case, the new value is
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1984 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1985 # z = y + y.s [4]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1986 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1987 # It's helpful to step back at look at [4] from a higher level: it's simply
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1988 # mapping from UTC to tz's standard time.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1989 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1990 # At this point, if
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1991 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1992 # z.n - z.o = x.n [5]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1993 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1994 # we have an equivalent time, and are almost done. The insecurity here is
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1995 # at the start of daylight time. Picture US Eastern for concreteness. The wall
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1996 # time jumps from 1:59 to 3:00, and wall hours of the form 2:MM don't make good
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1997 # sense then. The docs ask that an Eastern tzinfo class consider such a time to
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1998 # be EDT (because it's "after 2"), which is a redundant spelling of 1:MM EST
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	1999 # on the day DST starts. We want to return the 1:MM EST spelling because that's
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2000 # the only spelling that makes sense on the local wall clock.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2001 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2002 # In fact, if [5] holds at this point, we do have the standard-time spelling,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2003 # but that takes a bit of proof. We first prove a stronger result. What's the
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2004 # difference between the LHS and RHS of [5]? Let
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2005 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2006 # diff = x.n - (z.n - z.o) [6]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2007 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2008 # Now
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2009 # z.n = by [4]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2010 # (y + y.s).n = by #5
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2011 # y.n + y.s = since y.n = x.n
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2012 # x.n + y.s = since z and y are have the same tzinfo member,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2013 # y.s = z.s by #2
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2014 # x.n + z.s
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2015 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2016 # Plugging that back into [6] gives
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2017 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2018 # diff =
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2019 # x.n - ((x.n + z.s) - z.o) = expanding
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2020 # x.n - x.n - z.s + z.o = cancelling
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2021 # - z.s + z.o = by #2
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2022 # z.d
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2023 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2024 # So diff = z.d.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2025 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2026 # If [5] is true now, diff = 0, so z.d = 0 too, and we have the standard-time
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2027 # spelling we wanted in the endcase described above. We're done. Contrarily,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2028 # if z.d = 0, then we have a UTC equivalent, and are also done.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2029 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2030 # If [5] is not true now, diff = z.d != 0, and z.d is the offset we need to
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2031 # add to z (in effect, z is in tz's standard time, and we need to shift the
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2032 # local clock into tz's daylight time).
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2033 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2034 # Let
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2035 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2036 # z' = z + z.d = z + diff [7]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2037 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2038 # and we can again ask whether
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2039 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2040 # z'.n - z'.o = x.n [8]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2041 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2042 # If so, we're done. If not, the tzinfo class is insane, according to the
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2043 # assumptions we've made. This also requires a bit of proof. As before, let's
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2044 # compute the difference between the LHS and RHS of [8] (and skipping some of
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2045 # the justifications for the kinds of substitutions we've done several times
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2046 # already):
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2047 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2048 # diff' = x.n - (z'.n - z'.o) = replacing z'.n via [7]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2049 # x.n - (z.n + diff - z'.o) = replacing diff via [6]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2050 # x.n - (z.n + x.n - (z.n - z.o) - z'.o) =
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2051 # x.n - z.n - x.n + z.n - z.o + z'.o = cancel x.n
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2052 # - z.n + z.n - z.o + z'.o = cancel z.n
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2053 # - z.o + z'.o = #1 twice
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2054 # -z.s - z.d + z'.s + z'.d = z and z' have same tzinfo
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2055 # z'.d - z.d
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2056 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2057 # So z' is UTC-equivalent to x iff z'.d = z.d at this point. If they are equal,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2058 # we've found the UTC-equivalent so are done. In fact, we stop with [7] and
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2059 # return z', not bothering to compute z'.d.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2060 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2061 # How could z.d and z'd differ? z' = z + z.d [7], so merely moving z' by
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2062 # a dst() offset, and starting from a time already in DST (we know z.d != 0),
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2063 # would have to change the result dst() returns: we start in DST, and moving
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2064 # a little further into it takes us out of DST.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2065 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2066 # There isn't a sane case where this can happen. The closest it gets is at
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2067 # the end of DST, where there's an hour in UTC with no spelling in a hybrid
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2068 # tzinfo class. In US Eastern, that's 5:MM UTC = 0:MM EST = 1:MM EDT. During
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2069 # that hour, on an Eastern clock 1:MM is taken as being in standard time (6:MM
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2070 # UTC) because the docs insist on that, but 0:MM is taken as being in daylight
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2071 # time (4:MM UTC). There is no local time mapping to 5:MM UTC. The local
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2072 # clock jumps from 1:59 back to 1:00 again, and repeats the 1:MM hour in
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2073 # standard time. Since that's what the local clock does, we want to map both
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2074 # UTC hours 5:MM and 6:MM to 1:MM Eastern. The result is ambiguous
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2075 # in local time, but so it goes -- it's the way the local clock works.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2076 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2077 # When x = 5:MM UTC is the input to this algorithm, x.o=0, y.o=-5 and y.d=0,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2078 # so z=0:MM. z.d=60 (minutes) then, so [5] doesn't hold and we keep going.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2079 # z' = z + z.d = 1:MM then, and z'.d=0, and z'.d - z.d = -60 != 0 so [8]
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2080 # (correctly) concludes that z' is not UTC-equivalent to x.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2081 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2082 # Because we know z.d said z was in daylight time (else [5] would have held and
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2083 # we would have stopped then), and we know z.d != z'.d (else [8] would have held
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2084 # and we have stopped then), and there are only 2 possible values dst() can
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2085 # return in Eastern, it follows that z'.d must be 0 (which it is in the example,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2086 # but the reasoning doesn't depend on the example -- it depends on there being
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2087 # two possible dst() outcomes, one zero and the other non-zero). Therefore
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2088 # z' must be in standard time, and is the spelling we want in this case.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2089 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2090 # Note again that z' is not UTC-equivalent as far as the hybrid tzinfo class is
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2091 # concerned (because it takes z' as being in standard time rather than the
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2092 # daylight time we intend here), but returning it gives the real-life "local
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2093 # clock repeats an hour" behavior when mapping the "unspellable" UTC hour into
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2094 # tz.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2095 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2096 # When the input is 6:MM, z=1:MM and z.d=0, and we stop at once, again with
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2097 # the 1:MM standard time spelling we want.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2098 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2099 # So how can this break? One of the assumptions must be violated. Two
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2100 # possibilities:
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2101 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2102 # 1) [2] effectively says that y.s is invariant across all y belong to a given
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2103 # time zone. This isn't true if, for political reasons or continental drift,
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2104 # a region decides to change its base offset from UTC.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2105 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2106 # 2) There may be versions of "double daylight" time where the tail end of
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2107 # the analysis gives up a step too early. I haven't thought about that
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2108 # enough to say.
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2109 #
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2110 # In any case, it's clear that the default fromutc() is strong enough to handle
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2111 # "almost all" time zones: so long as the standard offset is invariant, it
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2112 # doesn't matter if daylight time transition points change from year to year, or
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2113 # if daylight time is skipped in some years; it doesn't matter how large or
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2114 # small dst() may get within its bounds; and it doesn't even matter if some
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2115 # perverse time zone returns a negative dst()). So a breaking case must be
313bcff51900 Issue #17516: use comment syntax for comments, instead of multiline string Victor Stinner <victor.stinner@gmail.com> parents: 79136 diff changeset	2116 # pretty bizarre, and a tzinfo subclass can override fromutc() if it is.
63184 afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2117
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2118 try:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2119 from _datetime import *
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2120 except ImportError:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2121 pass
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2122 else:
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2123 # Clean up unused names
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2124 del (_DAYNAMES, _DAYS_BEFORE_MONTH, _DAYS_IN_MONTH,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2125 _DI100Y, _DI400Y, _DI4Y, _MAXORDINAL, _MONTHNAMES,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2126 _build_struct_time, _call_tzinfo_method, _check_date_fields,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2127 _check_time_fields, _check_tzinfo_arg, _check_tzname,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2128 _check_utc_offset, _cmp, _cmperror, _date_class, _days_before_month,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2129 _days_before_year, _days_in_month, _format_time, _is_leap,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2130 _isoweek1monday, _math, _ord2ymd, _time, _time_class, _tzinfo_class,
afdb53323065 Issue #7989: Added pure python implementation of the datetime module. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: diff changeset	2131 _wrap_strftime, _ymd2ord)
63187 4ed60c4bc8b6 Use _datetime docstring if _datetime is available. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63184 diff changeset	2132 # XXX Since import * above excludes names that start with _,
4ed60c4bc8b6 Use _datetime docstring if _datetime is available. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63184 diff changeset	2133 # docstring does not get overwritten. In the future, it may be
4ed60c4bc8b6 Use _datetime docstring if _datetime is available. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63184 diff changeset	2134 # appropriate to maintain a single module level docstring and
4ed60c4bc8b6 Use _datetime docstring if _datetime is available. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63184 diff changeset	2135 # remove the following line.
4ed60c4bc8b6 Use _datetime docstring if _datetime is available. Alexander Belopolsky <alexander.belopolsky@gmail.com> parents: 63184 diff changeset	2136 from _datetime import __doc__

Mercurial > cpython-lru_cache-weakref

annotate Lib/datetime.py @ 87690:66c1c9f32567 default tip