U
|
«ý°d¿3 ã @ 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Ú timedeltaÚtimeÚdateN)Útz©ÚwrapsÚisoparseÚ isoparserc s t fdd}|S )Nc
|
sz t d fdd t tjrhz d¡ W n6 tk
|
rf } zd}t t||¡ W 5 d }~X Y nX | f||S )NÚreadc s S ©N© r ©Ústr_inr úPd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\dateutil/parser/isoparser.pyÚ<lambda> ó 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©Úfr r Úfunc s "z_takes_ascii.<locals>.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 d¡Z dd Zdd Zdd Zdd Zdd Zd ddZdS ) r
|
Nc C sD |dk r:t |dks(t|dks(|dkr0td| 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 )ÚlenÚordr r Ú_sep)r Úsepr r r Ú__init__+ s
|
|
zisoparser.__init__c C s | |¡\}}t||kr^| jdks:|||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`` or ``YYYYMM``
|
- ``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: | |¡\}}|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 )r1 r( r ÚformatÚdecoder )r Zdatestrr4 r5 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. )r2 r )r Útimestrr4 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 Útzstrr; r r r Ú parse_tzstrµ s zisoparser.parse_tzstró -ó :s [\.,]([0-9]+)c C s0 z | |¡W S tk
|
r* | |¡ Y S X d S r )Ú_parse_isodate_commonr Ú_parse_isodate_uncommon)r r3 r r r r1 Î s zisoparser._parse_isodatec C s t |}dddg}|dk r"tdt|dd
|d< d}||krJ||fS |||d
| jk}|rl|d7 }|| dk rtdt|||d
|d< |d7 }||kr¼|r´||fS td|ræ|||d
| jkrÞtd|d7 }|| dk rútd t|||d
|d< ||d fS )
|
Nr% é úISO string too shortr é zInvalid common monthzInvalid ISO formatz Invalid separator in ISO stringzInvalid common day)r( r ÚintÚ _DATE_SEP)r r3 Úlen_strr4 r5 Úhas_sepr r r rA Ô 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|kr¨td||7 }t|||d
}|d7 }| |||¡}nt || d k rôtd
|
t|||d
}|d 7 }|dk s.|d t |¡ krBtd
|
d ||¡ t|ddt |d d }|j
|
|j |j g} | |fS )NrC rD r é r% ó WrE z"Inconsistent use of dash separatorr- zInvalid ordinal dayim z {} for year {}r/ ) r( r rF rG Ú_calculate_weekdateÚcalendarÚisleapr6 r r ÚyearÚmonthÚday)
|
r r3 rO rI r5 ZweeknoZdaynoZ base_dateZ ordinal_dayr4 r r r rB ý 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% rC rE r/ é )r r6 r r Ú isocalendar)r rO ÚweekrQ Zjan_4Zweek_1Z week_offsetr r r rL ) s z isoparser._calculate_weekdatec C s´ t |}ddddd g}d}d}|dk r.tdd}||k rl|dk rl|d7 }|||d
dkr| ||d
¡|d< |}ql|dkr¬|||d
| jkr¬d }|d7 }n2|dkrÞ|rÞ|||d
| jkrÖtd
|
|d7 }|d k rt|||d
||< |d7 }|d kr2| j ||d
¡}|s,q2| d¡d d
}t|d d t | ||< |t | ¡ 7 }q2||k r~td|d dkr°tdd |dd
D r°td|S )Nr éÿÿÿÿrE zISO time too shortFrJ r% 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>rC z#Hour may only be 24 at 24:00:00.000) r( r r< Ú _TIME_SEPrF Ú_FRACTION_REGEXÚmatchÚgroupÚany) r r9 rH r4 r5 ÚcomprI ÚfracZus_strr r r r2 J sH
|
|
|
zisoparser._parse_isotimec C s |dks|dkrt jS t|dkr*td|dd
dkr@d}n |dd
d krVd}ntd
|
t|dd
}t|d krd}n&t||d d
| jkrd nd d
}|rÀ|dkrÀ|dkrÀt jS |d krÐtd|dkràtdt d ||d | d ¡S d S )Nó Zó z> r- rJ rX z0Time zone offset must be 1, 3, 5 or 6 charactersr r% r? rW ó +z Time zone offset requires signr- rC é; z#Invalid minutes in time zone offseté z!Invalid hours in time zone offseté< )r ÚUTCr( r rF r] Útzoffset)r r= r; ZmultÚhoursÚminutesr r r r< s( &zisoparser._parse_tzstr)N)T)T)Ú__name__Ú
|
__module__Ú __qualname__r, r$ r r8 r: r> rG r] ÚreÚcompiler^ r1 rA rB rL r2 r< r r r r r
|
* s$
|
|
X
|
|
|
),!5)Ú__doc__r r r r rM Zdateutilr Ú functoolsr rq r Ú__all__r$ Úobjectr
|
ZDEFAULT_ISOPARSERr r r r r Ú<module> s w
|
