win32timezone.TimeZoneInfo Object

Main class for handling Windows time zones. Usage: TimeZoneInfo(<Time Zone Standard Name>, [<Fix Standard Time>])

Comments

If <Fix Standard Time> evaluates to True, daylight savings time is calculated in the same way as standard time.

>>> tzi = TimeZoneInfo('Pacific Standard Time')

>>> march31 = datetime.datetime(2000,3,31)

We know that time zone definitions haven't changed from 2007 to 2012, so regardless of whether dynamic info is available, there should be consistent results for these years.

>>> subsequent_years = [march31.replace(year=year)

...     for year in range(2007, 2013)]

>>> offsets = set(tzi.utcoffset(year) for year in subsequent_years)

>>> len(offsets)

1

Cannot create a `TimeZoneInfo` with an invalid name.

>>> TimeZoneInfo('Does not exist')

Traceback (most recent call last):

...

ValueError: Timezone Name 'Does not exist' not found

>>> TimeZoneInfo(None)

Traceback (most recent call last):

...

ValueError: subkey name cannot be empty

>>> TimeZoneInfo("")

Traceback (most recent call last):

...

ValueError: subkey name cannot be empty

Methods

tzname: >>> MST = TimeZoneInfo('Mountain Standard Time')
getWinInfo: Return the most relevant "info" for this time zone
utcoffset: Calculates the utcoffset according to the datetime.tzinfo spec
dst: Calculate the daylight savings offset according to the
GetDSTStartTime: Given a year, determines the time when daylight savings time starts
GetDSTEndTime: Given a year, determines the time when daylight savings ends.
local: Returns the local time zone as defined by the operating system in the
utc: Returns a time-zone representing UTC.
get_sorted_time_zone_names: Return a list of time zone names that can
get_sorted_time_zones: Return the time zones sorted by some key.