3
6cY. @ s d dl mZ d dlmZ d dlmZmZmZ ed ZddgZdd Z e
edrZdd dZ nG d
d d eZ dd dZ d
d Z
G dd deZG dd deZdd ZeedeZdS ) )PY3)wraps)datetime timedeltatzinfotzname_in_python2enfoldc s fdd}|S )zChange unicode output into bytestrings in Python 2
tzname() API changed in Python 3. It used to return bytes, but was changed
to unicode strings
c s$ | |}|d k r t r |j }|S )N)r encode)argskwargsname)namefunc /usr/lib/python3.6/_common.pyadjust_encoding s
z*tzname_in_python2..adjust_encodingr )r
r r )r
r r
s fold c C s | j |dS )a
Provides a unified interface for assigning the ``fold`` attribute to
datetimes both before and after the implementation of PEP-495.
:param fold:
The value for the ``fold`` attribute in the returned datetime. This
should be either 0 or 1.
:return:
Returns an object for which ``getattr(dt, 'fold', 0)`` returns
``fold`` for all versions of Python. In versions prior to
Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
subclass of :py:class:`datetime.datetime` with the ``fold``
attribute added, if ``fold`` is 1.
.. versionadded:: 2.6.0
)r )replace)dtr r r r r ! s c @ s e Zd ZdZf Zedd ZdS )_DatetimeWithFoldz
This is a class designed to provide a PEP 495-compliant interface for
Python versions before 3.6. It is used only for dates in a fold, so
the ``fold`` attribute is fixed at ``1``.
.. versionadded:: 2.6.0
c C s dS )Nr r )selfr r r r @ s z_DatetimeWithFold.foldN)__name__
__module__ __qualname____doc__ __slots__propertyr r r r r r 6 s r c C sL t | dd|kr| S | j dd }|| j| jf7 }|r@t| S t| S dS )a
Provides a unified interface for assigning the ``fold`` attribute to
datetimes both before and after the implementation of PEP-495.
:param fold:
The value for the ``fold`` attribute in the returned datetime. This
should be either 0 or 1.
:return:
Returns an object for which ``getattr(dt, 'fold', 0)`` returns
``fold`` for all versions of Python. In versions prior to
Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
subclass of :py:class:`datetime.datetime` with the ``fold``
attribute added, if ``fold`` is 1.
.. versionadded:: 2.6.0
r r N )getattrZ timetupleZ microsecondr r r )r r r
r r r r D s c s t fdd}|S )z
The CPython version of ``fromutc`` checks that the input is a ``datetime``
object and that ``self`` is attached as its ``tzinfo``.
c s. t |tstd|j| k r$td | |S )Nz&fromutc() requires a datetime argumentzdt.tzinfo is not self)
isinstancer TypeErrorr
ValueError)r r )fr r fromutcg s
z)_validate_fromutc_inputs..fromutc)r )r" r# r )r" r _validate_fromutc_inputsb s r$ c @ s< e Zd ZdZdd Zdd Zdd Zdd Zed
d Z d S )
_tzinfoz=
Base class for all ``dateutil`` ``tzinfo`` objects.
c C sV |j | d}t|dd}t|dd}|j |j k}|j dd|j ddk}|oT| S )a6
Whether or not the "wall time" of a given datetime is ambiguous in this
zone.
:param dt:
A :py:class:`datetime.datetime`, naive or time zone aware.
:return:
Returns ``True`` if ambiguous, ``False`` otherwise.
.. versionadded:: 2.6.0
)r r )r r N)r r utcoffset)r r Zwall_0Zwall_1Z same_offsetZsame_dtr r r is_ambiguousx s z_tzinfo.is_ambiguousc C s4 | j |r,|| }t||j |j k}nd}|S )a
Determine the fold status of a "wall" datetime, given a representation
of the same datetime as a (naive) UTC datetime. This is calculated based
on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all
datetimes, and that this offset is the actual number of hours separating
``dt_utc`` and ``dt_wall``.
:param dt_utc:
Representation of the datetime as UTC
:param dt_wall:
Representation of the datetime as "wall time". This parameter must
either have a `fold` attribute or have a fold-naive
:class:`datetime.tzinfo` attached, otherwise the calculation may
fail.
r )r' intr& dst)r dt_utcdt_wallZ
delta_wall_foldr r r _fold_status s
z_tzinfo._fold_statusc C s t |ddS )Nr r )r )r r r r r r, s z
_tzinfo._foldc C sh |j }|dkrtd|j }|dkr0td|| }||7 }t|ddj }|dkr`td|| S )a
Given a timezone-aware datetime in a given timezone, calculates a
timezone-aware datetime in a new timezone.
Since this is the one time that we *know* we have an unambiguous
datetime object, we take this opportunity to determine whether the
datetime is ambiguous and in a "fold" state (e.g. if it's the first
occurence, chronologically, of the ambiguous datetime).
:param dt:
A timezone-aware :class:`datetime.datetime` object.
Nz0fromutc() requires a non-None utcoffset() resultz*fromutc() requires a non-None dst() resultr )r z;fromutc(): dt.dst gave inconsistent results; cannot convert)r& r! r) r )r r ZdtoffZdtdstZdeltar r r _fromutc s z_tzinfo._fromutcc C s" | j |}| j||}t||dS )a
Given a timezone-aware datetime in a given timezone, calculates a
timezone-aware datetime in a new timezone.
Since this is the one time that we *know* we have an unambiguous
datetime object, we take this opportunity to determine whether the
datetime is ambiguous and in a "fold" state (e.g. if it's the first
occurance, chronologically, of the ambiguous datetime).
:param dt:
A timezone-aware :class:`datetime.datetime` object.
)r )r. r- r )r r r+ r, r r r r# s
z_tzinfo.fromutcN)
r r r r r' r- r, r. r$ r# r r r r r% s s %r% c @ sz e Zd ZdZdd Zdd Zdd Zedd Zd
d Z d d
Z
dd Z dd Z e
dd ZdZdd Zdd ZejZdS ) tzrangebasea
This is an abstract base class for time zones represented by an annual
transition into and out of DST. Child classes should implement the following
methods:
* ``__init__(self, *args, **kwargs)``
* ``transitions(self, year)`` - this is expected to return a tuple of
datetimes representing the DST on and off transitions in standard
time.
A fully initialized ``tzrangebase`` subclass should also provide the
following attributes:
* ``hasdst``: Boolean whether or not the zone uses DST.
* ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects
representing the respective UTC offsets.
* ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short
abbreviations in DST and STD, respectively.
* ``_hasdst``: Whether or not the zone has DST.
.. versionadded:: 2.6.0
c C s t dd S )Nz%tzrangebase is an abstract base class)NotImplementedError)r r r r __init__ s ztzrangebase.__init__c C s* | j |}|d krd S |r | jS | jS d S )N)_isdst _dst_offset _std_offset)r r isdstr r r r& s
ztzrangebase.utcoffsetc C s( | j |}|d krd S |r | jS tS d S )N)r2 _dst_base_offsetZERO)r r r5 r r r r) s
ztzrangebase.dstc C s | j |r| jS | jS d S )N)r2 Z _dst_abbrZ _std_abbr)r r r r r tzname s
ztzrangebase.tznamec
C s t |tstd|j| k r$td| j|j}|dkrF|| j| S |\}}|| j8 }|| j8 }||f}|j dd}| j
||}|r|| j }n
|| j }t | o| j
|} t|| dS )z, Given a datetime in UTC, return local time z&fromutc() requires a datetime argumentzdt.tzinfo is not selfN)r )r )r r r r r! transitionsyearr& r4 r _naive_isdstr3 r( r' r )
r r r9 dstondstoffZutc_transitionsr* r5 r+ r, r r r r# s$
ztzrangebase.fromutcc C sD | j s
dS | j|j\}}|jdd}|| ko>|| j k S S )a6
Whether or not the "wall time" of a given datetime is ambiguous in this
zone.
:param dt:
A :py:class:`datetime.datetime`, naive or time zone aware.
:return:
Returns ``True`` if ambiguous, ``False`` otherwise.
.. versionadded:: 2.6.0
FN)r )hasdstr9 r: r r6 )r r startendr r r r' > s
ztzrangebase.is_ambiguousc C sj | j s
dS |d krd S | j|j}|d kr.dS |jd d}| j||}| rb| j|rb| j| S |S d S )NF)r )r> r9 r: r r; r' r, )r r r9 r5 r r r r2 T s ztzrangebase._isdstc C sT |\}}|j d d}||k r6|| ko.|k n }n|| koH|k n }|S )N)r )r )r r r9 r< r= r5 r r r r; i s ztzrangebase._naive_isdstc C s | j | j S )N)r3 r4 )r r r r r6 u s z tzrangebase._dst_base_offsetNc C s
| |k S )Nr )r otherr r r __ne__{ s ztzrangebase.__ne__c C s d| j j S )Nz%s(...)) __class__r )r r r r __repr__~ s ztzrangebase.__repr__)r r r r r1 r& r) r r8 r# r' r2 r; r r6 __hash__rB rD object
__reduce__r r r r r/ s
! r/ c C s | j | jd d | j d S )NiQ i@B )ZsecondsZdaysZ microseconds)Ztdr r r _total_seconds s rH Z
total_secondsN)r )r )Zsixr functoolsr r r r r7 __all__r hasattrr r r$ r% r/ rH r r r r r s
v