3
���h�3 � @ s| d Z ddlmZmZmZmZ ddlZddlmZ ddlm Z ddl
Z
ddl Z ddgZ dd � Z
G d
d� de�Ze� ZejZdS ) z�
This module offers a parser for ISO-8601 strings
It is intended to support all valid date, time and datetime formats per the
ISO-8601 specification.
..versionadded:: 2.7.0
� )�datetime� timedelta�time�dateN)�tz)�wraps�isoparse� isoparserc s t � �� fdd��}|S )Nc sz t � d� fdd��� � t� tj�rhy� jd�� W n6 tk
rf } zd}tjt|�|� W Y d d }~X nX �| � f|�|�S )N�readc s � S )N� r )�str_inr �D/tmp/pip-build-5_djhm0z/python-dateutil/dateutil/parser/isoparser.py�<lambda> s z,_takes_ascii.<locals>.func.<locals>.<lambda>�asciiz5ISO-8601 strings should contain only ASCII characters)�getattr�
isinstance�six� text_type�encode�UnicodeEncodeError�
raise_from�
ValueError)�selfr �args�kwargs�e�msg)�f)r r
�func s "z_takes_ascii.<locals>.func)r )r r r )r r
� _takes_ascii s r c @ s� e Zd Zd dd�Zedd� �Zedd� �Zedd � �Zed d d ��Zd
Z dZ
e j d�Z
dd� Zdd� Zdd� Zdd� Zdd� Zd dd�ZdS ) r Nc C sD |dk r:t |�dks(t|�dks(|dkr0td��|jd�}|| _dS ) z�
:param sep:
A single character that separates date and time portions. If
``None``, the parser will accept any single character.
For strict ISO-8601 adherence, pass ``'T'``.
N� � �
0123456789z(Separator must be a single, non-numeric zASCII characterr z7Separator must be a single, non-numeric ASCII character)�len�ordr r �_sep)r �sepr r r
�__init__+ s
zisoparser.__init__c C s� | j |�\}}t|�|kr^| jdks:|||d � | jkrV|| j||d d� �7 }ntd��t|�dkr�|d dkr�d|d< t|� tdd� S t|� S )u
Parse an ISO-8601 datetime string into a :class:`datetime.datetime`.
An ISO-8601 datetime string consists of a date portion, followed
optionally by a time portion - the date and time portions are separated
by a single character separator, which is ``T`` in the official
standard. Incomplete date formats (such as ``YYYY-MM``) may *not* be
combined with a time portion.
Supported date formats are:
Common:
- ``YYYY``
- ``YYYY-MM``
- ``YYYY-MM-DD`` or ``YYYYMMDD``
Uncommon:
- ``YYYY-Www`` or ``YYYYWww`` - ISO week (day defaults to 0)
- ``YYYY-Www-D`` or ``YYYYWwwD`` - ISO week and day
The ISO week and day numbering follows the same logic as
:func:`datetime.date.isocalendar`.
Supported time formats are:
- ``hh``
- ``hh:mm`` or ``hhmm``
- ``hh:mm:ss`` or ``hhmmss``
- ``hh:mm:ss.ssssss`` (Up to 6 sub-second digits)
Midnight is a special case for `hh`, as the standard supports both
00:00 and 24:00 as a representation. The decimal separator can be
either a dot or a comma.
.. caution::
Support for fractional components other than seconds is part of the
ISO-8601 standard, but is not currently implemented in this parser.
Supported time zone offset formats are:
- `Z` (UTC)
- `±HH:MM`
- `±HHMM`
- `±HH`
Offsets will be represented as :class:`dateutil.tz.tzoffset` objects,
with the exception of UTC, which will be represented as
:class:`dateutil.tz.tzutc`. Time zone offsets equivalent to UTC (such
as `+00:00`) will also be represented as :class:`dateutil.tz.tzutc`.
:param dt_str:
A string or stream containing only an ISO-8601 datetime string
:return:
Returns a :class:`datetime.datetime` representing the string.
Unspecified components default to their lowest value.
.. warning::
As of version 2.7.0, the strictness of the parser should not be
considered a stable part of the contract. Any valid ISO-8601 string
that parses correctly with the default settings will continue to
parse correctly in future versions, but invalid strings that
currently fail (e.g. ``2017-01-01T00:00+00:00:00``) are not
guaranteed to continue failing in future versions if they encode
a valid date.
.. versionadded:: 2.7.0
Nr z&String contains unknown ISO components� � r )�days)�_parse_isodater# r% �_parse_isotimer r r )r �dt_str�
components�posr r r
r ; s K zisoparser.isoparsec C s: | j |�\}}|t|�k r2tddj|jd�� ��t|� S )z�
Parse the date portion of an ISO string.
:param datestr:
The string portion of an ISO string, without a separator
:return:
Returns a :class:`datetime.date` object
z String contains unknown ISO zcomponents: {!r}r )r+ r# r �format�decoder )r Zdatestrr. r/ r r r
�
parse_isodate� s
zisoparser.parse_isodatec C s& | j |�}|d dkr d|d< t|� S )z�
Parse the time portion of an ISO string.
:param timestr:
The time portion of an ISO string, without a separator
:return:
Returns a :class:`datetime.time` object
r r) )r, r )r �timestrr. r r r
�
parse_isotime� s
zisoparser.parse_isotimeTc C s | j ||d�S )a
Parse a valid ISO time zone string.
See :func:`isoparser.isoparse` for details on supported formats.
:param tzstr:
A string representing an ISO time zone offset
:param zero_as_utc:
Whether to return :class:`dateutil.tz.tzutc` for zero-offset zones
:return:
Returns :class:`dateutil.tz.tzoffset` for offsets and
:class:`dateutil.tz.tzutc` for ``Z`` and (if ``zero_as_utc`` is
specified) offsets equivalent to UTC.
)� zero_as_utc)� _parse_tzstr)r �tzstrr5 r r r
� parse_tzstr� s zisoparser.parse_tzstr� -� :s
[\.,]([0-9]+)c C s* y
| j |�S tk
r$ | j|�S X d S )N)�_parse_isodate_commonr �_parse_isodate_uncommon)r r- r r r
r+ � s
zisoparser._parse_isodatec C s t |�}dddg}|dk r"td��t|dd� �|d< d}||krJ||fS |||d � | jk}|rl|d7 }|| dk r�td��t|||d � �|d< |d7 }||kr�|r�||fS td��|r�|||d � | jkr�td��|d7 }|| dk r�td ��t|||d � �|d< ||d fS )
Nr � zISO string too shortr � zInvalid common monthzInvalid ISO formatz Invalid separator in ISO stringzInvalid common day)r# r �int� _DATE_SEP)r r- �len_strr. r/ �has_sepr r r
r; � s6
z isoparser._parse_isodate_commonc
C st t |�dk rtd��t|dd� �}|dd� | jk}d| }|||d � dkr�|d7 }t|||d � �}|d7 }d}t |�|kr�|||d � | jk|kr�td��||7 }t|||d � �}|d7 }| j|||�}n�t |�| d k r�td
��t|||d � �}|d 7 }|dk �s.|d tj|� k�rBtd
d j||� ��t|dd�t |d d
� }|j
|j |j g} | |fS )Nr= zISO string too shortr � r � Wr> z"Inconsistent use of dash separatorr( zInvalid ordinal dayim z {} for year {})r* )
r# r r? r@ �_calculate_weekdate�calendar�isleapr0 r r �year�month�day)
r r- rH rB r/ ZweeknoZdaynoZ base_dateZ ordinal_dayr. r r r
r< � s6 z!isoparser._parse_isodate_uncommonc C s� d| k odk n s&t dj|���d| k o8dk n sLt dj|���t|dd�}|t|j� d d d � }|d d
|d }|t|d � S ) a�
Calculate the day of corresponding to the ISO year-week-day calendar.
This function is effectively the inverse of
:func:`datetime.date.isocalendar`.
:param year:
The year in the ISO calendar
:param week:
The week in the ISO calendar - range is [1, 53]
:param day:
The day in the ISO calendar - range is [1 (MON), 7 (SUN)]
:return:
Returns a :class:`datetime.date`
r �6 zInvalid week: {}� zInvalid weekday: {}r r= r> )r* � )r r0 r r � isocalendar)r rH �weekrJ Zjan_4Zweek_1Z week_offsetr r r
rE ) s z isoparser._calculate_weekdatec C s� t |�}ddddd g}d}d}|dk r.td��d}�x8||k oD|dk �rl|d7 }|||d � dkr�| j||d � �|d< |}P |dkr�|||d � | jkr�d}|d7 }n2|dkr�|r�|||d � | jkr�td ��|d7 }|d
k �rt|||d � �||< |d7 }|d
kr6| jj||d � �}|�s,q6|jd�d d � }t|�d d t |� ||< |t |j� �7 }q6W ||k �r�td
��|d dk�r�tdd� |dd� D ���r�td��|S )Nr r r> zISO time too shortFrC s -+ZzTz#Inconsistent use of colon separatorr( � �
z Unused components in ISO stringr) c s s | ]}|d kV qdS )r Nr )�.0� componentr r r
� <genexpr>z s z+isoparser._parse_isotime.<locals>.<genexpr>r= z#Hour may only be 24 at 24:00:00.000���rU ) r# r r6 � _TIME_SEPr? �_FRACTION_REGEX�match�group�any) r r3 rA r. r/ �comprB �fracZus_strr r r
r, J sH
zisoparser._parse_isotimec C s |dks|dkrt jS t|�dkr*td��|dd� d kr@d}n |dd� d
krVd}ntd ��t|dd� �}t|�dkr�d}n&t||dd � | jkr�d ndd � �}|r�|dkr�|dkr�t jS |d
kr�td��|dkr�td��t jd ||d | d �S d S )N� Z� zr( rC rP z0Time zone offset must be 1, 3, 5 or 6 charactersr r r9 � +z Time zone offset requires signr= �; z#Invalid minutes in time zone offset� z!Invalid hours in time zone offset�< > r( rC rP rU )r �UTCr# r r? rV �tzoffset)r r7 r5 Zmult�hours�minutesr r r
r6 s( &zisoparser._parse_tzstr)N)T)T)�__name__�
__module__� __qualname__r' r r r2 r4 r8 r@ rV �re�compilerW r+ r; r< rE r, r6 r r r r
r * s
Y
),!5)�__doc__r r r r rF Zdateutilr � functoolsr rj r �__all__r �objectr ZDEFAULT_ISOPARSERr r r r r
�<module> s w |