reference.py 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127
  1. '''
  2. Reference tzinfo implementations from the Python docs.
  3. Used for testing against as they are only correct for the years
  4. 1987 to 2006. Do not use these for real code.
  5. '''
  6. from datetime import tzinfo, timedelta, datetime
  7. from pytz import utc, UTC, HOUR, ZERO
  8. # A class building tzinfo objects for fixed-offset time zones.
  9. # Note that FixedOffset(0, "UTC") is a different way to build a
  10. # UTC tzinfo object.
  11. class FixedOffset(tzinfo):
  12. """Fixed offset in minutes east from UTC."""
  13. def __init__(self, offset, name):
  14. self.__offset = timedelta(minutes = offset)
  15. self.__name = name
  16. def utcoffset(self, dt):
  17. return self.__offset
  18. def tzname(self, dt):
  19. return self.__name
  20. def dst(self, dt):
  21. return ZERO
  22. # A class capturing the platform's idea of local time.
  23. import time as _time
  24. STDOFFSET = timedelta(seconds = -_time.timezone)
  25. if _time.daylight:
  26. DSTOFFSET = timedelta(seconds = -_time.altzone)
  27. else:
  28. DSTOFFSET = STDOFFSET
  29. DSTDIFF = DSTOFFSET - STDOFFSET
  30. class LocalTimezone(tzinfo):
  31. def utcoffset(self, dt):
  32. if self._isdst(dt):
  33. return DSTOFFSET
  34. else:
  35. return STDOFFSET
  36. def dst(self, dt):
  37. if self._isdst(dt):
  38. return DSTDIFF
  39. else:
  40. return ZERO
  41. def tzname(self, dt):
  42. return _time.tzname[self._isdst(dt)]
  43. def _isdst(self, dt):
  44. tt = (dt.year, dt.month, dt.day,
  45. dt.hour, dt.minute, dt.second,
  46. dt.weekday(), 0, -1)
  47. stamp = _time.mktime(tt)
  48. tt = _time.localtime(stamp)
  49. return tt.tm_isdst > 0
  50. Local = LocalTimezone()
  51. # A complete implementation of current DST rules for major US time zones.
  52. def first_sunday_on_or_after(dt):
  53. days_to_go = 6 - dt.weekday()
  54. if days_to_go:
  55. dt += timedelta(days_to_go)
  56. return dt
  57. # In the US, DST starts at 2am (standard time) on the first Sunday in April.
  58. DSTSTART = datetime(1, 4, 1, 2)
  59. # and ends at 2am (DST time; 1am standard time) on the last Sunday of Oct.
  60. # which is the first Sunday on or after Oct 25.
  61. DSTEND = datetime(1, 10, 25, 1)
  62. class USTimeZone(tzinfo):
  63. def __init__(self, hours, reprname, stdname, dstname):
  64. self.stdoffset = timedelta(hours=hours)
  65. self.reprname = reprname
  66. self.stdname = stdname
  67. self.dstname = dstname
  68. def __repr__(self):
  69. return self.reprname
  70. def tzname(self, dt):
  71. if self.dst(dt):
  72. return self.dstname
  73. else:
  74. return self.stdname
  75. def utcoffset(self, dt):
  76. return self.stdoffset + self.dst(dt)
  77. def dst(self, dt):
  78. if dt is None or dt.tzinfo is None:
  79. # An exception may be sensible here, in one or both cases.
  80. # It depends on how you want to treat them. The default
  81. # fromutc() implementation (called by the default astimezone()
  82. # implementation) passes a datetime with dt.tzinfo is self.
  83. return ZERO
  84. assert dt.tzinfo is self
  85. # Find first Sunday in April & the last in October.
  86. start = first_sunday_on_or_after(DSTSTART.replace(year=dt.year))
  87. end = first_sunday_on_or_after(DSTEND.replace(year=dt.year))
  88. # Can't compare naive to aware objects, so strip the timezone from
  89. # dt first.
  90. if start <= dt.replace(tzinfo=None) < end:
  91. return HOUR
  92. else:
  93. return ZERO
  94. Eastern = USTimeZone(-5, "Eastern", "EST", "EDT")
  95. Central = USTimeZone(-6, "Central", "CST", "CDT")
  96. Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")
  97. Pacific = USTimeZone(-8, "Pacific", "PST", "PDT")