a
&i3 @ s| d Z ddlmZmZmZmZ ddlZddlmZ ddlm Z ddl
Z
ddl Z ddgZ dd Z
G d
d deZe 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 timedeltatimedateN)tzwrapsisoparse isoparserc s t fdd}|S )Nc
s t d fdd t tjrjz d W n8 tyh } z d}tt|| W Y d }~n
d }~0 0 | g|R i |S )Nreadc s S N r
str_inr
=/usr/lib/python3.9/site-packages/dateutil/parser/isoparser.py z,_takes_ascii..func..asciiz5ISO-8601 strings should contain only ASCII characters)getattr
isinstancesixZ text_typeencodeUnicodeEncodeErrorZ
raise_from
ValueError)selfr argskwargsemsgfr r func s &z_takes_ascii..funcr )r r! r
r r _takes_ascii s r" c @ s e Zd Zd ddZedd Zedd Zedd Zed d d Zd
Z dZ
e dZ
dd Zdd Zdd Zdd Zdd Zd ddZdS ) r
Nc C sD |dur:t |dks(t|dks(|dv r0td|d}|| _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
0123456789z7Separator must be a single, non-numeric ASCII characterr )lenordr r _sep)r sepr
r
r __init__+ s
zisoparser.__init__c C s | |\}}t||kr^| jdu s:|||d | jkrV|| ||d d 7 }ntdt|dkr|d dkrd|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 Zdays)_parse_isodater& r( _parse_isotimer r r )r dt_str
componentsposr
r
r r ; s K zisoparser.isoparsec C s: | |\}}|t|k r2tdd|d 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 formatdecoder )r Zdatestrr1 r2 r
r
r
parse_isodate s zisoparser.parse_isodatec C s& | |}|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 timestrr1 r
r
r
parse_isotime s
zisoparser.parse_isotimeTc C s | j ||dS )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 tzstrr8 r
r
r parse_tzstr s zisoparser.parse_tzstr - :s
[\.,]([0-9]+)c C s. z | |W S ty( | | Y S 0 d S r )_parse_isodate_commonr _parse_isodate_uncommon)r r0 r
r
r r. s zisoparser._parse_isodatec C s t |}g d}|dk r tdt|dd |d< d}||krH||fS |||d | jk}|rj|d7 }|| dk r~tdt|||d |d< |d7 }||kr|r||fS td|r|||d | jkrtd |d7 }|| dk rtd
t|||d |d< ||d fS ) N)r# r# r# ISO string too shortr r# zInvalid common monthzInvalid ISO formatz Invalid separator in ISO stringzInvalid common day)r& r int _DATE_SEP)r r0 len_strr1 r2 has_sepr
r
r r> s6 z isoparser._parse_isodate_commonc
C st t |dk rtdt|dd }|dd | jk}d| }|||d dkr|d7 }t|||d }|d7 }d}t ||kr|||d | jk|krtd||7 }t|||d }|d7 }| |||}nt || d k rtd
t|||d }|d 7 }|dk s.|d t| krBtd
d || t|ddt |d d
}|j
|j |j g} | |fS )Nr@ rA r r# WrB z"Inconsistent use of dash separatorr+ zInvalid ordinal dayim z {} for year {}r- )
r& r rC rD _calculate_weekdatecalendarZisleapr3 r r yearZmonthday)
r r0 rK rF r2 ZweeknoZdaynoZ base_dateZ ordinal_dayr1 r
r
r r? s8
z!isoparser._parse_isodate_uncommonc C s d| k rdk s$n t d|d| k r8dk sHn t d|t|dd}|t| 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@ rB r- )r r3 r r Z isocalendar)r rK ZweekrL Zjan_4Zweek_1Z week_offsetr
r
r rI ) s z isoparser._calculate_weekdatec C s t |}g d}d}d}|dk r(tdd}||k rf|dk rf|d7 }|||d d v rz| ||d |d< |}qf|dkr|||d | jkrd
}|d7 }n2|dkr|r|||d | jkrtd |d7 }|d k rt|||d ||< |d7 }|d kr,| j||d }|s&q,|dd d
}t|dd
t | ||< |t | 7 }q,||k rxtd|d dkrtdd |dd D rtd|S )N)r r r r Nr rB zISO time too shortFrG r# s -+ZzTz#Inconsistent use of colon separatorr+
z Unused components in ISO stringr, c s s | ]}|d kV qdS )r Nr
).0Z componentr
r
r z r z+isoparser._parse_isotime..r@ z#Hour may only be 24 at 24:00:00.000) r& r r9 _TIME_SEPrC _FRACTION_REGEXmatchgroupany) r r6 rE r1 r2 comprF ZfracZus_strr
r
r r/ J sH
zisoparser._parse_isotimec C s |dks|dkrt jS t|dvr*td|dd dkr@d}n |dd d krVd}ntd
t|dd }t|d krd}n&t||d d | jkrd nd d }|r|dkr|dkrt jS |d
krtd|dkrtdt d ||d | d S d S )N Z z> r+ rG rQ z0Time zone offset must be 1, 3, 5 or 6 charactersr r# r< rP +z Time zone offset requires signr+ r@ ; z#Invalid minutes in time zone offset z!Invalid hours in time zone offset< )r ZUTCr& r rC rU Ztzoffset)r r: r8 ZmultZhoursZminutesr
r
r r9 s( &zisoparser._parse_tzstr)N)T)T)__name__
__module__ __qualname__r* r" r r5 r7 r; rD rU recompilerV r. r> r? rI r/ r9 r
r
r
r r
* s$
X
),!5)__doc__r r r r rJ Zdateutilr functoolsr rd r __all__r" objectr
ZDEFAULT_ISOPARSERr r
r
r
r s w