[doc] moved makefile. corrected paths to images.
# -*- coding: latin-1 -*-
""" Timezone information.
XXX This module still has prototype status and is undocumented.
XXX Double check the offsets given in the zonetable below.
XXX Add TZ environment variable parsing functions. The REs are already
there.
Copyright (c) 1998-2000, Marc-Andre Lemburg; mailto:mal@lemburg.com
Copyright (c) 2000-2007, eGenix.com Software GmbH; mailto:info@egenix.com
See the documentation for further information on copyrights,
or contact the author. All Rights Reserved.
"""
import DateTime
import re,string
### REs
# time zone parsing
isozone = ('(?P<zone>[+-]\d\d:?(?:\d\d)?|Z)')
zone = ('(?P<zone>[A-Z]+|[+-]\d\d?:?(?:\d\d)?)')
zoneoffset = ('(?:'
'(?P<zonesign>[+-])?'
'(?P<hours>\d\d?)'
':?'
'(?P<minutes>\d\d)?'
'(?P<extra>\d+)?'
')'
)
# TZ environment variable parsing
dstswitchtime = ('(?P<hour>\d\d?):?'
'(?P<minute>\d\d)?:?'
'(?P<second>\d\d)?')
dstswitch = ('(?:'
'(?P<doy>\d+)|'
'(?:J(?P<jdoy>\d+))|'
'(?:M(?P<month>\d+).(?P<week>\d+).(?P<day>\d+))'
')'
'(?:/' + dstswitchtime + ')?'
)
# XXX Doesn't work since re doesn't like multiple occurrences of
# group names.
#tz = ('(?::(?P<filename>.+))|'
# '(?P<std>[A-Z]+)' + zoneoffset +
# '(?:'
# '(?P<dst>[A-Z]+)' + zoneoffset + '?'+
# '(?:[;,]' + dstswitch + '[;,]' + dstswitch + ')'
# ')?'
# )
# Compiled RE objects
isozoneRE = re.compile(zone)
zoneRE = re.compile(zone)
zoneoffsetRE = re.compile(zoneoffset)
#tzRE= re.compile(tz)
### Time zone offset table
#
# The offset given here represent the difference between UTC and the
# given time zone.
#
# Additions and corrections are always welcome :-)
#
# Note that some zone names are ambiguous, e.g. IST can refer to Irish
# Summer Time, Indian Standard Time, Israel Standard Time. We've
# usualy chosen meaning with the most wide-spread use.
#
zonetable = {
# Timezone abbreviations
# Std Summer
# Standards
'UT':0,
'UTC':0,
'GMT':0,
# A few common timezone abbreviations
'CET':1, 'CEST':2, 'CETDST':2, # Central European
'MET':1, 'MEST':2, 'METDST':2, # Mean European
'MEZ':1, 'MESZ':2, # Mitteleurop�ische Zeit
'EET':2, 'EEST':3, 'EETDST':3, # Eastern Europe
'WET':0, 'WEST':1, 'WETDST':1, # Western Europe
'MSK':3, 'MSD':4, # Moscow
'IST':5.5, # India
'JST':9, # Japan
'KST':9, # Korea
'HKT':8, # Hong Kong
# US time zones
'AST':-4, 'ADT':-3, # Atlantic
'EST':-5, 'EDT':-4, # Eastern
'CST':-6, 'CDT':-5, # Central
'MST':-7, 'MDT':-6, # Midwestern
'PST':-8, 'PDT':-7, # Pacific
# Australian time zones
'CAST':9.5, 'CADT':10.5, # Central
'EAST':10, 'EADT':11, # Eastern
'WAST':8, 'WADT':9, # Western
'SAST':9.5, 'SADT':10.5, # Southern
# US military time zones
'Z': 0,
'A': 1,
'B': 2,
'C': 3,
'D': 4,
'E': 5,
'F': 6,
'G': 7,
'H': 8,
'I': 9,
'K': 10,
'L': 11,
'M': 12,
'N':-1,
'O':-2,
'P':-3,
'Q':-4,
'R':-5,
'S':-6,
'T':-7,
'U':-8,
'V':-9,
'W':-10,
'X':-11,
'Y':-12
}
def utc_offset(zone,
atoi=string.atoi,zoneoffset=zoneoffsetRE,
zonetable=zonetable,zerooffset=DateTime.DateTimeDelta(0),
oneMinute=DateTime.oneMinute,upper=string.upper):
""" utc_offset(zonestring)
Return the UTC time zone offset as DateTimeDelta instance.
zone must be string and can either be given as +-HH:MM,
+-HHMM, +-HH numeric offset or as time zone
abbreviation. Daylight saving time must be encoded into the
zone offset.
Timezone abbreviations are treated case-insensitive.
"""
if not zone:
return zerooffset
uzone = upper(zone)
if zonetable.has_key(uzone):
return zonetable[uzone]*DateTime.oneHour
offset = zoneoffset.match(zone)
if not offset:
raise ValueError,'wrong format or unknown time zone: "%s"' % zone
zonesign,hours,minutes,extra = offset.groups()
if extra:
raise ValueError,'illegal time zone offset: "%s"' % zone
offset = int(hours or 0) * 60 + int(minutes or 0)
if zonesign == '-':
offset = -offset
return offset*oneMinute