U
|
«ý°d¬å ã @ sD d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl
|
m Z ddl Z ddl m Z mZ ddlmZ ddlmZ d d
|
lmZ d d lmZ d d dgZG dd deZG dd deZG dd d eZG dd deZG dd deZ e Z d dd Z G dd deZ e Z dd Z!G d d de"Z#G d d d e$Z%dS )!a
|
This module offers a generic date/time string parser which is able to parse
|
most known formats to represent a date and/or time.
|
|
This module attempts to be forgiving with regards to unlikely input formats,
|
returning a datetime object even for dates which are ambiguous. If an element
|
of a date/time stamp is omitted, the following rules are applied:
|
|
- If AM or PM is left unspecified, a 24-hour clock is assumed, however, an hour
|
on a 12-hour clock (``0 <= hour <= 12``) *must* be specified if AM or PM is
|
specified.
|
- If a time zone is omitted, a timezone-naive datetime is returned.
|
|
If any other elements are missing, they are taken from the
|
:class:`datetime.datetime` object passed to the parameter ``default``. If this
|
results in a day number exceeding the valid number of days per month, the
|
value falls back to the end of the month.
|
|
Additional resources about date/time string formats can be found below:
|
|
- `A summary of the international standard date and time notation
|
<https://www.cl.cam.ac.uk/~mgk25/iso-time.html>`_
|
- `W3C Date and Time Formats <https://www.w3.org/TR/NOTE-datetime>`_
|
- `Time Formats (Planetary Rings Node) <https://pds-rings.seti.org:443/tools/time_formats.html>`_
|
- `CPAN ParseDate module
|
<https://metacpan.org/pod/release/MUIR/Time-modules-2013.0912/lib/Time/ParseDate.pm>`_
|
- `Java SimpleDateFormat Class
|
<https://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>`_
|
é )Úunicode_literalsN)Ú
|
monthrange)ÚStringIO)Ú integer_typesÚ text_type)ÚDecimal)Úwarné )Ú relativedelta)ÚtzÚparseÚ
|
parserinfoÚ ParserErrorc @ sn e Zd Ze d¡Zdd Zdd Zdd Zdd Z d
|
d Z
|
e d d Z e dd Z e dd Ze dd ZdS )Ú_timelexz([.,])c C sj t |ttfr| ¡ }t |tr*t|}n$t|dd d krNtdj|j j
|
d|| _ g | _ g | _ d| _d S )NÚreadz8Parser must be a string or character stream, not {itype})ÚitypeF)Ú
|
isinstanceÚbytesÚ bytearrayÚdecoder r ÚgetattrÚ TypeErrorÚformatÚ __class__Ú__name__ÚinstreamÚ charstackÚ
|
tokenstackÚeof)Úselfr © r úNd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\dateutil/parser/_parser.pyÚ__init__> s
|
|
ÿz_timelex.__init__c C s´ | j r| j d¡S d}d}d}| js"| jr:| j d¡}n"| j d¡}|dkr\| j d¡}qF|sld| _q"q |s®|}| |¡rd}n(| |¡rd}n| |¡r¨d }q"nq"q |dkröd}| |¡rÎ||7 }n&|d
|
krä||7 }d }n| j |¡ q"q |dkrX| |¡r||7 }n@|d
|
ks8|d krFt
|
|d krF||7 }d}n| j |¡ q"q |d krÀd}|d
|
ks|| |¡r||7 }n8| |¡r®|d d
|
kr®||7 }d}n| j |¡ q"q |dkr |d
|
ksÞ| |¡rè||7 }q | |¡r|d d
|
kr||7 }d }q | j |¡ q"q |dkr|sP| d
|
¡dksP|d dkr| j |¡}|d }|dd
D ]}|rp| j |¡ qp|dkr°| d
|
¡dkr°| d d
|
¡}|S )aù
|
This function breaks the time string into lexical units (tokens), which
|
can be parsed by the parser. Lexical units are demarcated by changes in
|
the character set, so any continuous string of letters is considered
|
one unit, any continuous string of numbers is considered one unit.
|
|
The main complication arises from the fact that dots ('.') can be used
|
both as separators (e.g. "Sep.20.2009") or decimal points (e.g.
|
"4:30:21.447"). As such, it is necessary to read the full context of
|
any dot-separated strings before breaking it into tokens; as such, this
|
function maintains a "token stack", for when the ambiguous context
|
demands that multiple tokens be parsed at once.
|
r FNé ú TÚaÚ0ú Ú.úa.ú,r ú0.éÿÿÿÿ)r) r+ z.,)r Úpopr r r r ÚiswordÚisnumÚisspaceÚappendÚlenÚcountÚ_split_decimalÚsplitÚreplace)r Z seenlettersÚtokenÚstateÚnextcharÚlÚtokr r r! Ú get_tokenM s
|
|
|
|
|
|
|
"
|
|
|
|
ÿ z_timelex.get_tokenc C s | S ©Nr ©r r r r! Ú__iter__º s z_timelex.__iter__c C s | ¡ }|d krt|S r= )r< Ú StopIteration)r r7 r r r! Ú__next__½ s z_timelex.__next__c C s | ¡ S r= )rA r> r r r! ÚnextÄ s z _timelex.nextc C s t | |S r= )Úlist)ÚclsÚsr r r! r5 Ç s z_timelex.splitc C s | ¡ S )z5 Whether or not the next character is part of a word )Úisalpha©rD r9 r r r! r. Ë s z_timelex.iswordc C s | ¡ S )z0 Whether the next character is part of a number )ÚisdigitrG r r r! r/ Ð s z_timelex.isnumc C s | ¡ S )z* Whether the next character is whitespace )r0 rG r r r! r0 Õ s z_timelex.isspaceN)r Ú
|
__module__Ú __qualname__ÚreÚcompiler4 r" r< r? rA rB Ú classmethodr5 r. r/ r0 r r r r! r : s
|
m
|
|
|
r c @ s, e Zd Zdd Zdd Zdd Zdd Zd S )
|
Ú _resultbasec C s | j D ]}t| |d qd S r= )Ú __slots__Úsetattr)r Úattrr r r! r" Ý s
|
z_resultbase.__init__c C sJ g }| j D ],}t| |}|d k r
|
| d|t|f ¡ q
|
d|d |¡f S )Nz%s=%sú%s(%s)ú, )rO r r1 ÚreprÚjoin)r Ú classnamer: rQ Úvaluer r r! Ú_reprá s
|
|
z_resultbase._reprc s t fdd jD S )Nc 3 s | ]}t |d k V qd S r= )r )Ú.0rQ r> r r! Ú <genexpr>ê s ÿz&_resultbase.__len__.<locals>.<genexpr>)ÚsumrO r> r r> r! Ú__len__é s ÿz_resultbase.__len__c C s | | jj¡S r= )rX r r r> r r r! Ú__repr__í s z_resultbase.__repr__N)r rI rJ r" rX r\ r] r r r r! rN Û s rN c @ sò e Zd ZdZdddddddd d
|
d d d ddddddgZdddddddgZdd d d d d d!d"d#d$d%d&g Zd'd(d)gZd*d+gZd,d-d.d/gZ dgZ
|
i Z dJd1d2Z d3d4 Z d5d6 Zd7d8 Zd9d: Zd;d< Zd=d> Zd?d@ ZdAdB ZdCdD ZdKdEdFZdGdH ZdIS )Lr a¾
|
Class which handles what inputs are accepted. Subclass this to customize
|
the language and acceptable values for each parameter.
|
|
:param dayfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the day (``True``) or month (``False``). If
|
``yearfirst`` is set to ``True``, this distinguishes between YDM
|
and YMD. Default is ``False``.
|
|
:param yearfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the year. If ``True``, the first number is taken
|
to be the year, otherwise the last number is taken to be the year.
|
Default is ``False``.
|
r' r( r* ú;ú-ú/ú'ÚatÚonÚandÚadÚmÚtZofÚstZndÚrdÚth)ÚMonZMonday)ÚTueZTuesday)ÚWedZ Wednesday)ÚThuZThursday)ÚFriZFriday)ÚSatZSaturday)ÚSunZSunday)ÚJanÚJanuary)ÚFebÚFebruary)ÚMarZMarch)ÚAprZApril)ÚMayrx )ÚJunZJune)ÚJulZJuly)ÚAugZAugust)ÚSepZSeptZ September)ÚOctZOctober)ÚNovZNovember)ÚDecZDecember)ÚhÚhourÚhours)rf ÚminuteÚminutes)rE ÚsecondÚseconds)Úamr% )ZpmÚpÚUTCÚGMTÚZÚzFc C s | | j¡| _| | j¡| _| | j¡| _| | j¡| _| | j ¡| _
|
| | j ¡| _ | | j ¡| _|| _|| _t ¡ j| _| jd d | _d S )Néd )Ú_convertÚJUMPÚ_jumpÚWEEKDAYSÚ _weekdaysÚMONTHSÚ_monthsÚHMSÚ_hmsÚAMPMÚ_ampmÚUTCZONEÚ_utczoneÚPERTAINÚ_pertainÚdayfirstÚ yearfirstÚtimeÚ localtimeÚtm_yearÚ_yearÚ_century)r r r r r r! r" & s zparserinfo.__init__c C sH i }t |D ]6\}}t|tr6|D ]}||| ¡ < q"q ||| ¡ < q |S r= )Ú enumerater ÚtupleÚlower)r ÚlstÚdctÚiÚvr r r! r 5 s
|
zparserinfo._convertc C s | ¡ | jkS r= )r¦ r ©r Únamer r r! Újump? s zparserinfo.jumpc C s* z| j | ¡ W S tk
|
r$ Y nX d S r= )r r¦ ÚKeyErrorr« r r r! ÚweekdayB s
|
zparserinfo.weekdayc C s. z| j | ¡ d W S tk
|
r( Y nX d S ©Nr# )r r¦ r® r« r r r! ÚmonthI s
|
zparserinfo.monthc C s, z| j | ¡ W S tk
|
r& Y d S X d S r= )r r¦ r® r« r r r! ÚhmsP s zparserinfo.hmsc C s, z| j | ¡ W S tk
|
r& Y d S X d S r= )r r¦ r® r« r r r! ÚampmV s zparserinfo.ampmc C s | ¡ | jkS r= )r¦ r r« r r r! Úpertain\ s zparserinfo.pertainc C s | ¡ | jkS r= )r¦ r r« r r r! Úutczone_ s zparserinfo.utczonec C s || j krdS | j |¡S )Nr )r ÚTZOFFSETÚgetr« r r r! Útzoffsetb s
|
zparserinfo.tzoffsetc C sT |dks t |dk rP|sP|| j7 }|| jd kr:|d8 }n|| jd k rP|d7 }|S )zt
|
Converts two-digit years to year within [-50, 49]
|
range of self._year (current local time)
|
r r é2 )ÚAssertionErrorr£ r¢ )r ÚyearÚcentury_specifiedr r r! Ú convertyearh s
|
|
zparserinfo.convertyearc C st |j d k r | |j |j¡|_ |jdkr,|jr@|jdks@|jdkrNd|_d|_n"|jdkrp|jrp| |j¡rpd|_dS )Nr r r r T)r» r½ r¼ r¸ Útznamerµ )r Úresr r r! Úvalidate| s
|
ÿÿ zparserinfo.validateN)FF)F)r rI rJ Ú__doc__r r r r r r r r¶ r" r r r¯ r± r² r³ r´ rµ r¸ r½ rÀ r r r r! r ñ sr þúõ þÿ
|
|
|
c sf e Zd Z fddZedd Zedd Zedd Zd d
|
Zd fd d Z dd Z
|
dd Z Z S )Ú_ymdc s0 t | j| j|| d| _d | _d | _d | _d S )NF)Úsuperr r" r¼ ÚdstridxÚmstridxÚystridx)r ÚargsÚkwargs©r r r! r" s
|
z _ymd.__init__c C s
|
| j d k S r= )rÆ r> r r r! Úhas_year s z _ymd.has_yearc C s
|
| j d k S r= )rÅ r> r r r! Ú has_month s z_ymd.has_monthc C s
|
| j d k S r= )rÄ r> r r r! Úhas_day s z _ymd.has_dayc C s | j r
|
dS | js(d| ko"dkS S | jsZ| | j }d| koTtd|d kS S | | j }| | j }d| kot||d kS S d S )NFr# é iÐ )rÌ rË rÊ rÅ r rÆ )r rW r± r» r r r! Ú could_be_day s
|
"
|
|
z_ymd.could_be_dayNc sæ t |dr:| ¡ r\t|dkr\d| _|dkr4t|d}n"|dkr\d| _|dkrXt|d}t| j| t|¡ |dkr| j rtdt| d | _
|
nJ|d
|
kr¾| j r®td t| d | _ n$|dkrâ| j rÔtd t| d | _d S ) Nr\ r T)NÚYrÏ r ÚMzMonth is already setr# ÚDzDay is already setzYear is already set)ÚhasattrrH r2 r¼ Ú
|
ValueErrorrà r r1 ÚintrË rÅ rÌ rÄ rÊ rÆ )r ÚvalÚlabelrÉ r r! r1 ¬ s0
|
z _ymd.appendc s¾ t dkrzt dkrzfddtdD }fdddD }t |t | kr\dksbn t|d }|d }||< t t kst fd d
|
D }| d ¡| d ¡| d ¡fS )z
|
Try to resolve the identities of year/month/day elements using
|
ystridx, mstridx, and dstridx, if enough of these are specified.
|
é r c s g | ]}| ¡ kr|qS r )Úvalues©rY Úx©Ústridsr r! Ú
|
<listcomp>Ï s z._ymd._resolve_from_stridxs.<locals>.<listcomp>c s g | ]}| kr|qS r r rÙ rÛ r r! rÝ Ð s )Úyrf Údr# r c s i | ]}| | qS r r )rY Úkey©r rÜ r r! Ú
|
<dictcomp>× s z._ymd._resolve_from_stridxs.<locals>.<dictcomp>rÞ rf rß )r2 Úrangerº r· )r rÜ Úmissingrà rÕ Úoutr rá r! Ú_resolve_from_stridxsÈ s "z_ymd._resolve_from_stridxsc
|
C s¸ t | }d\}}}d| jfd| jfd| jff}dd |D }t | t | krXdksrn t | dkr|t |d kr|| |¡S | j}|dkrtd
|
n|d ks®|d k rú|d krú|d k rÌ| | }| |d } n| d } |d ksä|d krö| d krò| }n| }n´|d kr^| d d kr | \}}n>| d d kr4| \}}n&|rR| d d krR| \}}n| \}}nP|dkr®|dkr| d d kr| \}}}n
|
| \}}}n|d krÞ| d d ksÆ|rÒ| d d krÒ| \}}}n
|
| \}}}nÐ|d kr| d d kr| \}}}n
|
| \}}}n | d d ksJ| jdksJ|rv| d d krv| d d krv|rj| d d krj| \}}}n
|
| \}}}n8| d d ks|r¤| d d kr¤| \}}}n
|
| \}}}|||fS )N)NNNrÞ rf rß c S s i | ]\}}|d k r||qS r= r )rY rà rÕ r r r! râ â s z$_ymd.resolve_ymd.<locals>.<dictcomp>r r× r zMore than three YMD valuesr# rÍ é )r2 rÆ rÅ rÄ ræ rÓ )
|
r r r Zlen_ymdr» r± ÚdayrÜ rÅ Úotherr r r! Ú resolve_ymdÚ s|
|
þ
|
ÿ
|
ÿ
|
|
|
|
|
|
|
|
"
|
ÿþ
|
þ
|
þ "
|
z_ymd.resolve_ymd)N) r rI rJ r" ÚpropertyrÊ rË rÌ rÎ r1 ræ rê Ú __classcell__r r rÉ r! r s
|
|
|
r c @ s² e Zd Zd)ddZd*ddZG dd deZd+d d
|
Zd d Zd d Z dd Z
|
dd Z dd Z dd Z dd Zdd Zdd Zd d Zd d Zd!d" Zd#d$ Zd%d& Zd'd( ZdS ),ÚparserNc C s |pt | _d S r= )r Úinfo)r rî r r r! r" 9 s zparser.__init__Fc
|
|
K sÖ |dkr t j ¡ jddddd}| j|f|\}}|dkrDtd|t|dkrZtd|z| ||¡}W n< tk
|
r¦ } z t tt
|
| d || ¡ W 5 d} ~ X Y nX |sº| |||¡}| dd¡rÎ||fS |S dS ) aW
|
|
Parse the date/time string into a :class:`datetime.datetime` object.
|
|
:param timestr:
|
Any date/time string using the supported formats.
|
|
:param default:
|
The default datetime object, if this is a datetime object and not
|
``None``, elements specified in ``timestr`` replace elements in the
|
default object.
|
|
:param ignoretz:
|
If set ``True``, time zones in parsed strings are ignored and a
|
naive :class:`datetime.datetime` object is returned.
|
|
:param tzinfos:
|
Additional time zone names / aliases which may be present in the
|
string. This argument maps time zone names (and optionally offsets
|
from those time zones) to time zones. This parameter can be a
|
dictionary with timezone aliases mapping time zone names to time
|
zones or a function taking two parameters (``tzname`` and
|
``tzoffset``) and returning a time zone.
|
|
The timezones to which the names are mapped can be an integer
|
offset from UTC in seconds or a :class:`tzinfo` object.
|
|
.. doctest::
|
:options: +NORMALIZE_WHITESPACE
|
|
>>> from dateutil.parser import parse
|
>>> from dateutil.tz import gettz
|
>>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
|
>>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
|
datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
|
>>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
|
datetime.datetime(2012, 1, 19, 17, 21,
|
tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
|
|
This parameter is ignored if ``ignoretz`` is set.
|
|
:param \*\*kwargs:
|
Keyword arguments as passed to ``_parse()``.
|
|
:return:
|
Returns a :class:`datetime.datetime` object or, if the
|
``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
|
first element being a :class:`datetime.datetime` object, the second
|
a tuple containing the fuzzy tokens.
|
|
:raises ParserError:
|
Raised for invalid or unknown string format, if the provided
|
:class:`tzinfo` is not in a valid format, or if an invalid date
|
would be created.
|
|
:raises TypeError:
|
Raised for non-string or character stream input.
|
|
:raises OverflowError:
|
Raised if the parsed date exceeds the largest valid C integer on
|
your system.
|
Nr )r r r
Ú microsecondzUnknown string format: %sz"String does not contain a date: %sz: %sÚfuzzy_with_tokensF) ÚdatetimeÚnowr6 Ú_parser r2 Ú _build_naiverÓ ÚsixÚ
|
raise_fromÚstrÚ_build_tzawarer· )
|
r ÚtimestrÚdefaultZignoretzÚtzinfosrÈ r¿ Úskipped_tokensÚretÚer r r! r < s& @ ÿ
|
|
, z parser.parsec @ s( e Zd Zddddddddd d
|
d d g Zd S )zparser._resultr» r± rè r¯ r r r
rï r¾ r¸ r³ Úany_unused_tokensN©r rI rJ rO r r r r! Ú_result s þr c C sn |rd}| j }|dkr |j}|dkr*|j}| ¡ }t |¡}g } t }
|
t|} d} zÂ| | k rè|| } z t| }W n t k
|
r d}Y nX |dk r®|
|
|| ||
|
||¡} n0| || ¡dk rØ| || ¡}||_ n| || ¡dk r | || ¡}|
|
|d¡ | d | k rÞ|| d dkr|| d }|
|
|| d ¡ | d | k r~|| d |kr~|
|
|| d ¡ | d7 } | d7 } n| d | k rÞ|| d || d kr¾d
|
krÞn nZ| || d ¡rÞ|| d ¡ rt|| d }t| |¡}|
|
|d ¡ n | d 7 } n¾| || ¡dk r| || ¡}| |j|j|¡}|rr| |j|¡|_||_n|rÞ| | ¡ nX| |j|j|j|| ¡r|| |_| |j¡|_| d | k rÞ|| d d krÞd || d d k || d < d|_| |j¡rÞd|_nÊ|jdk r´|| d kr´d|| d k }t|| d }|d krt|| d dd
}t|| d dd
}nz| d | k rÔ|| d dkrÔt|| d }t|| d }| d7 } n0|dkrüt|| d dd
}d}nt |||d |d |_| d | k rª| || d ¡rª|| d dkrª|| d dkrªdt|| d krª| |j|jd|| d ¡rª|| d |_| d 7 } | d7 } n*| || ¡sÔ|sÔt |n
|
| | ¡ | d7 } qV|
|
||¡\}}}|
|
j |_ ||_ ||_ ||_ W n t t fk
|
r2 Y dS X | !|¡sDdS |rb| "|| ¡}|t#|fS |dfS dS )a
|
Private method which performs the heavy lifting of parsing, called from
|
``parse()``, which passes on its ``kwargs`` to this function.
|
|
:param timestr:
|
The string to parse.
|
|
:param dayfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the day (``True``) or month (``False``). If
|
``yearfirst`` is set to ``True``, this distinguishes between YDM
|
and YMD. If set to ``None``, this value is retrieved from the
|
current :class:`parserinfo` object (which itself defaults to
|
``False``).
|
|
:param yearfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the year. If ``True``, the first number is taken
|
to be the year, otherwise the last number is taken to be the year.
|
If this is set to ``None``, the value is retrieved from the current
|
:class:`parserinfo` object (which itself defaults to ``False``).
|
|
:param fuzzy:
|
Whether to allow fuzzy parsing, allowing for string like "Today is
|
January 1, 2047 at 8:21:00AM".
|
|
:param fuzzy_with_tokens:
|
If ``True``, ``fuzzy`` is automatically set to True, and the parser
|
will return a tuple where the first element is the parsed
|
:class:`datetime.datetime` datetimestamp and the second element is
|
a tuple containing the portions of the string which were ignored:
|
|
.. doctest::
|
|
>>> from dateutil.parser import parse
|
>>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
|
(datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
|
|
TNr rÐ r# )r_ r` r r× é r' rÏ ©ú+r_ r ©r, r# ú:é é< é ú(ú))NN)$rî r r r r r5 r r2 ÚfloatrÓ Ú_parse_numeric_tokenr¯ r± r1 r´ rH rÔ r÷ r½ r³ Ú _ampm_validr Ú _adjust_ampmÚ_could_be_tznamer¾ r¸ rµ r rê r¼ r» rè Ú
|
IndexErrorrÀ Ú_recombine_skippedr¥ )r rù r r Úfuzzyrð rî r¿ r: Ú skipped_idxsÚymdÚlen_lr© Ú
|
value_reprrW Úsepr» Ú val_is_ampmÚsignalÚlen_liZ hour_offsetZ
|
min_offsetr± rè rü r r r! ró sÚ )
|
|
|
|
|
:ÿ
|
|
|
|
|
ÿÿþý
|
ÿü
|
|
|
|
|
z parser._parsec
|
C sh || }z| |¡}W n2 tk
|
rH } zt td| ¡ W 5 d } ~ X Y nX t|}
|
t|} t|dkrâ|
|
dkrâ|jd krâ|d | ksª||d dkrâ| ||d ¡d krâ|| } t| d d
|_|
|
dkrÞt| dd
|_ n|
|
dks
|
|
|
dkr ||
|
d ¡dkr || } |s^d || kr^| | d d
¡ | | dd
¡ | | dd
¡ n>t| d d
|_t| dd
|_ | | dd
¡\|_ |_nÄ|
|
d
|
kr8|| } | | d d
d ¡ | | dd
¡ | | dd
¡ |
|
d krdt| d d
|_t| d d
|_ |
|
dkrdt| dd
|_ n,| j|||ddd k r| j|||dd} | |||| ¡\}}|d k rd| |||¡ nÒ|d | k r.||d dkr.t||_| ||d ¡}| |¡\|_ |_ |d | k r"||d dkr"| ||d ¡\|_ |_|d7 }|d7 }n6|d | k rT||d dkrT||d }| |¡ |d | k rH| ||d ¡sH||d ¡ r¬| ||d ¡ n0| ||d ¡}|d k rÖ| |d¡ nt |d | k r@||d |kr@| ||d ¡}|d k r&| |d¡ n| ||d ¡ |d7 }|d7 }|d7 }n|d | ksv| ||d ¡rÞ|d | k rÊ| ||d ¡d k rÊt|}| || ||d ¡¡|_|d7 }n
|
| |¡ |d7 }n| ||d ¡d k r@d| krdk r@n n.t|}| || ||d ¡¡|_|d7 }n$| |¡rX| |¡ n |sdt |S )NzUnknown numeric tokenr× )r r r# r r r é r( )é rç é rÏ r é
|
rç T)Ú
|
allow_jump)r_ r` r( rÐ r é )Ú _to_decimalÚ Exceptionrõ rö rÓ r2 r r² rÔ r Úfindr1 Ú_parsemsr
rï Ú _find_hms_idxÚ
|
_parse_hmsÚ _assign_hmsÚ_parse_min_secr rH r± r³ r rÎ )r ÚtokensÚidxrî r r¿ r r rW rþ r r rE Úhms_idxr² r r r r r! r k s¬ "ÿ
|
þýü(
|
|
|
|
|
|
"
|
|
"&
|
|
|
4
|
zparser._parse_numeric_tokenc C sð t |}|d |k r4| ||d ¡d k r4|d }n¸|rt|d |k rt||d dkrt| ||d ¡d k rt|d }nx|dkr| ||d ¡d k r|d }nPd| k r´|d krèn n0||d dkrè| ||d ¡d k rè|d }nd }|S )Nr# r r' r )r2 r² )r r+ r* rî r r r, r r r! r& î s "
|
ÿ
|
|
,ÿ
|
zparser._find_hms_idxc C sr | |¡}|dkr8t||_|d rntd|d |_n6|dkrT| |¡\|_|_n|dkrn| |¡\|_|_d S )Nr r# r r )r" rÔ r r r) r
r% rï )r r¿ r r² rW r r r! r( s
|
|
zparser._assign_hmsc C sB |d k o@|d ko@|d ko@t |dko@tdd |D p@|| jjkS )Nr c s s | ]}|t jkV qd S r= )ÚstringÚascii_uppercaserÙ r r r! rZ % s z*parser._could_be_tzname.<locals>.<genexpr>)r2 Úallrî r )r r r¾ r¸ r7 r r r! r s ÿþ
|
ý
|
ûzparser._could_be_tznamec C s\ d}|r|dk rd}|dkr0|r&d}qXt dn(d| krDdksXn |rPd}nt d|S )z
|
For fuzzy parsing, 'a' or 'am' (both valid English words)
|
may erroneously trigger the AM/PM flag. Deal with that
|
here.
|
TNFz%No hour specified with AM or PM flag.r rç z)Invalid hour specified for 12-hour clock.)rÓ )r r r³ r r r r r! r ( s
|
zparser._ampm_validc C s2 |dk r|dkr|d7 }n|dkr.|dkr.d}|S )Nrç r# r r )r r r³ r r r! r D s
|
|
zparser._adjust_ampmc C s, t |}d }|d }|r$t d| }||fS )Nr# r )rÔ )r rW r r
Z sec_remainderr r r! r) K s zparser._parse_min_secc C sL |d krd }|}n2||kr.| || ¡}|}n| || ¡d }|}||fS r° )r² )r r+ r* rî r, r² Znew_idxr r r! r' W s zparser._parse_hmsc C sF d|krt |dfS | d¡\}}t |t | dd¡dd
fS dS )z9Parse a I[.F] seconds value into (seconds, microseconds).r( r r r& N)rÔ r5 Úljust)r rW r© Úfr r r! r% m s zparser._parsemsc
|
C s` z t |}| ¡ stdW n: tk
|
rV } z d| }t t||¡ W 5 d }~X Y nX |S d S )Nz*Converted decimal value is infinite or NaNz Could not convert %s to decimal)r Ú is_finiterÓ r# rõ rö )r rÕ Z decimal_valuerþ Úmsgr r r! r" u s "zparser._to_decimalc C sr t |r|||}n
|
| |¡}t|tjs2|d kr8|}n6t|trNt |¡}n t|trft ||¡}nt
|
d|S )Nz9Offset must be tzinfo subclass, tz string, or int offset.) Úcallabler· r rñ Útzinfor r Útzstrr r¸ r )r rû r¾ r¸ Ztzdatar5 r r r! Ú _build_tzinfo s
|
|
|
zparser._build_tzinfoc C s t |s|rD|j|krD| ||j|j¡}|j|d}| ||j¡}nÌ|jr |jtjkr |jt ¡ d}| ||j¡}| ¡ |jkr|j| j j
|
kr|jtj d}np|jdkrº|jtj d}nV|jrÚ|jt |j|j¡d}n6|jsì|jsì|}n$|jrt j dj|jdtd |}|S )N)r5 r z³tzname {tzname} identified but not understood. Pass `tzinfos` argument in order to correctly return a timezone-aware datetime. In a future version, this will raise an exception.)r¾ )Úcategory)r4 r¾ r7 r¸ r6 Ú_assign_tznamer r Ztzlocalrî r r Úwarningsr r ÚUnknownTimezoneWarning)r Únaiver¿ rû r5 Zawarer r r! rø s2 ÿ
|
üûzparser._build_tzawarec
|
C sÈ i }dD ] }t ||}|d k r|||< qd|kr|jd kr@|jn|j}|jd krV|jn|j}|jd krl|jn|j}|t||d krt||d |d< |jf |} |jd k rÄ|jsÄ| tj|jd } | S )N)r» r± rè r r r
rï rè r# )r¯ )r r» r± rè r r6 r¯ r
|
)
|
r r¿ rú ÚreplrQ rW ZcyearZcmonthZcdayr< r r r! rô Á s
|
|
zparser._build_naivec C s. | ¡ |kr*tj|dd}| ¡ |kr*|S |S )Nr# )Úfold)r¾ r Zenfold)r Údtr¾ Znew_dtr r r! r9 Ú s
|
zparser._assign_tznamec C s^ g }t t|D ]H\}}|dkrJ|d ||d krJ|d || |d< q| || ¡ q|S )zÄ
|
>>> tokens = ["foo", " ", "bar", " ", "19June2000", "baz"]
|
>>> skipped_idxs = [0, 1, 2, 5]
|
>>> _recombine_skipped(tokens, skipped_idxs)
|
["foo bar", "baz"]
|
r r# r, )r¤ Úsortedr1 )r r* r rü r© r+ r r r! r â s zparser._recombine_skipped)N)NFN)NNFF)r rI rJ r" r rN r ró r r& r( r r r r) r' r% r" r7 rø rô r9 r r r r r! rí 8 s4
|
ÿ
|
Y ÿ
|
R " (rí c K s( |rt |j| f|S tj| f|S dS )aÝ
|
|
Parse a string in one of the supported formats, using the
|
``parserinfo`` parameters.
|
|
:param timestr:
|
A string containing a date/time stamp.
|
|
:param parserinfo:
|
A :class:`parserinfo` object containing parameters for the parser.
|
If ``None``, the default arguments to the :class:`parserinfo`
|
constructor are used.
|
|
The ``**kwargs`` parameter takes the following keyword arguments:
|
|
:param default:
|
The default datetime object, if this is a datetime object and not
|
``None``, elements specified in ``timestr`` replace elements in the
|
default object.
|
|
:param ignoretz:
|
If set ``True``, time zones in parsed strings are ignored and a naive
|
:class:`datetime` object is returned.
|
|
:param tzinfos:
|
Additional time zone names / aliases which may be present in the
|
string. This argument maps time zone names (and optionally offsets
|
from those time zones) to time zones. This parameter can be a
|
dictionary with timezone aliases mapping time zone names to time
|
zones or a function taking two parameters (``tzname`` and
|
``tzoffset``) and returning a time zone.
|
|
The timezones to which the names are mapped can be an integer
|
offset from UTC in seconds or a :class:`tzinfo` object.
|
|
.. doctest::
|
:options: +NORMALIZE_WHITESPACE
|
|
>>> from dateutil.parser import parse
|
>>> from dateutil.tz import gettz
|
>>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
|
>>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
|
datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
|
>>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
|
datetime.datetime(2012, 1, 19, 17, 21,
|
tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
|
|
This parameter is ignored if ``ignoretz`` is set.
|
|
:param dayfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the day (``True``) or month (``False``). If
|
``yearfirst`` is set to ``True``, this distinguishes between YDM and
|
YMD. If set to ``None``, this value is retrieved from the current
|
:class:`parserinfo` object (which itself defaults to ``False``).
|
|
:param yearfirst:
|
Whether to interpret the first value in an ambiguous 3-integer date
|
(e.g. 01/05/09) as the year. If ``True``, the first number is taken to
|
be the year, otherwise the last number is taken to be the year. If
|
this is set to ``None``, the value is retrieved from the current
|
:class:`parserinfo` object (which itself defaults to ``False``).
|
|
:param fuzzy:
|
Whether to allow fuzzy parsing, allowing for string like "Today is
|
January 1, 2047 at 8:21:00AM".
|
|
:param fuzzy_with_tokens:
|
If ``True``, ``fuzzy`` is automatically set to True, and the parser
|
will return a tuple where the first element is the parsed
|
:class:`datetime.datetime` datetimestamp and the second element is
|
a tuple containing the portions of the string which were ignored:
|
|
.. doctest::
|
|
>>> from dateutil.parser import parse
|
>>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
|
(datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
|
|
:return:
|
Returns a :class:`datetime.datetime` object or, if the
|
``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
|
first element being a :class:`datetime.datetime` object, the second
|
a tuple containing the fuzzy tokens.
|
|
:raises ParserError:
|
Raised for invalid or unknown string formats, if the provided
|
:class:`tzinfo` is not in a valid format, or if an invalid date would
|
be created.
|
|
:raises OverflowError:
|
Raised if the parsed date exceeds the largest valid C integer on
|
your system.
|
N)rí r Ú DEFAULTPARSER)rù r rÈ r r r! r ö s _c @ s$ e Zd ZG dd deZdd ZdS )Ú _tzparserc @ s< e Zd ZddddddgZG dd deZd d
|
Zd d Zd S )z_tzparser._resultÚstdabbrÚ stdoffsetÚdstabbrÚ dstoffsetÚstartÚendc @ s e Zd ZdddddddgZdS ) z_tzparser._result._attrr± Úweekr¯ ÚydayÚjydayrè r Nr r r r r! Ú_attrb s ÿrL c C s
|
| d¡S )NÚ )rX r> r r r! r] f s z_tzparser._result.__repr__c C s" t | ¡ | ¡ | _| ¡ | _d S r= )rN r" rL rG rH r> r r r! r" i s
|
|
z_tzparser._result.__init__N)r rI rJ rO rN rL r] r" r r r r! r ] s ÿr c
|
s | ¡ }dd t d|¡D t }z"t }d}||k r6|}||k rfdd | D sf|d7 }qB||kr6|jsd}d ||
¡|_nd }d ||
¡|_t|D ]}| |¡ q°|}||k r" | d
|
ksì | d d kr" | d
|
kr d | d k } | |¡ |d7 }nd} t | }
|
|
|
dkrvt
|
||t | d d
d t | dd
d | n|d |k rÚ |d dkrÚt
|
||t | d t |d d | | |¡ |d7 }n6|
|
dkr
|
t
|
||t | d d
d | nW d S | |¡ |d7 }|jr4q6q4q6q4||k rt||D ] } | dkrJd |< qJ | dkszt |d7 }||krn¶d d¡ kr®dkrBn ndd |d
D sB|j|jfD ]Þ} t | | _| |¡ |d7 } | dkr2t |d d } | |¡ |d7 }n t | } | |¡ |d7 }| rt| | _t | d d | _nt | | _| |¡ |d7 }t | | _| |¡ |d7 }qØ||k r | dkrôd | d k } | |¡ |d7 }nd} | |¡ |jt | | |_td | d d d d! d" tj n d¡dkrF |d
d#¡dkrFd$d |d
D sF|j|jfD ]¦} | d%krÄ| |¡ |d7 }t | | _nä | d&kr| |¡ |d7 }t | | _| |¡ |d7 } | d'kst | |¡ |d7 }t | | _| jd(krHd| _| |¡ |d7 } | d'kslt | |¡ |d7 }t | d d | _nt | d | _| |¡ |d7 }||k r | d#kr| |¡ |d7 }t | }
|
|
|
dkr.t | d d
d t | dd
d | _nÐ|d |k rÐ |d dkrÐt | d t |d d | _| |¡ |d7 }|d |k rþ |d dkrþ| |¡ |d7 }| jt | 7 _n.|
|
dkröt | d d
d | _n W d S | |¡ |d7 }||ks, | dks,t |d7 }q||ksFt W n t t t fk
|
rf Y d S X t t| |¡} fd)d*| D ddh¡ |_!|S )+Nc S s g | ] }|r|qS r r rÙ r r r! rÝ p s z#_tzparser.parse.<locals>.<listcomp>z([,:.]|[a-zA-Z]+|[0-9]+)r c S s g | ]}|d kr|qS )z0123456789:,-+r rÙ r r r! rÝ z s ÿr# rD rM rF r Ú
|
0123456789)r# r, r r, r r r r r r^ r* r é c S s* g | ]"}|d kr|D ]}|dkr|qqS )r* z 0123456789+-r ©rY rÚ rÞ r r r! rÝ ¸ s ÿr_ é )r_ r r zParsed time zone "%s"z5is in a non-standard dateutil-specific format, which z3is now deprecated; support for parsing this format z6will be removed in future versions. It is recommended z2that you switch to a standard format like the GNU zTZ variable format.r` c S s* g | ]"}|d kr|D ]}|dkr|qqS ))r* r` ÚJrÐ r( r_ r rN r rP r r r! rÝ ã s þrR rÐ )r_ r( r c s h | ] } | qS r r )rY Ún©r: r r! Ú <setcomp>* s z"_tzparser.parse.<locals>.<setcomp>)"r rK r5 rC r2 rC rU rE rã r1 rP rÔ rº r3 rG rH r± rI r¯ rè r rD rF r r ZDeprecatedTzFormatWarningrK rJ r rÓ ÚsetÚ
|
differenceÚissubsetrÿ )r r6 r¿ Z used_idxsr r© ÚjZoffattrÚiir r rÚ rW Z unused_idxsr rT r! r n sH
|
|
|
ÿ
|
|
|
ÿÿ ÿÿÿ
|
|
|
ÿ
|
|
|
$ÿ
|
|
|
|
|
|
|
|
|
|
ÿþýüûû(ÿ
|
|
|
|
|
|
|
|
|
ÿ &
|
|
|
|
z_tzparser.parseN)r rI rJ rN r r r r r r! rB [ s rB c C s
|
t | ¡S r= )ÚDEFAULTTZPARSERr )r6 r r r! Ú_parsetz1 s r\ c s( e Zd ZdZ fddZdd Z ZS )r zûException subclass used for any failure to parse a datetime string.
|
|
This is a subclass of :py:exc:`ValueError`, and should be raised any time
|
earlier versions of ``dateutil`` would have raised ``ValueError``.
|
|
.. versionadded:: 2.8.1
|
c sF z| j d | j dd
W S ttfk
|
r@ tt| ¡ Y S X d S )Nr r# )rÇ r r rà r Ú__str__r> rÉ r r! r] = s zParserError.__str__c C s& d dd | jD ¡}d| jj|f S )NrS c s s | ]}d | V qdS )z'%s'Nr )rY Úargr r r! rZ D s z'ParserError.__repr__.<locals>.<genexpr>rR )rU rÇ r r )r rÇ r r r! r] C s zParserError.__repr__)r rI rJ rÁ r] r] rì r r rÉ r! r 5 s c @ s e Zd ZdZdS )r; zhRaised when the parser finds a timezone it cannot parse into a tzinfo.
|
|
.. versionadded:: 2.7.0
|
N)r rI rJ rÁ r r r r! r; H s r; )N)&rÁ Ú
|
__future__r rñ rK r- r r: Úcalendarr Úior rõ r r Údecimalr r rM r
|
r Ú__all__Úobjectr rN r rC r rí rA r rB r[ r\ rÓ r ÚRuntimeWarningr; r r r r! Ú<module> sH
|
" / @
|
e T
|
