Current File : //proc/227033/root/opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyc
�
K�Pc @ s6 d Z d d l m Z m Z m Z d d l m Z y e Wn! e k
r] d d l m Z n Xd d l
Z
d d l m Z m
Z
g Z i Z d � Z e j d � Z i e d 6Z d � Z i Z d
� Z e d � Z d � Z d e f d
� � YZ d e f d � � YZ d e f d � � YZ e e e d � Z d S( sB Base classes and helpers for building zone specific tzinfo classesi����( t datetimet timedeltat tzinfo( t bisect_right( t SetN( t AmbiguousTimeErrort NonExistentTimeErrorc C s> y t | SWn+ t k
r9 t d | � } | t | <| SXd S( s3 Create only one instance of each distinct timedeltat secondsN( t _timedelta_cachet KeyErrorR ( R t delta( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt memorized_timedelta s
i c C sB y t | SWn/ t k
r= t t d | � } | t | <| SXd S( s2 Create only one instance of each distinct datetimeR N( t _datetime_cacheR t _epochR ( R t dt( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt memorized_datetime s
c G sV y t | SWnC t k
rQ t | d � t | d � | d f } | t | <| SXd S( s/ Create only one instance of each distinct tuplei i i N( t
_ttinfo_cacheR R ( t argst ttinfo( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt memorized_ttinfo' s
c C s | j | j d d d S( s Convert a timedelta to secondsi i< ( R t days( t td( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt _to_seconds6 s t
BaseTzInfoc B s# e Z d Z d Z d Z d � Z RS( c C s | j S( N( t zone( t self( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt __str__A s N( t __name__t
__module__t Nonet
_utcoffsett _tznameR R ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR ; s t StaticTzInfoc B se e Z d Z d � Z d d � Z d d � Z d d � Z e d � Z e d � Z
d � Z d � Z RS(
s� A timezone that has a constant offset from UTC
These timezones are rare, as most locations have changed their
offset at some point in their history
c C sD | j d k r- | j | k r- t d � � n | | j j d | � S( s See datetime.tzinfo.fromutcs fromutc: dt.tzinfo is not selfR N( R R t
ValueErrorR t replace( R R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt fromutcK s c C s | j S( s� See datetime.tzinfo.utcoffset
is_dst is ignored for StaticTzInfo, and exists only to
retain compatibility with DstTzInfo.
( R ( R R t is_dst( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt utcoffsetQ s c C s t S( s� See datetime.tzinfo.dst
is_dst is ignored for StaticTzInfo, and exists only to
retain compatibility with DstTzInfo.
( t _notime( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt dstY s c C s | j S( s� See datetime.tzinfo.tzname
is_dst is ignored for StaticTzInfo, and exists only to
retain compatibility with DstTzInfo.
( R ( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt tznamea s c C s. | j d k r t d � � n | j d | � S( s Convert naive time to local times* Not naive datetime (tzinfo is already set)R N( R R R! R" ( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt localizei s c C s> | j | k r | S| j d k r1 t d � � n | j | � S( s Correct the timezone information on the given datetime.
This is normally a no-op, as StaticTzInfo timezones never have
ambiguous cases to correct:
>>> from pytz import timezone
>>> gmt = timezone('GMT')
>>> isinstance(gmt, StaticTzInfo)
True
>>> dt = datetime(2011, 5, 8, 1, 2, 3, tzinfo=gmt)
>>> gmt.normalize(dt) is dt
True
The supported method of converting between timezones is to use
datetime.astimezone(). Currently normalize() also works:
>>> la = timezone('America/Los_Angeles')
>>> dt = la.localize(datetime(2011, 5, 7, 1, 2, 3))
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
>>> gmt.normalize(dt).strftime(fmt)
'2011-05-07 08:02:03 GMT (+0000)'
s Naive time - no tzinfo setN( R R R! t
astimezone( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt normalizeo s
c C s d | j f S( Ns <StaticTzInfo %r>( R ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt __repr__� s c C s t j | j f f S( N( t pytzt _pR ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt
__reduce__� s N(
R R t __doc__R# R R% R' R( t FalseR) R+ R, R/ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR E s t DstTzInfoc B s� e Z d Z d
Z d
Z d
Z d
Z d
Z d
d
d � Z d � Z
d � Z e d � Z
d
d � Z d
d � Z d
d � Z d � Z d � Z RS( s� A timezone that has a variable offset from UTC
The offset might change if daylight savings time comes into effect,
or at a point in history when the region decides to change their
timezone definition.
c C s� | r* | | _ | \ | _ | _ | _ n| i } | | _ | j d \ | _ | _ | _ | | | j d <x: | j d D]+ } | | k rw | j | | � | | <qw qw Wd S( Ni i ( t _tzinfosR t _dstR t _transition_infot __class__( R t _infR3 t inf( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt __init__� s c C s� | j d k r< t | j d d � | j k r< t d � � n | j d d � } t d t | j | � d � } | j | } | | d j d | j | � S( s See datetime.tzinfo.fromutcR3 s fromutc: dt.tzinfo is not selfR i i N(
R R t getattrR3 R! R" t maxR t _utc_transition_timesR5 ( R R t idxR8 ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR# � s
c C sS | j d k r t d � � n | j j } | j d d � } | | } | j | � S( sI Correct the timezone information on the given datetime
If date arithmetic crosses DST boundaries, the tzinfo
is not magically adjusted. This method normalizes the
tzinfo to the correct one.
To test, first we need to do some setup
>>> from pytz import timezone
>>> utc = timezone('UTC')
>>> eastern = timezone('US/Eastern')
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
We next create a datetime right on an end-of-DST transition point,
the instant when the wallclocks are wound back one hour.
>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
>>> loc_dt = utc_dt.astimezone(eastern)
>>> loc_dt.strftime(fmt)
'2002-10-27 01:00:00 EST (-0500)'
Now, if we subtract a few minutes from it, note that the timezone
information has not changed.
>>> before = loc_dt - timedelta(minutes=10)
>>> before.strftime(fmt)
'2002-10-27 00:50:00 EST (-0500)'
But we can fix that by calling the normalize method
>>> before = eastern.normalize(before)
>>> before.strftime(fmt)
'2002-10-27 01:50:00 EDT (-0400)'
The supported method of converting between timezones is to use
datetime.astimezone(). Currently, normalize() also works:
>>> th = timezone('Asia/Bangkok')
>>> am = timezone('Europe/Amsterdam')
>>> dt = th.localize(datetime(2011, 5, 7, 1, 2, 3))
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
>>> am.normalize(dt).strftime(fmt)
'2011-05-06 20:02:03 CEST (+0200)'
s Naive time - no tzinfo setR N( R R R! R R" R# ( R R t offset( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR+ � s -
c C s^ | j d
k r t d � � n t � } x� t d d � t d d � g D]� } | | } t d t | j | � d � } | j | } | j | } | j
| j d | � � } | j d d
� | k rF | j | � qF qF Wt
| � d k r� | j � St
| � d k r�| d
k r t | � � q�| rR| j | t d d � d t �t d d � S| j | t d d � d t �t d d � Sn | d
k r�t | � � n g | D]$ } t | j j � | k r�| ^ q�}
t
|
� d k r�|
d St
|
� d k r t | � }
n i } x4 |
D], } | j d d
� | j j }
| | |
<qWt | � d } | | S( s� Convert naive time to local time.
This method should be used to construct localtimes, rather
than passing a tzinfo argument to a datetime constructor.
is_dst is used to determine the correct timezone in the ambigous
period at the end of daylight savings time.
>>> from pytz import timezone
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
>>> amdam = timezone('Europe/Amsterdam')
>>> dt = datetime(2004, 10, 31, 2, 0, 0)
>>> loc_dt1 = amdam.localize(dt, is_dst=True)
>>> loc_dt2 = amdam.localize(dt, is_dst=False)
>>> loc_dt1.strftime(fmt)
'2004-10-31 02:00:00 CEST (+0200)'
>>> loc_dt2.strftime(fmt)
'2004-10-31 02:00:00 CET (+0100)'
>>> str(loc_dt2 - loc_dt1)
'1:00:00'
Use is_dst=None to raise an AmbiguousTimeError for ambiguous
times at the end of daylight savings
>>> try:
... loc_dt1 = amdam.localize(dt, is_dst=None)
... except AmbiguousTimeError:
... print('Ambiguous')
Ambiguous
is_dst defaults to False
>>> amdam.localize(dt) == amdam.localize(dt, False)
True
is_dst is also used to determine the correct timezone in the
wallclock times jumped over at the start of daylight savings time.
>>> pacific = timezone('US/Pacific')
>>> dt = datetime(2008, 3, 9, 2, 0, 0)
>>> ploc_dt1 = pacific.localize(dt, is_dst=True)
>>> ploc_dt2 = pacific.localize(dt, is_dst=False)
>>> ploc_dt1.strftime(fmt)
'2008-03-09 02:00:00 PDT (-0700)'
>>> ploc_dt2.strftime(fmt)
'2008-03-09 02:00:00 PST (-0800)'
>>> str(ploc_dt2 - ploc_dt1)
'1:00:00'
Use is_dst=None to raise a NonExistentTimeError for these skipped
times.
>>> try:
... loc_dt1 = pacific.localize(dt, is_dst=None)
... except NonExistentTimeError:
... print('Non-existent')
Non-existent
s* Not naive datetime (tzinfo is already set)R i����i i R t hoursi R$ N( R R R! t setR R; R R< R5 R3 R+ R" t addt lent popR R) t TrueR1 R t boolR4 t listR t sorted( R R R$ t possible_loc_dtR
t loc_dtR= R8 R t pt filtered_possible_loc_dtt sorting_keyst local_dtt keyt first_key( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR) � sH ; %
'*
$
c C sF | d k r d S| j | k r; | j | | � } | j j S| j Sd S( sX See datetime.tzinfo.utcoffset
The is_dst parameter may be used to remove ambiguity during DST
transitions.
>>> from pytz import timezone
>>> tz = timezone('America/St_Johns')
>>> ambiguous = datetime(2009, 10, 31, 23, 30)
>>> tz.utcoffset(ambiguous, is_dst=False)
datetime.timedelta(-1, 73800)
>>> tz.utcoffset(ambiguous, is_dst=True)
datetime.timedelta(-1, 77400)
>>> try:
... tz.utcoffset(ambiguous)
... except AmbiguousTimeError:
... print('Ambiguous')
Ambiguous
N( R R R) R ( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR% | s
c C sF | d k r d S| j | k r; | j | | � } | j j S| j Sd S( s9 See datetime.tzinfo.dst
The is_dst parameter may be used to remove ambiguity during DST
transitions.
>>> from pytz import timezone
>>> tz = timezone('America/St_Johns')
>>> normal = datetime(2009, 9, 1)
>>> tz.dst(normal)
datetime.timedelta(0, 3600)
>>> tz.dst(normal, is_dst=False)
datetime.timedelta(0, 3600)
>>> tz.dst(normal, is_dst=True)
datetime.timedelta(0, 3600)
>>> ambiguous = datetime(2009, 10, 31, 23, 30)
>>> tz.dst(ambiguous, is_dst=False)
datetime.timedelta(0)
>>> tz.dst(ambiguous, is_dst=True)
datetime.timedelta(0, 3600)
>>> try:
... tz.dst(ambiguous)
... except AmbiguousTimeError:
... print('Ambiguous')
Ambiguous
N( R R R) R4 ( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR' � s
c C sI | d k r | j S| j | k r> | j | | � } | j j S| j Sd S( s� See datetime.tzinfo.tzname
The is_dst parameter may be used to remove ambiguity during DST
transitions.
>>> from pytz import timezone
>>> tz = timezone('America/St_Johns')
>>> normal = datetime(2009, 9, 1)
>>> tz.tzname(normal)
'NDT'
>>> tz.tzname(normal, is_dst=False)
'NDT'
>>> tz.tzname(normal, is_dst=True)
'NDT'
>>> ambiguous = datetime(2009, 10, 31, 23, 30)
>>> tz.tzname(ambiguous, is_dst=False)
'NST'
>>> tz.tzname(ambiguous, is_dst=True)
'NDT'
>>> try:
... tz.tzname(ambiguous)
... except AmbiguousTimeError:
... print('Ambiguous')
Ambiguous
N( R R R R) R ( R R R$ ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR( � s
c C se | j r d } n d } | j t k rD d | j | j | j | f Sd | j | j | j | f Sd S( Nt DSTt STDs <DstTzInfo %r %s+%s %s>s <DstTzInfo %r %s%s %s>( R4 R R& R R ( R R' ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR, � s c C s1 t j | j t | j � t | j � | j f f S( N( R- R. R R R R4 R ( R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR/ � s
N( R R R0 R R< R5 R R3 R4 R9 R# R+ R1 R) R% R' R( R, R/ ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyR2 � s
7 � ' & c C s� t j | � } | d k r | St | � } t | � } y | j | | | f SWn t k
rb n Xx9 | j j � D]( } | j | k rs | j | k rs | Sqs W| | | f } | j | | j � | j | <| j | S( s% Factory function for unpickling pytz tzinfo instances.
This is shared for both StaticTzInfo and DstTzInfo instances, because
database changes could cause a zones implementation to switch between
these two base classes and we can't break pickles on a pytz version
upgrade.
N(
R- t timezoneR R R3 R t valuesR R4 R6 ( R R% t dstoffsetR( t tzt localized_tzR8 ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt unpickler s
( R0 R R R t bisectR R@ t NameErrort setsR R- t pytz.exceptionsR R t __all__R R t utcfromtimestampR
R R R R R& R R R R2 R RW ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/pytz/tzinfo.pyt <module> s.
P� n
Mini Shell