Ë
|
Yñúh±3 ã ó d Z ddlmZmZmZmZ ddlZddlmZ ddlm Z ddl
|
Z
|
ddl Z ddgZ d Z G d de« Z e« Zej" Zy)
|
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 ó. t « fd« }|S )Nc ó t dfd« « t t j « r j d« | g|¢i |¤S # t
|
$ r+}d}t j t |« |« Y d }~<d }~ww xY w)NÚreadc ó S ©N© )Ústr_ins úLH:\Change_password\venv_build\Lib\site-packages\dateutil/parser/isoparser.pyú<lambda>z,_takes_ascii.<locals>.func.<locals>.<lambda> s ø ° ó Úasciiz5ISO-8601 strings should contain only ASCII characters)ÚgetattrÚ
|
isinstanceÚsixÚ text_typeÚencodeÚUnicodeEncodeErrorÚ
|
raise_fromÚ
|
ValueError)Úselfr ÚargsÚkwargsÚeÚmsgÚfs ` r Úfuncz_takes_ascii.<locals>.func s ù ð 9 « Ó8Ó:ô fcmmÔ ,ð 3Ø wÓ/ñ
|
vÐ/ Ò/¨Ñ/Ð/øô &ò 3ØMÜz¨#°×2Ñ2ûð 3ús ³A Á BÁ!B  Br )r$ r% s ` r Ú _takes_asciir& s ø Ü
|
1Xó 0ó ð 0ð Kr c ó¨ e Zd ZddZed « Zed « Zed « Zedd« ZdZ dZ
|
e j d « Z d
|
Zd Zd Zd Zd ZddZy)r Nc ó |<t |« dk7 st |« dk\ s|dv r t d« |j d« }|| _ y)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 Úseps r Ú__init__zisoparser.__init__+ sN ð ?ÜCA ¤ S£¨S¢ °C¸<Ñ4GÜ ð "3ó 4ð 4ð **WÓ%Cà r c óD | j |« \ }}t |« |kD rG| j |||dz | j k( r|| j ||dz d « z }n t d« t |« dkD r"|d dk( rd|d< t | t d¬« z 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Úposs r r
|
zisoparser.isoparse; s± ðV ×-Ñ-¨fÓ5
|
Cä v;Ò ØyyÐ F¨3¨s°Q©wÐ$7¸4¿9¹9Ò$DØd× 1Ñ 1°&¸¸q¹¸Ð2BÓ CÑC
|
ä Ð!IÓJÐJä z?QÒ :¨a¡=°BÒ#6Ø JqMÜZÐ(¬9¸!Ô+<Ñ<Ð <äÐ$Ð$r c ó® | j |« \ }}|t |« k r,t ddj |j d« « z « 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 )r6 r, r ÚformatÚdecoder )r Údatestrr9 r: s r Ú parse_isodatezisoparser.parse_isodate s^ ð ×-Ñ-¨gÓ6
|
CØ W Ò Ü Ð ;Ø /× 6Ñ 6°w·~±~ÀgÓ7NÓ Oñ Pó Qð QäZÐ Ð r c óN | j |« }|d dk( rd|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 r3 )r7 r )r Útimestrr9 s r Ú parse_isotimezisoparser.parse_isotime¥ s4 ð ×(Ñ(¨Ó1
|
Ø a=BÒ Ø JqMÜZÐ Ð r c ó( | j ||¬« 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 ÚtzstrrD s r Ú parse_tzstrzisoparser.parse_tzstrµ s ð$ × Ñ °KÐ Ó@Ð@r ó -ó :s [\.,]([0-9]+)c óf | j |« S # t $ r | j |« cY S w xY wr )Ú_parse_isodate_commonr Ú_parse_isodate_uncommon)r r8 s r r6 zisoparser._parse_isodateÎ s8 ð 8Ø×-Ñ-¨fÓ5Ð 5øÜò 8Ø×/Ñ/°Ó7Ò 7ð 8ús 0¯0c óÞ t |« }g d¢}|dk r t d« t |dd « |d< d}||k\ r||fS |||dz | j k( }|r|dz }||z
|
dk r t d« t |||dz « |d< |dz }||k\ r|r||fS t d« |r%|||dz | j k7 r t d « |dz }||z
|
dk r t d
|
« t |||dz « |d< ||dz 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 r8 Úlen_strr9 r: Úhas_seps r rK z isoparser._parse_isodate_commonÔ sA Üf+Ú
|
à Q;Ü Ð 3Ó4Ð 4ô F 1 QKÓ(
|
1 ØØ '>Ø s?Ð "àS 1WÐ%¨¯ © Ñ7Ù Ø 1HCð S=1Ò Ü Ð 3Ó4Ð 4äF 3 s¨Q¡wÐ /Ó0
|
1 Ø qà '>ÙØ! 3Ð&ä Ð!5Ó6Ð6á Øc# 'Ð" d§n¡nÒ4Ü Ð!BÓCÐCØ 1HCð S=1Ò Ü Ð 1Ó2Ð 2ÜF 3 s¨Q¡wÐ /Ó0
|
1 Ø3 7Ð"Ð"r c óö t |« dk r t d« t |dd « }|dd | j k( }d|z }|||dz dk( r}|dz }t |||dz « }|dz }d}t |« |kD r>|||dz | j k( |k7 r t d« ||z }t |||dz « }|dz }| j |||« }nt |« |z
|
d k r t d
|
« t |||d z « }|d z }|dk s|d t j |« z kD r t d
|
d j ||« z « t |dd« t |dz
|
¬ « z }|j |j |j g} | |fS )NrN rO r é r) ó WrP z"Inconsistent use of dash separatorr2 zInvalid ordinal dayim z {} for year {}r4 ) r, r rQ rR Ú_calculate_weekdateÚcalendarÚisleapr< r r ÚyearÚmonthÚday)
|
r r8 r[ rT r: ÚweeknoÚdaynoÚ base_dateÚ ordinal_dayr9 s
|
r rL z!isoparser._parse_isodate_uncommoný s· Ü v;?Ü Ð 3Ó4Ð 4ô 6!A;Ó à1+ § ¡ Ñ/à'kØ #cAgÐ $Ò &à 1HCÜ C¨!¡GÐ,Ó-FØ 1HCàEÜ6{SÒ Ø3s QwÐ'¨4¯>©>Ñ9¸gÒEÜ$Ð%IÓJÐJàwäF 3 s¨Q¡wÐ /Ó0Øqà ×0Ñ0°°v¸uÓEIô 6{SÑ 1Ò$Ü Ð!6Ó7Ð7ä f S¨¨q©Ð 1Ó2KØ 1HCàQ +°´x·±ÀtÓ7LÑ1LÒ"MÜ Ð!6Ø!2×!9Ñ!9¸+ÀtÓ!Lñ"Mó Nð Nô T 1 aÓ(¬9¸+ȹ/Ô+JÑJIà nn i§o¡o°y·}±}ÐE
|
Ø3Ð r c ó8 d|cxk rdk s n t dj |« « d|cxk rdk s n t dj |« « t |dd« }|t |j « d dz
|
¬ « z
|
}|dz
|
d
|
z |dz
|
z }|t |¬ « z 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) rN rP r4 é )r r< r r Ú isocalendar)r r[ Úweekr] Újan_4Úweek_1Ú week_offsets r rX z isoparser._calculate_weekdate) s¢ ð& 4}"}Ü Ð /× 6Ñ 6°tÓ <Ó=Ð =à3{{Ü Ð 2× 9Ñ 9¸#Ó >Ó?Ð ?ô T1aÓ Ø¨×(9Ñ(9Ó(;¸AÑ(>ÀÑ(BÔCÑCð ax 1n¨¨a©Ñ0 Ø {Ô3Ñ3Ð3r c ó t |« }g d¢}d}d}|dk r t d« d}||k r |dk r|dz }|||dz d v r| j ||d « |d< |}nî|dk( r |||dz | j k( rd
|
}|dz }n,|dk( r'|r%|||dz | j k7 r t d « |dz }|d k rt |||dz « ||< |dz }|d k( rq| j
|
j ||d « }|sÇ|j d« d d }t |« dd t |« z
|
z z ||< |t |j « « z }||k r|dk r||k r t d« |d dk( r t d |dd D « « r t d« |S )N)r r r r Nr éÿÿÿÿrP zISO time too shortFrV r) s -+ZzTz#Inconsistent use of colon separatorr2 é é
|
z Unused components in ISO stringr3 c 3 ó& K | ] }|d k7 yw)r Nr )Ú.0Ú components r ú <genexpr>z+isoparser._parse_isotime.<locals>.<genexpr>z s è ø ÒC i9 >ÑCùs rN z#Hour may only be 24 at 24:00:00.000) r, r rE Ú _TIME_SEPrQ Ú_FRACTION_REGEXÚmatchÚgroupÚany) r rA rS r9 r: ÚcomprT ÚfracÚus_strs r r7 zisoparser._parse_isotimeJ sÐ Üg,Ú'
|
ØØà Q;Ü Ð 1Ó2Ð 2ààGm q£Ø AIDàs3 7Ð# wÑ.à!%×!2Ñ!2°7¸3¸4°=Ó!A
|
2Ø ØàqyW S¨¨Q©Ð /°4·>±>Ò AØ ØqØwØ3s 1uÐ%¨¯ © Ò7Ü$Ð%JÓKÐKØqàaxä#& w¨s°3¸±7Ð';Ó#<
|
4Ñ Øqàqyà×+Ñ+×1Ñ1°'¸#¸$°-Ó@ÙØ à A r¨Ð*Ü#& v£;°°a¼#¸f»+±oÑ1FÑ#F
|
4Ñ Øs4::<Ó(Ñ(ð= Gm q¤ð@ =Ü Ð >Ó?Ð ?à a=BÒ äÑC°:¸aÀ°?ÔCÔCÜ Ð!FÓGÐGàÐr c óæ |dk( s|dk( rt j S t |« dvr t d« |dd dk( rd}n|dd d k( rd}n t d
|
« t |dd « }t |« d k( rd}n"t ||d d | j
|
k( rd nd d « }|r|dk( r|dk( rt j S |d kD r t d« |dkD r t d« t j d ||dz |z z dz « S )Nó Zó z> r2 rV rm z0Time zone offset must be 1, 3, 5 or 6 charactersr r) rH rl ó +z Time zone offset requires signr2 rN é; z#Invalid minutes in time zone offseté z!Invalid hours in time zone offseté< )r ÚUTCr, r rQ rs Útzoffset)r rF rD ÚmultÚhoursÚminutess r rE zisoparser._parse_tzstr s Ø D=E TMÜ66Mä u:YÑ &Ü Ð OÓPÐ Pà 1:Ò ØDØ 1QZ4Ò ØDä Ð =Ó>Ð >äE!AJÜ u:?ØGä% e¨A¨a j°D·N±NÒ&B¡ÈÐ KÐLÓMGá 5 A:¨'°Qª,Ü66Mà|Ü Ð!FÓGÐGàrzÜ Ð!DÓEÐEä;;t T¨U°R©Z¸'Ñ-AÑ%BÀRÑ%GÓHÐ Hr r )T)Ú__name__Ú
|
__module__Ú __qualname__r0 r& r
|
r? rB rG rR rs ÚreÚcompilert r6 rK rL rX r7 rE r r r r r * s óð ñV%ó ðV%ðp ñ!ó ð!ð ñ !ó ð !ð òAó ðAð( IØIØ bjjÐ!2Ó3Oò8ò '#òR* òX 4òB3ôj Ir )Ú__doc__r r r r rY Údateutilr Ú functoolsr r r Ú__all__r& Úobjectr ÚDEFAULT_ISOPARSERr
|
r r r ú<module>r sV ðñ÷ 5Ó 4Û Ý å ã Û
|
à {Ð
|
#òô(rIô rIñj KÐ Ø × %Ñ %r
|
