|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/dateutil/parser/__pycache__/ |
Upload File : |
o
Ö�]*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
s� t � d� fdd��� � t� tj�r5z� �d�� W n ty4 } zd}t�t|�|� W Y d }~nd }~ww �| � g|�R i |��S )N�readc s � S �N� r
��str_inr
�;/usr/lib/python3/dist-packages/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��fr r �func s ��z_takes_ascii.<locals>.funcr )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 � d�Z
dd� Zdd� Zdd� Zdd� Zdd� Zd dd�ZdS ) r
Nc C sD |dur t |�dkst|�dks|dv rtd��|�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/| jdu s |||d � | jkr+|| �||d d� �7 }ntd��t|�dkrH|d dkrHd|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 s4 | � |�\}}|t|�k rtdd�|� ��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: {})r0 r' r �formatr )r �datestrr3 r4 r
r
r �
parse_isodate� s �zisoparser.parse_isodatec C s& | � |�}|d dkrd|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- )r1 r )r �timestrr3 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 �tzstrr: r
r
r � parse_tzstr� s zisoparser.parse_tzstr� -� :s
[\.,]([0-9]+)c C s* z| � |�W S ty | �|� Y S w r )�_parse_isodate_commonr �_parse_isodate_uncommon)r r2 r
r
r r0 � s
�zisoparser._parse_isodatec C s t |�}g d�}|dk rtd��t|dd� �|d< d}||kr$||fS |||d � | jk}|r5|d7 }|| dk r?td��t|||d � �|d< |d7 }||kr]|rY||fS td��|rr|||d � | jkrntd ��|d7 }|| dk r|td
��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 r2 �len_strr3 r4 �has_sepr
r
r r@ � s6 z isoparser._parse_isodate_commonc
C sp t |�dk r
td��t|dd� �}|dd� | jk}d| }|||d � dkrn|d7 }t|||d � �}|d7 }d}t |�|krf|||d � | jk|krTtd��||7 }t|||d � �}|d7 }| �|||�}n>t |�| d k rztd
��t|||d � �}|d 7 }|dk s�|d t�|� kr�td
d �||� ��t|dd�t |d d
� }|j
|j |j g} | |fS )NrB rC r � r$ � WrD z"Inconsistent use of dash separatorr, zInvalid ordinal dayim z {} for year {}r. )
r' r rE rF �_calculate_weekdate�calendar�isleapr5 r r �year�month�day)
r r2 rN rH r4 �weekno�dayno� base_date� ordinal_dayr3 r
r
r rA � s8
�z!isoparser._parse_isodate_uncommonc C s� d| k r
dk sn t d�|���d| k r dk s$n 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$ rB rD r. � )r r5 r r � isocalendar)r rN �weekrP �jan_4�week_1� week_offsetr
r
r rK ) s z isoparser._calculate_weekdatec C s� t |�}g d�}d}d}t |�dk rtd��|dko"|dd� | jk}||k r�|dk r�|d7 }|||d � d v rG| �||d � �|d< |}na|dk rpt|||d � �||< |d7 }|rp||k rp|||d � | jkrp|d7 }|dkr�| j�||d � �}|s�q#|�d�d d
� }t|�d d
t |� ||< |t |�� �7 }||k r�|dk s+||k r�td ��|d d
kr�tdd� |dd� D ��r�td��|S )N)r r r r Nr ���rD zISO time too shortr, rI r$ s -+Zz� �
z Unused components in ISO stringr- c s s � | ]}|d kV qdS )r Nr
)�.0� componentr
r
r � <genexpr>u s � z+isoparser._parse_isotime.<locals>.<genexpr>rB z#Hour may only be 24 at 24:00:00.000) r' r � _TIME_SEPr; rE �_FRACTION_REGEX�match�group�any) r r8 rG r3 r4 �comprH �frac�us_strr
r
r r1 J sB � zisoparser._parse_isotimec C s� |dks|dkr t jS t|�dvrtd��|dd� dkr d}n|dd� d kr+d}ntd
��t|dd � �}t|�d kr@d}nt||d d � | jkrMd nd d � �}|r`|dkr`|dkr`t jS |d
krhtd��|dkrptd��t �d ||d | d �S )N� Z� z> r, rI r^ z0Time zone offset must be 1, 3, 5 or 6 charactersr r$ r> r] � +z Time zone offset requires signr, rB �; z#Invalid minutes in time zone offset� z!Invalid hours in time zone offset�< )r �UTCr' r rE rc �tzoffset)r r< r: �mult�hours�minutesr
r
r r; z s( & zisoparser._parse_tzstrr )T)�__name__�
__module__� __qualname__r+ r# r r7 r9 r= rF rc �re�compilerd r0 r@ rA rK r1 r; r
r
r
r r
* s&
X
),!0)�__doc__r r r r rL �dateutilr � functoolsr ry r �__all__r# �objectr
�DEFAULT_ISOPARSERr r
r
r
r �<module> s r