:z d Z ddlmZmZmZmZ ddlZddlmZ ddlm Z ddl
Z
ddl Z ddgZ d Z
G d de Z e Zej ZdS )
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 < t fd }|S )Nc 0 t dfd t t j rR d n;# t
$ r.}d}t j t | | Y d }~nd }~ww xY w | g|R i |S )Nreadc S N )str_ins y/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/dateutil/parser/isoparser.pyz,_takes_ascii..func.. s asciiz5ISO-8601 strings should contain only ASCII characters)getattr
isinstancesix text_typeencodeUnicodeEncodeError
raise_from
ValueError)selfr argskwargsemsgfs ` r funcz_takes_ascii..func s 9 88:: fcm , , 3
3 w//%
3
3
3Mz#22222222
3 qv///////s A
B$BBr )r$ r% s ` r _takes_asciir& s3
1XX
0
0
0
0 X
0 Kr c e Zd ZddZed Zed Zed Zedd ZdZ d Z
e j d
Z
d Zd Zd
Zd Zd ZddZdS )r Nc |Nt | dk st | dk s|dv rt d | 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 seps r __init__zisoparser.__init__+ se ?CA
SS C<4G4G "3 4 4 4 **W%%C r c | | \ }}t | |k rP| j |||dz | j k r$|| ||dz d z
}nt d t | dk r+|d dk r d|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`` 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
componentsposs r r
zisoparser.isoparse; s V --f55
C v;; y F3sQw;$749$D$Dd 1 1&q2B C CC
!IJJJ z??Q :a=B#6#6 JqMZ(9!+<+<+<< <$$r c | | \ }}|t | k r8t dd | 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 formatdecoder )r datestrr9 r: s r
parse_isodatezisoparser.parse_isodate sr --g66
C W ; / 6 6w~~g7N7N O O P Q Q
QZ r c ` | | }|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 s: ((11
a=B JqMZ r Tc 0 | || 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 x | | S # t $ r | | cY S w xY wr )_parse_isodate_commonr _parse_isodate_uncommon)r r8 s r r6 zisoparser._parse_isodate sP 8--f55 5 8 8 8//77 7 7 7 8s 99c R t | }g d}|dk rt d t |dd |d< d}||k r||fS |||dz | j k }|r|dz
}||z
dk rt d t |||dz |d< |dz
}||k r|r||fS t d |r*|||dz | j k rt d |dz
}||z
dk rt 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 s f++ YY
Q;; 344 4 F1Q3K((
1
'>> s? "S1W% 7 1HC S=1 344 4F3sQw; /00
1
q '>>
7!3& !5666 c#'k"dn44 !BCCC 1HC S=1 122 2F3sQw; /00
1
37""r c t | dk rt d t |dd }|dd | j k }d|z }|||dz dk r|dz
}t |||dz }|dz
}d}t | |k rM|||dz | j k |k rt d ||z
}t |||dz }|dz
}| ||| }nt | |z
d k rt d
t |||d z }|d z
}|dk s|d t j | z k r&t d
d || 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_weekdatecalendarisleapr< r r yearmonthday)
r r8 r[ rT r: weeknodayno base_date ordinal_dayr9 s
r rL z!isoparser._parse_isodate_uncommon s v;;?? 344 4 6!A#; 1+ /'k #cAg+ $ & & 1HCC!G ,--F 1HCE6{{S 3sQw;'4>9gEE$%IJJJwF3sQw; /00q 00vuEEII 6{{S 1$$ !6777 fSq[ 122K 1HCQ+xt7L7L1L"M"M !6!2!9!9+t!L!L"M N N N T1a((9+/+J+J+JJI nioy}E
3 r c d|cxk rdk s$n t d | d|cxk rdk s$n t d | t |dd }|t | 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_4week_1 week_offsets r rX z isoparser._calculate_weekdate) s & 4}}}}"}}}} / 6 6t < <== =3{{{{{{{{ 2 9 9# > >?? ? T1a (9(9(;(;A(>(BCCCC ax1na0 {33333r c t | }g d}d}d}|dk rt d d}||k r^|dk rW|dz
}|||dz d v r$| ||d |d< |}n |dk r |||dz | j k rd
}|dz
}n2|dk r,|r*|||dz | j k rt d |dz
}|d k r"t |||dz ||< |dz
}|d k r| j ||d }|s| d d d
}t | dd
t | z
z z ||< |t | z
}||k r|dk W||k rt d |d dk r0t d |dd D rt 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 k V dS )r Nr ).0 components r z+isoparser._parse_isotime..z s& CCi9>CCCCCCr rN z#Hour may only be 24 at 24:00:00.000) r, r rE _TIME_SEPrQ _FRACTION_REGEXmatchgroupany) r rA rS r9 r: comprT fracus_strs r r7 zisoparser._parse_isotimeJ s< g,,'''
Q;; 122 2Gmmq AIDs37{#w..!%!2!27344=!A!A
2 qyyWSQY /4> A A qw3s1u9% 77$%JKKKqaxx#&ws37{';#<#<
4 qqyy+11'#$$-@@ A rr*#&v;;a#f++o1F#F
4 s4::<<(((= Gmmq@ == >?? ? a=B CC:ac?CCCCC
H !FGGGr c P |dk s|dk r t j S t | dvrt d |dd dk rd}n |dd d k rd}nt d
t |dd }t | d k rd}n,t ||d d | j k rd nd d }|r|dk r|dk r t j S |d
k rt d |dk rt 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 multhoursminutess r rE zisoparser._parse_tzstr sK D==ETMM6M u::Y & & OPP P 1: DD
1Q3Z4
DD =>> >E!A#J u::??GG%eAaCjDN&B&B K KLMMG I5A::'Q,,6M|| !FGGGrzz !DEEE;tTURZ'-A%BR%GHH Hr r )T)__name__
__module__ __qualname__r0 r& r
r? rB rG rR rs recompilert r6 rK rL rX r7 rE r r r r r * s( V% V% \V%p ! ! \!
!
! \
! A A A \A( II bj!233O8 8 8 '# '# '#R* * * X 4 4 4B3 3 3j I I I I I Ir )__doc__r r r r rY dateutilr functoolsr r r __all__r& objectr DEFAULT_ISOPARSERr
r r r r s 5 4 4 4 4 4 4 4 4 4 4 4
{
# (rI rI rI rI rI rI rI rIj IKK %r