U
|
«ý°d±2 ã @ 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 deZdS )é )ÚPY2©Úwraps)ÚdatetimeÚ timedeltaÚtzinfoÚtzname_in_python2Úenfoldc s$ t r t fdd}|S S dS )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| ¡ }|S ©N)Úencode)ÚargsÚkwargsÚname©Únamefunc© úJd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\dateutil/tz/_common.pyÚadjust_encoding s
|
z*tzname_in_python2.<locals>.adjust_encodingN)r r )r r r r r r s
|
Úfoldé c C s | j |dS )á®
|
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 ZdZdZdd 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
|
r c O sv d}t ||D ]&\}}||kr,td |¡|||< q|D ]}||kr:t| |||< q:| dd¡rh| jnt}|f |S )aì
|
Return a datetime with the same attributes, except for those
|
attributes given new values by whichever keyword arguments are
|
specified. Note that tzinfo=None can be specified to create a naive
|
datetime from an aware datetime with no conversion of date and time
|
data.
|
|
This is reimplemented in ``_DatetimeWithFold`` because pypy3 will
|
return a ``datetime.datetime`` even if ``fold`` is unchanged.
|
)ÚyearÚmonthÚdayÚhourÚminuteÚsecondÚ microsecondr zDuplicate argument: {}r r )ÚzipÚ TypeErrorÚformatÚgetattrÚgetÚ __class__r )Úselfr r ÚargnamesÚargÚargnameZdt_classr r r r D s
|
z_DatetimeWithFold.replacec C s dS )Nr r ©r) r r r r b s z_DatetimeWithFold.foldN)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Ú __slots__r Úpropertyr r r r r r : s
|
r c C sL t | dd|kr| S | ¡ dd
}|| j| jf7 }|r@t| S t| S dS )r r r Né )r& Ú timetupler" r r r )r r r r r r r f 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 )Nú&fromutc() requires a datetime argumentúdt.tzinfo is not self)Ú
|
isinstancer r$ r Ú
|
ValueError©r) r ©Úfr r Úfromutc s
|
|
|
z)_validate_fromutc_inputs.<locals>.fromutcr )r< r= r r; r Ú_validate_fromutc_inputs 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}| ¡ | ¡ k}|j dd|j ddk}|oT| S )á6
|
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_ambiguous s z_tzinfo.is_ambiguousc C s4 | |¡r,|| }t|| ¡ | ¡ 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 )rC ÚintrB Údst)r) Údt_utcÚdt_wallZ
|
delta_wallÚ_foldr r r Ú _fold_status³ s
|
|
z_tzinfo._fold_statusc C s t |ddS )Nr r )r& r: r r r rH Ì s z _tzinfo._foldc C sh | ¡ }|dkrtd| ¡ }|dkr0td|| }||7 }t|dd ¡ }|dkr`td|| S )áü
|
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
|
occurrence, 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)rB r9 rE r )r) r ZdtoffZdtdstÚdeltar r r Ú_fromutcÏ s z_tzinfo._fromutcc C s" | |¡}| ||¡}t||dS )rJ r )rL rI r )r) r rG rH r r r r= ô s
|
z_tzinfo.fromutcN)
|
r. r/ r0 r1 rC rI rH rL r> r= r r r r r? 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)ÚNotImplementedErrorr- r r r Ú__init__! s ztzrangebase.__init__c C s* | |¡}|d krd S |r | jS | jS d S r
|
)Ú_isdstÚ _dst_offsetÚ _std_offset©r) r Úisdstr r r rB $ s
|
ztzrangebase.utcoffsetc C s( | |¡}|d krd S |r | jS tS d S r
|
)rP Ú_dst_base_offsetÚZEROrS r r r rE . s
|
ztzrangebase.dstc C s | |¡r| jS | jS d S r
|
)rP Z _dst_abbrZ _std_abbrr: r r r Útzname8 s
|
ztzrangebase.tznamec
|
C s¼ t |tstd|j| k r$td| |j¡}|dkrF|| |¡ S |\}}|| j8 }|| j8 }||f}|j dd}|
|
||¡}|r|| j }n
|
|| j }t | o¬| |¡} t|| dS )z, Given a datetime in UTC, return local time r6 r7 NrA r )r8 r r$ r r9 Ú transitionsr rB rR r Ú _naive_isdstrQ rD rC r )
|
r) r rX ÚdstonÚdstoffZutc_transitionsrF rT rG rH r r r r= ? s$
|
|
|
|
|
ztzrangebase.fromutcc C sD | j s
|
dS | |j¡\}}|jdd}|| ko>|| j k S S )r@ FNrA )ÚhasdstrX r r rU )r) r ÚstartÚendr r r rC ` s
|
ztzrangebase.is_ambiguousc C sh | j s
|
dS |d krd S | |j¡}|d kr.dS |jd d}| ||¡}|s`| |¡r`| |¡ S |S d S )NFrA )r\ rX r r rY rC rH )r) r rX rT r r r rP v s ztzrangebase._isdstc C sT |\}}|j d d}||k r6|| ko.|k n }n|| koH|k n }|S )NrA r )r) r rX rZ r[ rT r r r rY s ztzrangebase._naive_isdstc C s | j | j S r
|
)rQ rR r- r r r rU s z tzrangebase._dst_base_offsetNc C s
|
| |k S r
|
r )r) Úotherr r r Ú__ne__ s ztzrangebase.__ne__c C s d| j j S )Nz%s(...))r( r. r- r r r Ú__repr__ s ztzrangebase.__repr__)r. r/ r0 r1 rO rB rE r rW r= rC rP rY r3 rU Ú__hash__r` ra ÚobjectÚ
|
__reduce__r r r r rM s
|
|
|
!
|
rM N)r )r )Úsixr Ú functoolsr r r r rV Ú__all__r Úhasattrr r r> r? rM r r r r Ú<module> s
|
,
|
v
|
