Ë
|
Yñúh¬å ã ó~ d Z ddlmZ ddlZddlZddlZddlZddlZddlm Z ddl
|
m Z ddl Z ddl m Z mZ ddlmZ ddlmZ d d
|
lmZ d d lmZ g d ¢Z G d de« Z G d de« Z G d de« Z G d de« Z G d de« Z e « Z d dZ G d de« Z e « Z d Z! G d d e"« Z# G d d e$« Z%y) 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 ó e Zd Z ej d« Zd Zd Zd Zd Z d Z
|
e d « Z e d « Z e d « Ze d
|
« Zy ) Ú_timelexz([.,])c ó8 t |t t f« r|j « }t |t « r t |« }n<t |dd « /t dj |j j ¬« « || _ g | _ g | _ d| _ y )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 s úJH:\Change_password\venv_build\Lib\site-packages\dateutil/parser/_parser.pyÚ__init__z_timelex.__init__> s Ü h¤¬ Ð 2Ô 3Ø Ó(Hä h¤ Ô *Ü Ó)HÜ Xv tÓ ,Ð 4Üð &ß&,¡f°8×3EÑ3E×3NÑ3N fÓ&OóQð Qð ! ØØ Øó c óð | j r| j j d« S d}d}d}| j s'| j r | j j d« }nA| j j d« }|dk( r!| j j d« }|dk( r!|s d| _ n³|sC|}| j |« rd}n| j |« rd}nw| j |« rd }npnn|dk( rEd}| j |« r||z }nA|d
|
k( r ||z }d }n3| j j |« n$|dk( rS| j |« r||z }nú|d
|
k( s|d k( rt |« d k\ r||z }d}nÚ| j j |« nÌ|d k( r[d}|d
|
k( s| j |« r||z }n| j |« r|d d
|
k( r||z }d}nz| j j |« nl|dk( rY|d
|
k( s| j |« r||z }n=| j |« r|d d
|
k( r||z }d }n | j j |« n| j s'|dv re|s|j d
|
« dkD s|d dv rH| j j |« }|d }|dd D ] }|s| j j |« " |dk( r&|j d
|
« dk( r|j 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" Ú seenlettersÚtokenÚstateÚnextcharÚlÚtoks r# Ú get_tokenz_timelex.get_tokenM s÷ ð ??Ø??×&Ñ& qÓ)Ð )à ØØà((ð
|
~~Ø >>×-Ñ-¨aÓ0à ==×-Ñ-¨aÓ0Ø &Ò(Ø #}}× 1Ñ 1°!Ó 4Hð &Ó(ñ Ø ÙÙð !Ø;;xÔ(Ø EØZZ Ô)Ø EØ\\ (Ô+Ø EÙáØ# ð # Ø;;xÔ(ØXÑ%EØ _ØXÑ%EØ EàNN×)Ñ)¨(Ô3ÙØ# ð ::hÔ'ØXÑ%EØ _¨°Sª ¼SÀ»ZÈ1º_ØXÑ%EØ EàNN×)Ñ)¨(Ô3ØØ$ ð # Øs? d§k¡k°(Ô&;ØXÑ%EØZZ Ô)¨e°B©i¸3Ò.>ØXÑ%EØ EàNN×)Ñ)¨(Ô3ØØ$ ð s? d§j¡j°Ô&:ØXÑ%EØ[[ Ô*¨u°R©y¸CÒ/?ØXÑ%EØ EàNN×)Ñ)¨(Ô3ØðS ((ðV \Ñ !¡{°e·k±kÀ#Ó6FÈÒ6JØ',¨R¡y°DÑ'8Ø×#Ñ#×)Ñ)¨%Ó0AØaDEØuò 0ÚØOO×*Ñ*¨3Õ/ð 0ð D=U[[¨Ó -°Ò 2ØMM # sÓ+Eà r% c ó | S ©N© ©r" s r# Ú__iter__z_timelex.__iter__º s Ø r% c ó6 | j « }|t |S rC )rA Ú StopIteration)r" r< s r# Ú__next__z_timelex.__next__½ s ØÓ Ø =Ü Ð à r% c ó" | j « S rC )rI rE s r# Únextz _timelex.nextÄ s Ø}}Ð r% c ó$ t | |« « S rC )Úlist)ÚclsÚss r# r9 z_timelex.splitÇ s äCF|Ðr% c ó" |j « S )z5 Whether or not the next character is part of a word )Úisalpha©rN r> s r# r2 z_timelex.iswordË ó ð × Ñ Ó!Ð!r% c ó" |j « S )z0 Whether the next character is part of a number )ÚisdigitrR s r# r3 z_timelex.isnumÐ rS r% c ó" |j « S )z* Whether the next character is whitespace )r4 rR s r# r4 z_timelex.isspaceÕ rS r% N)r Ú
|
__module__Ú __qualname__ÚreÚcompiler8 r$ rA rF rI rK Ú classmethodr9 r2 r3 r4 rD r% r# r r : s} à RZZ Ó)Nò ò kòZòò ð ñ ó ð ð ñ"ó ð"ð ñ"ó ð"ð ñ"ó ñ"r% r c ó$ e Zd Zd Zd Zd Zd Zy)Ú _resultbasec ó@ | j D ] }t | |d « y rC )Ú __slots__Úsetattr)r" Úattrs r# r$ z_resultbase.__init__Ý s! ØNNò &DÜ D$ Õ %ñ &r% c ó² g }| j D ]0 }t | |« }||j |dt |« « 2 |ddj |« dS )Nú=ú(ú, ú))r_ r r5 ÚreprÚjoin)r" Ú classnamer? ra Úvalues r# Ú_reprz_resultbase._reprá sV Ø ØNNò 8DÜD $Ó'EØÑ Ø¢D¬$¨u¬+Ð6Õ7ð 8ò % d§i¡i°¥lÐ3Ð3r% c ó@ t fd j D « « S )Nc 3 ó: K | ] }t |« d u y wrC )r )Ú.0ra r" s r# ú <genexpr>z&_resultbase.__len__.<locals>.<genexpr>ê s% øè ø ò 0Ø ô D $Ó'¨tÔ3ñ 0ùs )Úsumr_ rE s `r# Ú__len__z_resultbase.__len__é s! ø Üó 0Ø $§¡ô0ó 0ð 1r% c óL | j | j j « S rC )rk r r rE s r# Ú__repr__z_resultbase.__repr__í s Øzz$..×1Ñ1Ó2Ð2r% N)r rW rX r$ rk rq rs rD r% r# r] r] Û s ò&ò4ò1ó3r% r] c ó e Zd ZdZg d¢Zg d¢Zg d¢Zg d¢ZddgZg d¢Z d gZ
|
i Z dd
|
Z d Z d Zd Zd Zd Zd Zd Zd Zd ZddZd Zy)r 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ÚtÚofÚstÚndÚrdÚth))ÚMonÚMonday)ÚTueÚTuesday)ÚWedÚ Wednesday)ÚThuÚThursday)ÚFriÚFriday)ÚSatÚSaturday)ÚSunÚSunday) )ÚJanÚJanuary)ÚFebÚFebruary)ÚMarÚMarch)ÚAprÚApril)ÚMayr )ÚJunÚJune)ÚJulÚJuly)ÚAugÚAugust)ÚSepÚSeptÚ September)ÚOctÚOctober)ÚNovÚNovember)ÚDecÚDecember))ÚhÚhourÚhours)r} ÚminuteÚminutes)rO ÚsecondÚseconds)Úamr) )ÚpmÚp)ÚUTCÚGMTÚZÚzr c óT | j | j « | _ | j | j « | _ | j | j
|
« | _ | j | j « | _ | j | j « | _
|
| j | j « | _ | j | j « | _ || _ || _ t# j$ « j& | _ | j( dz dz | _ y )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Ê s r# r$ zparserinfo.__init__& sÅ Ø]] 4§9¡9Ó-
|
Ø t§}¡}Ó5Ø}} T§[¡[Ó1 ØMM $§(¡(Ó+ Ø]] 4§9¡9Ó-
|
Ø d§l¡lÓ3 Ø d§l¡lÓ3 à Ø"ä^^Ó%×-Ñ-
|
Ø
|
|
cÑ)¨CÑ/ r% c ó¬ i }t |« D ]C \ }}t |t « r|D ] }|||j « < 1|||j « < E |S rC )Ú enumerater ÚtupleÚlower)r" ÚlstÚdctÚiÚvs r# rº zparserinfo._convert5 s^ ØÜ cNò #DAqÜ!UÔ#Øò 'AØ%&C Nñ'ð "#AGGIð #ð
|
r% c ó: |j « | j v S rC )rÓ r¼ ©r" Únames r# Újumpzparserinfo.jump? s Øzz|tzzÐ)Ð)r% c ó\ | j |j « S # t $ r Y y w xY wrC )r¾ rÓ ÚKeyErrorrÙ s r# Úweekdayzparserinfo.weekdayB s1 ð Ø>> $§*¡*£,Ñ/Ð /øÜò Ø Øð úó +ª+c ób | j |j « dz S # t $ r Y y w xY w©Nr' )rÀ rÓ rÝ rÙ s r# Úmonthzparserinfo.monthI s6 ð Ø<< §
|
¡
|
£ Ñ-°Ñ1Ð 1øÜò Ø Øð ús " ¢ ..c ó\ | j |j « S # t $ r Y y w xY wrC )r rÓ rÝ rÙ s r# Úhmszparserinfo.hmsP s. ð Ø99TZZ\Ñ*Ð *øÜò Ùð úrß c ó\ | j |j « S # t $ r Y y w xY wrC )rÄ rÓ rÝ rÙ s r# Úampmzparserinfo.ampmV s. ð Ø::djjlÑ+Ð +øÜò Ùð úrß c ó: |j « | j v S rC )rÓ rÈ rÙ s r# Úpertainzparserinfo.pertain\ ó Øzz|t}}Ð,Ð,r% c ó: |j « | j v S rC )rÓ rÆ rÙ s r# Úutczonezparserinfo.utczone_ ré r% c óV || j v ry| j j |« S )Nr )rÆ ÚTZOFFSETÚgetrÙ s r# Útzoffsetzparserinfo.tzoffsetb s& Ø 4==Ñ Øà}}× Ñ Ó&Ð&r% c ó |dk\ sJ |dk rA|s?|| j z }|| j dz k\ r|dz }|S || j dz
|
k r|dz }|S )zt
|
Converts two-digit years to year within [-50, 49]
|
range of self._year (current local time)
|
r r¹ é2 )rÏ rÎ )r" ÚyearÚcentury_specifieds r# Ú convertyearzparserinfo.convertyearh sh ð qyÐyà #:Ñ /à DMMÑ !Dàtzz BÒ&Ø ð ð
|
|
RÒ'Ø à r% c ó| |j +| j |j |j « |_ |j dk( r |j r |j dk( s|j dk( rd|_ d|_ y|j dk7 r.|j r"| j |j « rd|_ y)Nr r¶ r· r´ T)rò rô ró rï Útznamerë )r" Úress r# Úvalidatezparserinfo.validate| s à 88Ð Ø×'Ñ'¨¯©°#×2GÑ2GÓHCHà \\QÒ s§z¢zØjjCÒ 3§:¡:°Ò#4Ø CJØ CLð ð \\QÒ 3§:¢:°$·,±,¸s¿z¹zÔ2JØ CLØr% N)FF)F)r rW rX Ú__doc__r» r½ r¿ rÁ rà rÅ rÇ rí r$ rº rÛ rÞ râ rä ræ rè rë rï rô rø rD r% r# r r ñ s ñò$ $Dò#Hò #Fò 'Cð Ø ð Dâ&GØfGØHó 0ò ò*òòòò ò -ò-ò'ó ó( r% r c ól e Zd Z fdZed « Zed « Zed « Zd Zd fd Z d Z
|
d Z xZ S )
|
Ú_ymdc óp t | j |
|
|i |¤ d| _ d | _ d | _ d | _ y )NF)Úsuperr r$ ró ÚdstridxÚmstridxÚystridx)r" ÚargsÚkwargsr s r# r$ z _ymd.__init__ s8 ø Ü dnndÑ,¨dÐ=°fÒ=Ø!&Ô Ø Ø Ø r% c ó | j d uS rC )r rE s r# Úhas_yearz _ymd.has_year ó à|| 4Ð'Ð'r% c ó | j d uS rC )rÿ rE s r# Ú has_monthz_ymd.has_month r r% c ó | j d uS rC )rþ rE s r# Úhas_dayz _ymd.has_day r r% c ó: | j ry| j sd|cxk xr dk S c S | j s,| | j }d|cxk xr t d|« d k S c S | | j }| | j
|
}d|cxk xr t ||« d k S c S )NFr' é iÐ )r r r rÿ r r )r" rj râ rò s r# Ú could_be_dayz_ymd.could_be_day s Ø <<ØØ ØÖ# Ñ#Ð #Ñ#Ð #Ø à Ñ&EØÖ;¤¨D°%Ó!8¸Ñ!;Ñ;Ð ;Ñ;Ð ;à Ñ&EØ Ñ%DØÖ;¤¨D°%Ó!8¸Ñ!;Ñ;Ð ;Ñ;Ð ;r% c ó* t |d« r7|j « rDt |« dkD r6d| _ |dvr t |« d}n |dkD rd| _ |dvr t |« d}t
|
| j | t |« « |dk( r+| j r t d« t | « d z
|
| _
|
y |d
|
k( r+| j r t d « t | « d z
|
| _ y |dk( r+| j r t d « t | « d z
|
| _ y y ) Nrq r
|
T)NÚYr r¹ ÚMzMonth is already setr' ÚDzDay is already setzYear is already set)ÚhasattrrU r6 ró Ú
|
ValueErrorrý r r5 Úintr rÿ r rþ r r )r" ÚvalÚlabelr s r# r5 z _ymd.append¬ sþ ø Ü 3 Ô "Ø{{}¤ S£¨A¢ Ø)-Ô&Ø Ñ+Ü$ UÓ+Ð+ØØ 3YØ%)DÔ "ØKÑ'Ü Ó'Ð'ØEä dnndÑ*¬3¨s«8Ô4à C<Ø~~Ü Ð!7Ó8Ð8Ü t9 q=DLØ c\Ø||Ü Ð!5Ó6Ð6Ü t9 q=DLØ c\Ø}}Ü Ð!6Ó7Ð7Ü t9 q=DLð r% c óú t | « dk( r~t |« dk( rpt d« D cg c] }||j « vs| }}dD cg c] }||vs| }}t |« t |« cxk( rdk( sJ J |d }|d }|||< t | « t |« k( sJ |D ci c] }|| || }}|j d« |j d« |j d« fS c c}w c c}w c c}w ) z
|
Try to resolve the identities of year/month/day elements using
|
ystridx, mstridx, and dstridx, if enough of these are specified.
|
é r
|
)Úyr} Údr' r r r} r )r6 ÚrangeÚvaluesrî )r" ÚstridsÚxÚmissingÚkeyr Úouts r# Ú_resolve_from_stridxsz_ymd._resolve_from_stridxsÈ sý ô
|
t9>c &k¨QÒ .ä"'¨£(ÖGQ¨a°v·}±}³Ò.FqÐGGÐGØ -ÖA°¸&² 1ÐACÐAÜw<¤3 s£8Ô0¨qÒ0Ð 0Ñ0Ð 0Ð0Øa&CØ!*CØ F3Kä4yC KÒ'Ð'Ð'Ø17Ö8¨#sD Ñ%Ñ%Ð8Ð8Ø cgg cl¨C¯G©G°C«LÐ9Ð9ùò HùÚAùò 9s ªC.ÁC.Á C3ÁC3Â*C8c óâ t | « }d\ }}}d| j fd| j fd| j ff}|D ci c] \ }} | || }}} t | « t |« cxk( rdkD s n t | « dk( r t |« dk( r| j |« S | j }
|
|dkD r t d« |d k( s|
|
-|dk( r(|
|
| |
|
}| |
|
d z
|
} n| d } |d kD s|
|
| d
|
kD r| }nú| }n÷|dk( r2| d d
|
kD r| \ }}nä| d d
|
kD r| \ }}nÖ|r| d d k r| \ }}nÆ| \ }}nÀ|dk( r»|
|
dk( r| d d
|
kD r| \ }}}n§| \ }}}n |
|
d k( r | d d
|
kD s
|
|r| d d
|
k r| \ }}}n| \ }}}n{|
|
dk( r| d d
|
kD r| \ }}}ng| \ }}}n`| d d
|
kD s!| j dk( s|r(| d d k r | d d
|
k r|r| d d k r| \ }}}n&| \ }}}n | d d kD s
|
|r| d d k r| \ }}}n| \ }}}|||fS c c} }w ) N)NNNr r} r r r r
|
zMore than three YMD valuesr' r é )r6 r rÿ rþ r! r ) r" rÊ rÉ Úlen_ymdrò râ Údayr r r rÿ Úothers r# Ú resolve_ymdz_ymd.resolve_ymdÚ s Üd)Ø-ÑeSà Ð%Ø Ð%Ø Ð%ð'ð ,2×Exs C°S±_#s(ÐEÑEÜ IVÔ ( qÔ (ÜTa ¤C¨£K°1Ò$4Ø×-Ñ-¨fÓ5Ð 5à,,à Q;Ü Ð 9Ó:Ð :Ø \gÐ 1°gÀ²làÐ"Ø W ð W q[Ñ)à Qà{goØ2:Ø Dà Cà \àAw|à " eØa2 à " tÙd 1g¨mà !
|
Uð "
|
sà \à!|Ø7R<à'+Ñ$E4¡à'+Ñ$E3¡ØA Ø7R<¡I°$°q±'¸R²-à'+Ñ$D%¡ð
|
(,Ñ$C¡àA à7R<à'+Ñ$Cuð (,Ñ$D#uð GbLØLL AÒ%Ù" t¨A¡w°"¢}¸¸a¹ÀBº á D¨¡G¨r¢MØ+/Ñ(c¡5à+/Ñ(e¡SØ!Wr\¡h°4¸±7¸b²=à'+Ñ$C¡ð (,Ñ$E3 àUCÐ Ð ùóg Fs Á
|
G+Á G+rC ) r rW rX r$ Úpropertyr r r r r5 r! r' Ú __classcell__©r s @r# rû rû sY ø ô ð ñ(ó ð(ð ñ(ó ð(ð ñ(ó ð(ò <õ )ò8:ö$[ r% rû c ó e Zd ZddZ ddZ G d de« Z ddZd Zd Z d Z
|
d
|
Z d Z d Z d Zd Zd Zd Zd Zd Zd Zd Zd Zy)ÚparserNc ó* |xs
|
t « | _ y rC )r Úinfo)r" r. s r# r$ zparser.__init__9 s ØÒ(JL r% c óè |1t j j « j dddd¬« } | j |fi |¤\ }}| t d|« t |« dk( r t d|« | j ||« }|s| j ||« }|j dd« r|fS S # t $ r6} t j t t | « dz |« | « Y d} ~ gd} ~ ww xY w) 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Únowr: Ú_parser r6 Ú _build_naiver ÚsixÚ
|
raise_fromÚstrÚ_build_tzawarerî )
|
r" ÚtimestrÚdefaultÚignoretzÚtzinfosr r÷ Úskipped_tokensÚretÚes
|
r# r z parser.parse< s ð@ ?Ü ×'Ñ'×+Ñ+Ó-×5Ñ5¸1ÀQØ=>ÈAð 6ó OGð *dkk¨'Ñ <°VÑ <Ñ^à ;Ü Ð 9¸7ÓCÐ Cä s8q=Ü Ð BÀGÓLÐ Lð EØ×#Ñ# C¨Ó1Cñ Ø×%Ñ% c¨3°Ó8Cà ::Ð)¨5Ô 1ØÐ&Ð &àJøô ò EÜ NN;¤s¨1£v°¡¸Ó@À!× DÑ Dûð Eús Á3B2 Â2 C1Â;,C,Ã,C1c ó e Zd Zg d¢Zy)úparser._result) rò râ r% rÞ r« r r¯ r0 rö rï ræ Úany_unused_tokensN©r rW rX r_ rD r% r# Ú_resultrB s
|
òG r% rE c ó |rd}| j }| |j }| |j }| j « }t j |« }g } t « }
|
t |« } d} | | k r}|| } t | « }|| j || ||
|
||« } nF|j || « |j || « }||_ n|j || « '|j || « }|
|
j |d« | dz | k rÑ|| dz dv rU|| dz }|
|
j || dz « | dz | k r'|| dz |k( r |
|
j || d z « | dz } | dz } nr| d z | k ri|| dz || dz cxk( rd
|
k( rQn nM|j || dz « r5|| d z j « r>t! || d z « }t# |j% |« « }|
|
j |d « n | d z } nÙ|j' || « }|j' || « }| j) |j* |j& |« }|r*| j- |j* |« |_ ||_ n^|r[| j | « nH| j/ |j* |j0 |j2 || « r~|| |_ |j3 |j0 « |_ | dz | k rà|| dz d v rÕd || dz d k( || dz < d|_ |j5 |j0 « rd|_ n|j* V|| d v rNd|| d k( }t || dz « }|d k( r)t! || dz dd « }t! || dz dd « }nb| dz | k r3|| dz dk( r(t! || dz « }t! || dz « }| dz } n'|dk rt! || dz dd « }d}n t |« ||dz |dz z z |_ | dz | k r|j7 || dz « rj|| dz dk( r_|| dz dk( rTdt || d z « k r@| j/ |j* |j0 d|| d z « r|| d z |_ | d z } | dz } n2|j7 || « s |s t |« | j | « | dz } | | k r}|
|
j9 ||« \ }}}|
|
j: |_ ||_ ||_ ||_ |jC |« sy|r | jE || « }|tG |« fS |dfS # t $ r d}Y íw xY w# t@ t f$ r Y yw xY w)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' )rv rw r
|
r é r+ r ©ú+rv rI ©r0 r' ú:é é< é rd rf )NN)$r. rÉ rÊ rE r r9 rû r6 Úfloatr Ú_parse_numeric_tokenrÞ râ r5 rè rU r r8 rô ræ Ú _ampm_validr« Ú _adjust_ampmÚ_could_be_tznamerö rï rë rÛ r' ró rò r% Ú
|
IndexErrorrø Ú_recombine_skippedrÒ )r" r: rÉ rÊ Úfuzzyr1 r. r÷ r? Ú skipped_idxsÚymdÚlen_lrÖ Ú
|
value_reprrj Úseprò Ú val_is_ampmÚsignalÚlen_liÚ hour_offsetÚ
|
min_offsetrâ r% r> s r# r4 z parser._parse s ñR ØEàyyà Ð Ø}}Hà Ð Ø IàllnÜ NN7Ó #à ô fäAØ ðH Øe)ð qT
|
ð!Ü ! *Ó -Eð Ð$à ×1Ñ1°!°Q¸¸cÀ3ÈÓNAð \\ ! A¡$Ó'Ð3Ø LL¨¨1©Ó .EØ"'CKð ZZ !¡Ó%Ñ1Ø JJ q¨¡tÓ ,EØJJu cÔ*à1uu}Ø Q U8 zÑ1à"# A¨¡E¡(CØ JJ q¨¨Q©¡xÔ 0à 1u u}°°1°q±5±¸S² à #§
|
¡
|
¨1¨Q°©U©8Ô 4Ø ! Q¡ à FAà !e em°°!°a±%±¸A¸aÀ!¹e¹HÔ0KÈ×0KØ "ll¨1¨Q°©U©8Õ 4ð ! Q¡x× /Ñ /Ô 1ä(+¨A¨a°!©e©H« Ü'*¨4×+;Ñ+;¸EÓ+BÓ'C Ø #§
|
¡
|
¨4°Õ 5ð !%à FAð YYq t_Ð0Ø II a¨¡dOEØ"&×"2Ñ"2°3·8±8¸S¿X¹XÀuÓ"MKá"Ø#'×#4Ñ#4°S·X±X¸uÓ#EØ#(â Ø$×+Ñ+¨AÖ.ð ×*Ñ*¨3¯8©8°S·Z±ZÀÇ Á ÈqÐQRÉtÔTØ!" 1¡CJØ#'§=¡=°·±Ó#<CLð 1uu}¨¨1¨q©5©°ZÒ)?Ø#-¨a°°A±©h¸#©oÑ#>!a%Ø'+ Ø <<¨¯
|
©
|
Õ3ð *.CJð XXÑ)¨a°©d°jÒ.@Ø $ Q q¡T¨S¡[Ñ 1FÜ 1 q¡5¡]Fð {ä&)¨!¨A°©E©(°2°A¨,Ó&7 Ü%(¨¨1¨q©5©°!°"¨ Ó%6
|
ØQ ¨1¨Q°©U©8°sª?ä&)¨!¨A°©E©(£m Ü%(¨¨1¨q©5©£]
|
ØQØ 1ä&)¨!¨A°©E©(°2°A¨,Ó&7 Ø%&
|
ä (¨Ó 1Ð1à#)¨[¸4Ñ-?À*ÈrÁ/Ñ-QÑ#RCLð A Ø II a¨¨A©¡hÔ /°A°a¸!±e±HÀ²OØ a !eH¨OØ ¤ Q q¨1¡u¡X£ Ò .Ø × 1Ñ 1°#·(±(¸C¿J¹JØ26¸¸!¸a¹%¹ô Bð &' q¨1¡u¡X
|
ØQàFAð )) A a¡D/©UÜ$ WÓ-Ð-ð !×'Ñ'¨Ô*ØQðy e)ð~ #¨y¸(Ó CÑ D%à$'×$9Ñ$9CÔ !ØCHØ CIØCGð
|
}}SÔ!Ø á Ø !× 4Ñ 4°Q¸ Ó ENØnÓ-Ð-Ð -à9Ð øôU "ò !Ø Eð!ûô@ JÐ'ò Ù ð ús= Á, U4 Á8 U" ÂQ*U4 Ó/<U4 Õ" U1Õ-U4 Õ0U1Õ1U4 Õ4VÖVc ó¢
|
|| } | j |« }t |« }
|
t |« } t |« dk( rl|
|
dv rh|j \|dz | k\ s"||dz dk7 rI|j ||dz « 2|| } t | d d « |_ |
|
dk( rt | dd « |_ |S |
|
dk( s |
|
dkD r¬|| j d « dk( r|| } |sEd || vr>|j | d d « |j | dd « |j | dd « |S t | d d « |_ t | dd « |_ | j | dd « \ |_ |_ |S |
|
d
|
v r|| } |j | d d d « |j | dd « |j | dd « |
|
d kD r>t | d d « |_ t | d d « |_ |
|
dkD rt | dd « |_ |S | j |||d¬« C| j |||d¬« } | j! |||| « \ }}|| j# |||« |S |dz | k r||dz dk( rt « |_ | j ||dz « }| j% |« \ |_ |_ |dz | k r4||dz dk( r)| j ||dz « \ |_ |_ |dz }|dz }|S |dz | k r||dz dv r||dz }|j |« |dz | k rÛ|j' ||dz « sÄ||dz j) « r|j ||dz « n6|j+ ||dz « }||j |d« n
|
t « |dz | k rS||dz |k( rH|j+ ||dz « }||j |d« n|j ||dz « |dz }|dz }|dz }|S |dz | k\ s|j' ||dz « rt|dz | k rT|j- ||dz « =t « }| j/ ||j- ||dz « « |_ |dz }n|j « |dz }|S |j- ||dz « Ldcxk rdk rAn n>t |« }| j/ ||j- ||dz « « |_ |dz }|S |j1 « r|j |« |S |s
|
t « |S # t $ r*} t j t d« | « Y d } ~ 1d } ~ ww xY w)NzUnknown numeric tokenr )r
|
rG r' rK r
|
rG é r, )é r# é r rc é
|
r# T)Ú
|
allow_jump)rv rw r, r r é )Ú _to_decimalÚ Exceptionr6 r7 r r6 r« rä r r Úfindr5 Ú_parsemsr¯ r0 Ú _find_hms_idxÚ
|
_parse_hmsÚ _assign_hmsÚ_parse_min_secrÛ rU râ ræ rR r )r" ÚtokensÚidxr. rX r÷ rV rZ rj r@ r^ rY rO Úhms_idxrä r[ r« s r# rP zparser._parse_numeric_tokenk s¶ àC[
|
ð CØ×$Ñ$ ZÓ0Eô Z äF ä HMf¨Ñ .Ø HHÐ Ø 1WÒ ØS1Wo Ò$Øhhvc AgÓ'Ð/às AÜ1Ra5zCHà{Ü 1 2 Z
|
ðV
|
ðS q[V aZ¨F°3©K×,<Ñ,<¸SÓ,AÀQÒ,Fàs Aá3 f¨S¡kÑ1Ø
|
|
1Ra5Ô!Ø
|
|
1Qq6Ô"Ø
|
|
1QR5Ô!ðD
|
ô{ q !u:Ü 1 Q [
|
Ø.2¯m©m¸A¸a¸b¸EÓ.BÑ+
|
COðv
|
ðs {Ñ "às AØ JJq!ucÔ "Ø JJq1vÔ Ø JJq1vÔ àzÜ q 2w<Ü 2 b ]
|
àB;Ü!$ Q r s V£CJðZ
|
ðW × Ñ V¨T¸dÐ Ó CÐ Oà×(Ñ(¨¨f°dÀtÐ(ÓLGØ ¨¨f°d¸GÓDJS#Øð × Ñ j°#Ô6ðH
|
ðE 1Wu_ ¨¨a©¡ °CÒ!7ä5zCHØ×$Ñ$ V¨C°!©G¡_Ó5EØ'+×':Ñ':¸5Ó'AÑ $SZàQw 6¨#°©'¡?°cÒ#9Ø.2¯m©m¸FÀ3ÈÁ7¹OÓ.LÑ+
|
COàqà 1HCðn
|
ðk 1Wu_ ¨¨a©¡ °OÒ!CØq/CØ JJzÔ "àQw t§y¡y°¸¸a¹± Ô'AØ# '?×*Ñ*Ô,àJJv c¨A¡gÕ/ð !JJ v¨c°A©g¡Ó 7Eà Ð(Ø
|
|
5¨#Õ.ä (lÐ*à7U? v¨c°A©g¡¸#Ò'=à JJ v¨c°A©g¡Ó 7Eà Ð(Ø
|
|
5¨#Õ.à
|
|
6¨#°©'¡?Ô3Ø1HCàqØ 1HCð2
|
ð/ 1WÒ §¡¨6°#¸±'©?Ô!;ØQw 4§9¡9¨V°C¸!±G©_Ó#=Ð#Iä5zØ ×,Ñ,¨T°4·9±9¸VÀCÈ!ÁG¹_Ó3MÓNØqð
|
|
5Ô!Ø 1HCð
|
ð YYvc AgÓ 'Ð 3¸¸e¼ Àb½ äu:DØ×(Ñ(¨¨t¯y©y¸ÀÀaÁ¹ Ó/IÓJCHØ 1HCð
|
ð × Ñ eÔ $Ø JJuÔ ð
|
|
ñ Ü ,Ð à
|
øôy ò CÜ NN:Ð&=Ó>À× BÒ Bûð Cús T Ô UÔ$ U Õ Uc ó t |« }|dz |k r |j ||dz « |dz }|S |r1|dz |k r)||dz dk( r |j ||dz « |dz }|S |dkD r |j ||dz
|
« |dz
|
}|S d|cxk r|dz
|
k( r,n n)||dz
|
dk( r |j ||dz
|
« |dz
|
}|S d }|S )Nr' r
|
r+ r )r6 rä )r" rq rp r. rf rY rr s r# rl zparser._find_hms_idxî s ÜF à q55=TXX f¨S°©U¡mÓ 4Ð @ð AgGð2 ñ/ S U U]¨v°c¸!±e©}ÀÒ/CØhhvc !e}Ó%Ð1ð AgGð& ð# 1W &¨¨Q©¡-Ó0Ð<ð
|
!eGð ð #Ô qÕ V¨C°©E¡]°cÒ%9Øhhvc !e}Ó%Ð1ð AgGð
|
ð Gàr% c ó | j |« }|dk( r-t |« |_ |dz rt d|dz z « |_ y y |dk( r | j |« \ |_ |_ y |dk( r | j |« \ |_ |_ y y )Nr r' rM r
|
)rh r r« r ro r¯ rk r0 )r" r÷ rZ rä rj s r# rn zparser._assign_hms s à× Ñ Ó,à !8ä5zCHØqyÜ U¨Q¡Y¡ Ó 0
|
ð ð AXØ'+×':Ñ':¸5Ó'AÑ $SZà AXØ,0¯M©M¸*Ó,EÑ )SZ ð r% c ó |d uxrH |d u xrB |d u xr< t |« dk xr, t d |D « « xs || j j v S )NrN c 3 ó@ K | ] }|t j v y wrC )ÚstringÚascii_uppercase)rn r s r# ro z*parser._could_be_tzname.<locals>.<genexpr>% s è ø Ò@°QQ&×0Ñ0Ô0Ñ@ùs )r6 Úallr. rÅ )r" r« rö rï r< s r# rS zparser._could_be_tzname sf ØDÐ ò 0Ø$ò0àDÐ ò0ô E
|
aò0ô Ñ@¸%Ô@Ó@ò /ØTYY× .Ñ .Ð.ð 1r% c óx d}|r|d}||rd}|S t d« d|cxk rdk sn |rd}|S t d« |S )z
|
For fuzzy parsing, 'a' or 'am' (both valid English words)
|
may erroneously trigger the AM/PM flag. Deal with that
|
here.
|
TFz%No hour specified with AM or PM flag.r r# z)Invalid hour specified for 12-hour clock.)r )r" r« ræ rV r\ s r# rQ zparser._ampm_valid( sn ð ñ TÐ%Ø Kð <ÙØ # ð Ðô !Ð!HÓIÐIØd b ñ Ø # ð Ðô !Ð!LÓMÐMàÐr% c ó@ |dk r |dk( r|dz }|S |dk( r|dk( rd}|S )Nr# r' r rD )r" r« ræ s r# rR zparser._adjust_ampmD s8 Ø "9 Ø BJDð ð RZD AIØDØ r% c óN t |« }d }|dz }|rt d|z « }||fS )Nr' rM )r )r" rj r r¯ Ú sec_remainders r# ro zparser._parse_min_secK s8 ô UØà Ù ÜmÑ+Ó,FØÐ Ð r% c ó |d }|}||fS ||kD r|j || « }|}||fS |j || « dz }|}||fS rá )rä )r" rq rp r. rr rä Únew_idxs r# rm zparser._parse_hmsW ss ð
|
?ØCØGð ~Ð ð s]Ø((6 '?Ó+CØ Gð ~Ð ð ((6 '?Ó+¨aÑ/CØGà~Ð r% c ó d|vr t |« dfS |j d« \ }}t |« t |j dd« dd « fS )z9Parse a I[.F] seconds value into (seconds, microseconds).r, r rb r* N)r r9 Úljust)r" rj rÖ Úfs r# rk zparser._parsemsm sO à eÑ Üu:q=Ð à;;sÓ#DAqÜq63qww q¨#¨r°Ð 2Ó3Ð3Ð 3r% c óÊ t |« }|j « s t d« |S # t $ r.}d|z }t j
|
t |« |« Y d }~y d }~ww xY w)Nz*Converted decimal value is infinite or NaNz Could not convert %s to decimal)r Ú is_finiter ri r6 r7 )r" r Ú decimal_valuer@ Úmsgs r# rh zparser._to_decimalu sh ð
|
!Ü # CLMð !×*Ñ*Ô,Ü Ð!MÓNÐNð -ð !Ð øô ò /Ø3°cÑ9CÜ NN: c?¨A× .Ñ .ûð /ús &+ « A"´$A Á A"c óB t |« r
|
|||« }n|j |« }t |t j « s||}|S t |t
|
« rt j |« }|S t |t « rt j ||« }|S t d« )Nz9Offset must be tzinfo subclass, tz string, or int offset.) Úcallablerî r r2 Útzinfor r Útzstrr rï r )r" r= rö rï Útzdatar s r# Ú _build_tzinfozparser._build_tzinfo s Ü GÔ Ù V XÓ.Fà [[ Ó(Fô fhooÔ .°&°.ØFð ô ¤ Ô *ÜXXfÓ%Fð ô ¤ Ô .Ü[[ ¨Ó0Fð ô ð -ó .ð .r% c ó, t |« s|re|j |v rW| j ||j |j « }|j |¬« }| j ||j « }|S |j r½|j t j v r¡|j t j « ¬« }| j ||j « }|j « |j k7 rB|j | j j v r |j t j ¬« }|S |j dk( r"|j t j ¬« }|S |j r<|j t j |j |j « ¬« }|S |j s|j s|}|S |j r7t j dj |j ¬« t ¬« |}S )N)r 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)r rö r rï r: Ú_assign_tznamerË r Útzlocalr. rÅ r´ Úwarningsr r ÚUnknownTimezoneWarning)r" Únaiver÷ r= r Úawares r# r9 zparser._build_tzaware s¡ Ü WÔ ¡'¨c¯j©j¸GÑ.CØ×'Ñ'¨°·±¸S¿\¹\ÓJFØMM¨MÓ0EØ×'Ñ'¨¨s¯z©zÓ:EðD ðA ZZCJJ¬$¯+©+Ñ 5ØMM¬¯©« MÓ6Eð ×'Ñ'¨¨s¯z©zÓ:Eð #§*¡*Ò,ØJJ $§)¡)×"3Ñ"3Ñ3Ø ¬R¯V©V Ó4ð. ð+ \\QÒ ØMM¬¯©MÓ0Eð( ð% \\ØMM¬¯©°S·Z±ZÀÇ Á Ó)NMÓOEð" ð C§L¢LàEð ð ZZô MMð '÷ (.¡v°S·Z±Z vÓ'@Ü#9õ ;ð Eà r% c ó i }dD ] }t ||« }||||< d|vr|j |j n |j }|j |j n |j }|j |j n |j }|t ||« d kD rt ||« d |d< |j
|
di |¤} |j /|j s#| t j |j ¬« z } | S )N)rò râ r% r« r r¯ r0 r% r' )rÞ rD )r rò râ r% r r: rÞ r )
|
r" r÷ r; Úreplra rj ÚcyearÚcmonthÚcdayr s
|
r# r5 zparser._build_naiveÁ sð Øð8ò #DäC Ó&EØÑ Ø "T
|
ð #ð Ñ ð %(§H¡HÐ$4GLL¸#¿(¹(EØ&)§i¡iÐ&7W]]¸S¿Y¹YFØ"%§'¡' /7;;°s·w±wDàj ¨Ó/°Ñ2Ò2Ü (¨°Ó 7¸Ñ :U à Ñ' $Ñ'à ;;Ð "¨3¯7ª7ØM× 7Ñ 7ÀÇ Á Ô LÑLEà r% c ó |j « |k7 r,t j |d¬« }|j « |k( r|S |S )Nr' )Úfold)rö r Úenfold)r" Údtrö Únew_dts r# r zparser._assign_tznameÚ s8 Ø 99;&Ò ÜYYr¨Ô*FØ}} &Ò(Ø à r% c ó® g }t t |« « D ]; \ }}|dkD r |dz
|
||dz
|
k( r|d || z |d< (|j || « = |S )zÄ
|
>>> tokens = ["foo", " ", "bar", " ", "19June2000", "baz"]
|
>>> skipped_idxs = [0, 1, 2, 5]
|
>>> _recombine_skipped(tokens, skipped_idxs)
|
["foo bar", "baz"]
|
r r' r0 )rÑ Úsortedr5 )r" rp rW r> rÖ rq s r# rU zparser._recombine_skippedâ ss ð Ü ¤ |Ó 4Ó5ò 3FAsØ1uq L°°Q±Ñ$7Ò7Ø%3°BÑ%7¸&À¹+Ñ%ErÒ"à ×%Ñ% f¨S¡kÕ2ð 3ð Ð r% rC )NFN)NNFF)r rW rX r$ r r] rE r4 rP rl rn rS rQ rR ro rm rk rh r r9 r5 r rU rD r% r# r, r, 8 s
ó)ð &*Ø&*óWôrG+ô Gð
|
DIØ!&óO òbAòF òDFò 1òò8ò
|
ò ò,4ò !ò$ò$&òPò2ó r% r, c ój |r t |« j | fi |¤S t j | fi |¤S )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.
|
)r, r Ú DEFAULTPARSER)r: r r s r# r r ö s; ñ~ Ø'vjÓ!×'Ñ'¨Ñ:°6Ñ:Ð:ä ×"Ñ" 7Ñ5¨fÑ5Ð5r% c ó( e Zd Z G d de« Zd Zy)Ú _tzparserc ó6 e Zd Zg d¢Z G d de« Zd Zd Zy)ú_tzparser._result)ÚstdabbrÚ stdoffsetÚdstabbrÚ dstoffsetÚstartÚendc ó e Zd Zg d¢Zy)ú_tzparser._result._attr)râ ÚweekrÞ ÚydayÚjydayr% rË NrD rD r% r# Ú_attrr® b s ò9Ir% r² c ó$ | j d« S )NÚ )rk rE s r# rs z_tzparser._result.__repr__f s Ø::b>Ð !r% c ó t j | « | j « | _ | j « | _ y rC )r] r$ r² r« r¬ rE s r# r$ z_tzparser._result.__init__i s* Ü × Ñ Ô &Ø DJØzz|DHr% N)r rW rX r_ r] r² rs r$ rD r% r# rE r¦ ] s ò% ô 9Kô 9ò "ó $r% rE c
|
óè | j « }t j d|« D cg c] }|s| }}t « } t |« }d}||k rì|}||k r9|| D cg c] }|dv r|
|
c}s"|dz }||k r|| D cg c] }|dv r|
|
c}s"||k7 r|j
|
s d} dj ||| « |_ nd} dj ||| « |_ t |« D ] }
|
|j |
|
« |}||k r%|| dv s || d d v r|| dv r"d
|
|| d k( } |j |« |dz }nd } t || « } | d k( r8t || t || d d « dz t || dd « dz z | z « n|dz |k rV||dz dk( rKt || t || « dz t ||dz « dz z | z « |j |« |dz }n)| dk r#t || t || d d « dz | z « ny |j |« |dz }|j rnn||k rì||k r.t ||« D ] }|| dk( s d||< || dk( sJ |dz }||k\ rnðd|j d« cxk rdk rÏn nË||d D cg c] }|dk7 s |D ] } | dvr|
|
c} }s¤|j |j fD ]÷ }t || « |_ |j |« |dz }|| dk( r+t ||dz « d z }|j |« |dz }nt || « }|j |« |dz }|r!||_ t || « dz
|
dz |_ nt || « |_ |j |« |dz }t || « |_ |j |« |dz }ù ||k r_|| dv r"d|| d k( } |j |« |dz }nd} |j |« |j( t || « | z z |_ t- d|z d z d z d z d z d z t. j0 « n|j d« dk( rñ||d j d!« dk rÙ||d D cg c] }|d"vs|D ] } | d vr|
|
c} }s³|j |j fD ] }|| d#k( r*|j |« |dz }t || « |_ nô|| d$k( rÖ|j |« |dz }t || « |_ |j |« |dz }|| d%v sJ |j |« |dz }t || « |_ |j d&k( rd |_ |j |« |dz }|| d%v sJ |j |« |dz }t || « dz
|
dz |_ nt || « dz |_ |j |« |dz }||k r7|| d!k( r.|j |« |dz }t || « } | d k( r/t || d d « dz t || dd « dz z |_ nÀ|dz |k r||dz dk( rt || « dz t ||dz « dz z |_ |j |« |dz }|dz |k rd||dz dk( rY|j |« |dz }|xj& t || « z c_ n!| dk rt || d d « dz |_ n y |j |« |dz }||k( s
|
|| dk( sJ |dz } ||k\ sJ t= t |« « j? |« }|D ch c] }|| c}jA ddh« |_! |S c c}w c c}w c c}w c c} }w c c} }w # t6 t8 t: f$ r Y y w xY wc c}w )'Nz([,:.]|[a-zA-Z]+|[0-9]+)r z0123456789:,-+r' r¨ r´ rª rH Ú
|
0123456789)r' r0 rI r0 rG r
|
rL rM rK ru r. rc é z 0123456789+-rv é )rv rI rJ 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.rw )r. rw ÚJr r, rv rK rº r )rv r, rN )"rE rY r9 rM r6 r§ rh r© r r5 r` r r7 r« r¬ râ r¯ rÞ r% rË r¨ rª r r ÚDeprecatedTzFormatWarningr± r° rT r ÚAssertionErrorÚsetÚ
|
differenceÚissubsetrC )r" r r÷ r r? Ú used_idxsrY rÖ ÚjÚoffattrÚiir] r^ r rj Ú unused_idxsÚns r# r z_tzparser.parsen sõ ØllnÜÐ!<¸UÓCÖ I1ÂqQÐ IÐ IÜF ðu äFEàAØe)àØ%i°A°a±Dö )C¨qØ,-Ð1AÑ,Aò *+ó )CàFAð %i°A°a±Dö )C¨qØ,-Ð1AÑ,Aò *+ô )Cð 6Ø ;;Ø"-Ø&(§g¡g¨a°°!¨f£o à"-Ø&(§g¡g¨a°°!¨f£o ä # Ahò -Ø!×(Ñ(¨Õ,ð-àAØE q¨¡t¨zÑ'9¸Q¸q¹TÀ!¹WØ'3ò>4à Q4 :Ñ-ð &-¨Q¨q©T°S©[Ñ%9FØ %× ,Ñ ,¨QÔ /Ø FAà%'FÜ!$ Q q¡T£Ø! Q;ä # C¨´3°q¸±t¸B¸Q°x³=À4Ñ3GÜ36°q¸±t¸A¸B°x³=À2Ñ3Eñ4FØIOñ3Põ Qà U U]¨q°°Q±©x¸3ªä # C¨Ü%(¨¨1©£Y°Ñ%5Ü%(¨¨1¨q©5©£]°RÑ%7ñ&8Ø;Añ%Bô Cð &× ,Ñ ,¨QÔ /Ø FAØ # q[ä # C¨Ü$'¨¨!©¨R¨a¨£M°DÑ$8¸6Ñ$Aõ Cð $(Ø!×(Ñ(¨Ô+ØQØ{{Ø àðe e)ðj 5yÜ q % ò #AØts{Ø "!ð#ð ts{Ð"{àQàEzÙØqwws|Ô( q×(Ø"# A B %÷ >Q¨1°«8Ø !ò>Ø Q¨nÑ%<ò ð >qõ >ð )) S§W¡WÐ-ò AÜ ! ! A¡$iAGØ ×$Ñ$ QÔ'ØFAØts{Ü # A a¨!¡e¡H£ °Ñ 2Ø!×(Ñ(¨Ô+ØQä # A a¡D£ Ø ×$Ñ$ QÔ'ØFAÙ Ø!&Ü%(¨¨1©£Y°¡]°aÑ$7 ä # A a¡D£ Ø ×$Ñ$ QÔ'ØFAÜ 1¡YAFØ ×$Ñ$ QÔ'ØFAð+ð, u9ØtzÑ)Ø!(¨¨1©°©Ñ!5Ø!×(Ñ(¨Ô+ØQà!"Ø ×$Ñ$ QÔ'Ø%(§]¡]´S¸¸1¹³YÀÑ5GÑ%GCMô Ð-°Ñ5ØLñMàJñKð NñNð Jñ Jð
|
+ñ +ô
|
-/×,HÑ,Hö Jð ''#, !Ó#¨¨!¨"¨¯ © °CÓ(8¸AÓ(=Ø"# A B %÷ <Q¨1ð 5Dò ,Dà !ò<à Q¨lÑ%:ò ð <qõ <ð )) S§W¡WÐ-ó <AØts{à!×(Ñ(¨Ô+ØQÜ"% a¨¡d£)Ø1 à!×(Ñ(¨Ô+ØQÜ"% a¨¡d£)Ø!×(Ñ(¨Ô+ØQØ t zÑ 1Ð1Ð 1Ø!×(Ñ(¨Ô+ØQÜ!$ Q q¡T£Ø 66 Q;Ø%'AFØ!×(Ñ(¨Ô+ØQØ t zÑ 1Ð1Ð 1Ø!×(Ñ(¨Ô+ØQÜ%(¨¨1©£Y°¡]°aÑ$7 ô "% Q q¡T£¨Q¡ à ×$Ñ$ QÔ'ØFAà5y Q q¡T¨S£[Ø!×(Ñ(¨Ô+ØQä!$ Q q¡T£Ø! Q;ä&)¨!¨A©$¨r°¨(£m°dÑ&:Ü&)¨!¨A©$¨q¨r¨(£m°bÑ&8ñ'9AFà U U]¨q°°Q±©x¸3ªä%(¨¨1©£Y°Ñ%5¼¸A¸aÀ!¹e¹H» ÈÑ8JÑ%JAFØ %× ,Ñ ,¨QÔ /Ø FAØ 1u u}°°1°q±5±¸S² Ø )× 0Ñ 0°Ô 3Ø ! Q¡ Ø !§¢¬#¨a°©d«)Ñ 3¦Ø # q[ä&)¨!¨A©$¨r°¨(£m°dÑ&:AFá#'Ø!×(Ñ(¨Ô+ØQà :¨¨1©°ªÐ4Ð4àFAðy<ð| EzÐ!zô
|
% ,Ó'×2Ñ2°9Ó= Ø3>Ö$?¨a Q q£TÒ$?×$HÑ$HÈ#ÈcÈÓ$SÐ SÔ Ø
|
ùòw Jùò)Cùò )Cùó|>ùóV<øôF J¬Ð7ò Ùð üò %@s ©^:±^:Á!_ Á# ^?Á0_  _Â_ ÂF _ È)_ É _ É A_ Ê"
|
_ Ê-_ Ê<G _ Ò _Ò$_Ò3J_ Ü74_ Þ _/Þ?_ ß_,ß+_,N)r rW rX r] rE r rD r% r# r¤ r¤ [ s ô$+ô $ó"}r% r¤ c ó, t j | « S rC )ÚDEFAULTTZPARSERr )r s r# Ú_parsetzrÈ 1 s Ü × Ñ Ó 'Ð'r% c ó( e Zd ZdZ fdZd Z xZS )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 ó | j d | j dd z S # t t f$ r t t | « cY S w xY w)Nr r' )r r rT rý r Ú__str__)r" r s r# rË zParserError.__str__= sI ø ð 6Ø99Q< $§)¡)¨A¨B -Ñ/Ð /øÜ:Ð&ò 6Ü dÑ3Ó5Ò 5ð 6ús " ¢!AÁAc ó~ dj d | j D « « }| j j d|dS )Nre c 3 ó& K | ] }d |z yw)z'%s'NrD )rn Úargs r# ro z'ParserError.__repr__.<locals>.<genexpr>D s è ø Ò;¨# # Ñ;ùs rd rf )rh r r r )r" r s r# rs zParserError.__repr__C s/ ØyyÑ;°·±Ô;Ó;Ø >>×2Ó2²DÐ9Ð9r% )r rW rX rù rË rs r) r* s @r# r r 5 s ø ñô6ö :r% r c ó e Zd ZdZy)r zhRaised when the parser finds a timezone it cannot parse into a tzinfo.
|
|
.. versionadded:: 2.7.0
|
N)r rW rX rù rD r% r# r r H s òr% r rC )&rù Ú
|
__future__r r2 rY rw rË r Úcalendarr Úior r6 r r Údecimalr r r´ r r Ú__all__Úobjectr r] r rM rû r, r¢ r r¤ rÇ rÈ r r ÚRuntimeWarningr rD r% r# ú<module>r× sÈ ðñ õ: (ã Û Û Û Û å Ý ã
|
ß (å å å Ý â
|
0ô ^"vô ^"ôB3&ô 3ô,Vô Vôrk 4ô k ô\x
|
Vô x
|
ñv ób6ôJPô Pñf +ò(ô:*ô :ô&^õ r%
|
