관리-도구
편집 파일: _common.cpython-36.pyc
3 6�cY�. � @ s� d dl mZ d dlmZ d dlmZmZmZ ed �ZddgZdd� Z e ed�rZdd d�Z nG d d � d e�Z dd d�Z d d� Z G dd� de�ZG dd� de�Zdd� Zeede�ZdS )� )�PY3)�wraps)�datetime� timedelta�tzinfo�tzname_in_python2�enfoldc s � fdd�}|S )z�Change 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)�args�kwargs�name)�namefunc� � /usr/lib/python3.6/_common.py�adjust_encoding s z*tzname_in_python2.<locals>.adjust_encodingr )r r r )r r r s �fold� c C s | j |d�S )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 |t�std��|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.<locals>.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 dd�k}|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_utc�dt_wallZ delta_wall�_foldr r r � _fold_status� s z_tzinfo._fold_statusc C s t |dd�S )Nr r )r )r r r r r r, � s z _tzinfo._foldc C sh |j � }|dkrtd��|j� }|dkr0td��|| }||7 }t|dd�j� }|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||d�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 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 d��d 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_offset�ZERO)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 |t�std��|j| k r$td��| j|j�}|dkrF|| j|� S |\}}|| j8 }|| j8 }||f}|j dd�}| j ||�}|r�|| j }n || j }t | o�| j |��} t|| d�S )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! � transitions�yearr& r4 r � _naive_isdstr3 r( r' r ) r r r9 �dston�dstoffZutc_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 �start�endr 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 )Ni�Q 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 �<module> s v