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.