qcP dZddlZddlZddlZddlZddlmZmZmZmZdZ dZ ej dZ dZ ded d fded d fded dfdeddfdeddfdeddfdeddfgZdeDZdeDZdZej dezZedeeddDZdZeZdZdFd!ZdGd"Zd#ZdHd%ZedZed&ZGd'd(eZed)Zej deZ!ej"dZ#Gd*d+eZ$e$Z%d,Z&edd-d.dZ'edd/ddZ(edd0ddZ)edd1d2dZ*edd0d3dZ+e*Z,Gd4d5eZ-e-d6d7d8d9Z.e-d:d;dd?d@dAZ0e-dBdCdDdEZ1dS)IaPython's :mod:`datetime` module provides some of the most complex and powerful primitives in the Python standard library. Time is nontrivial, but thankfully its support is first-class in Python. ``dateutils`` provides some additional tools for working with time. Additionally, timeutils provides a few basic utilities for working with timezones in Python. The Python :mod:`datetime` module's documentation describes how to create a :class:`~datetime.datetime`-compatible :class:`~datetime.tzinfo` subtype. It even provides a few examples. The following module defines usable forms of the timezones in those docs, as well as a couple other useful ones, :data:`UTC` (aka GMT) and :data:`LocalTZ` (representing the local timezone as configured in the operating system). For timezones beyond these, as well as a higher degree of accuracy in corner cases, check out `pytz`_ and `dateutil`_. .. _pytz: https://pypi.python.org/pypi/pytz .. _dateutil: https://dateutil.readthedocs.io/en/stable/index.html N)tzinfo timedeltadatedatetimecNd}|j|jdzz}|j||zz}||z S)aaFor those with older versions of Python, a pure-Python implementation of Python 2.7's :meth:`~datetime.timedelta.total_seconds`. Args: td (datetime.timedelta): The timedelta to convert to seconds. Returns: float: total number of seconds >>> td = timedelta(days=4, seconds=33) >>> total_seconds(td) 345633.0 g.AiQ)secondsdays microseconds)tda_millitd_dstd_micros 1lib/python3.11/site-packages/boltons/timeutils.py total_secondsr>s6G J"'E/ *E%'/2H g cX|jr |tz }n |tz }t|S)u_Converts from a :class:`~datetime.datetime` object to an integer timestamp, suitable interoperation with :func:`time.time` and other `Epoch-based timestamps`. .. _Epoch-based timestamps: https://en.wikipedia.org/wiki/Unix_time >>> abs(round(time.time() - dt_to_timestamp(datetime.utcnow()), 2)) 0.0 ``dt_to_timestamp`` supports both timezone-aware and naïve :class:`~datetime.datetime` objects. Note that it assumes naïve datetime objects are implied UTC, such as those generated with :meth:`datetime.datetime.utcnow`. If your datetime objects are local time, such as those generated with :meth:`datetime.datetime.now`, first convert it using the :meth:`datetime.datetime.replace` method with ``tzinfo=`` :class:`LocalTZ` object in this module, then pass the result of that to ``dt_to_timestamp``. )r EPOCH_AWARE EPOCH_NAIVEr)dtr s rdt_to_timestamprQs2( y +  +    rz\Dc\dt|D}t|S)aParses the limited subset of `ISO8601-formatted time`_ strings as returned by :meth:`datetime.datetime.isoformat`. >>> epoch_dt = datetime.utcfromtimestamp(0) >>> iso_str = epoch_dt.isoformat() >>> print(iso_str) 1970-01-01T00:00:00 >>> isoparse(iso_str) datetime.datetime(1970, 1, 1, 0, 0) >>> utcnow = datetime.utcnow() >>> utcnow == isoparse(utcnow.isoformat()) True For further datetime parsing, see the `iso8601`_ package for strict ISO parsing and `dateutil`_ package for loose parsing and more. .. _ISO8601-formatted time: https://en.wikipedia.org/wiki/ISO_8601 .. _iso8601: https://pypi.python.org/pypi/iso8601 .. _dateutil: https://pypi.python.org/pypi/python-dateutil c,g|]}t|S)int).0ps r zisoparse..s;;;!s1vv;;;r) _NONDIGIT_REsplitr)iso_strdt_argss risoparser"os0.<;|11'::;;;G W rrsecond<minutehourr dayweekmonthimyearcNg|]"}|d|dz|d|df#S)rr#r.rrbs rrrs3 6 6 6AaD1Q4K1qt $ 6 6 6rcg|] }|d S)rrr3s rrrs'''!1'''rz*[+-]?\ *(\d+(\.\d*)?|\.\d+)([eE][+-]?\d+)?z!((?P%s)\s*(?P\w)\w*)c0g|]\}}}|d|dzfS)rsr)r_units rrrsACCC'Q4q'4#:.CCCrc i}t|D]}|d|d}} t|}n:#t$r-t d|dtwxYw t|}n##t $rt d|d|wxYw|||<tdi|S)aRobustly parses a short text description of a time period into a :class:`datetime.timedelta`. Supports weeks, days, hours, minutes, and seconds, with or without decimal points: Args: text (str): Text to parse. Returns: datetime.timedelta Raises: ValueError: on parse failure. >>> parse_td('1d 2h 3.5m 0s') == timedelta(days=1, seconds=7410) True Also supports full words and whitespace. >>> parse_td('2 weeks 1 day') == timedelta(days=15) True Negative times are supported, too: >>> parse_td('-1.5 weeks 3m 20s') == timedelta(days=-11, seconds=43400) True valuer9zinvalid time unit z, expected one of zinvalid time value for unit z: r) _PARSE_TD_REfinditergroup_PARSE_TD_KW_MAPKeyError ValueErrorkeysfloatr)text td_kwargsmatchr<r9unit_keys rparse_timedeltarIs!2I&&t,, $ $kk'**EKK,?,?t @'-HH @ @ @* $&6&;&;&=&=&=?@@ @ @ .%LLEE . . .* $ee-.. . .$ (  ! !y ! !!s A7BB## Cc|dkr|S|dzS)Nr#r7r)r9r<s r_cardinalize_time_unitrKs z #:rTc\|tj}||z }t|}t|}t jt |dz }t |\}} } |t| z } t| |} |r| t| t| fS| | fS)aGet a tuple representing the relative time difference between two :class:`~datetime.datetime` objects or one :class:`~datetime.datetime` and now. Args: d (datetime): The first datetime object. other (datetime): An optional second datetime object. If unset, defaults to the current time as determined :meth:`datetime.utcnow`. ndigits (int): The number of decimal digits to round to, defaults to ``0``. cardinalize (bool): Whether to pluralize the time unit if appropriate, defaults to ``True``. Returns: (float, str): A tuple of the :class:`float` difference and respective unit of time, pluralized if appropriate and *cardinalize* is set to ``True``. Unlike :func:`relative_time`, this method's return is amenable to localization into other languages and custom phrasing and formatting. >>> now = datetime.utcnow() >>> decimal_relative_time(now - timedelta(days=1, seconds=3600), now) (1.0, 'day') >>> decimal_relative_time(now - timedelta(seconds=0.002), now, ndigits=5) (0.002, 'seconds') >>> decimal_relative_time(now, now - timedelta(days=900), ndigits=1) (-2.5, 'years') Nr#) rutcnowrabsbisect _BOUND_DELTAS_BOUNDSroundrK) dotherndigits cardinalizediff diff_secondsabs_diffb_idxbboundbunitbnamef_diff rounded_diffs rdecimal_relative_timer`s@ "!! 19D &&L4yyH M- 2 2Q 6E"5>FE5 M%00 0F))LN3E3|;L;LMMMM  rclt|||d\}}d}|dkrd}dt|||fzS)aIGet a string representation of the difference between two :class:`~datetime.datetime` objects or one :class:`~datetime.datetime` and the current time. Handles past and future times. Args: d (datetime): The first datetime object. other (datetime): An optional second datetime object. If unset, defaults to the current time as determined :meth:`datetime.utcnow`. ndigits (int): The number of decimal digits to round to, defaults to ``0``. Returns: A short English-language string. >>> now = datetime.utcnow() >>> relative_time(now, ndigits=1) '0 seconds ago' >>> relative_time(now - timedelta(days=1, seconds=36000), ndigits=1) '1.4 days ago' >>> relative_time(now + timedelta(days=7), now, ndigits=1) '1 week from now' T)rVagorzfrom nowz%g %s %s)r`rN)rSrTrUdrtr9phrases r relative_timeresL2&aTJJJIC F Qw S40 00rcTtj||}|S)aqParse the date string according to the format in `format`. Returns a :class:`date` object. Internally, :meth:`datetime.strptime` is used to parse the string and thus conversion specifiers for time fields (e.g. `%H`) may be provided; these will be parsed but ignored. Args: string (str): The date string to be parsed. format (str): The `strptime`_-style date format string. Returns: datetime.date .. _`strptime`: https://docs.python.org/2/library/datetime.html#strftime-strptime-behavior >>> strpdate('2016-02-14', '%Y-%m-%d') datetime.date(2016, 2, 14) >>> strpdate('26/12 (2015)', '%d/%m (%Y)') datetime.date(2015, 12, 26) >>> strpdate('20151231 23:59:59', '%Y%m%d %H:%M:%S') datetime.date(2015, 12, 31) >>> strpdate('20160101 00:00:00.001', '%Y%m%d %H:%M:%S.%f') datetime.date(2016, 1, 1) )rstrptimer)stringformatwhences rstrpdaterks$. vv . .F ;;==rFc#(Kt|tstd|r$t|tstd |\}}}t|t|}}n#t$r dd|}}}YnwxYwt|trt t|}n(t|trnt d|z||dzz }|d}n;||kr|r t jn t j}n|r t j n t j }|}|||sW|V|r@t|j d z |zd\} } | |j| z| d z }||z}|||WdS) aIn the spirit of :func:`range` and :func:`xrange`, the `daterange` generator that yields a sequence of :class:`~datetime.date` objects, starting at *start*, incrementing by *step*, until *stop* is reached. When *inclusive* is True, the final date may be *stop*, **if** *step* falls evenly on it. By default, *step* is one day. See details below for many more details. Args: start (datetime.date): The starting date The first value in the sequence. stop (datetime.date): The stopping date. By default not included in return. Can be `None` to yield an infinite sequence. step (int): The value to increment *start* by to reach *stop*. Can be an :class:`int` number of days, a :class:`datetime.timedelta`, or a :class:`tuple` of integers, `(year, month, day)`. Positive and negative *step* values are supported. inclusive (bool): Whether or not the *stop* date can be returned. *stop* is only returned when a *step* falls evenly on it. >>> christmas = date(year=2015, month=12, day=25) >>> boxing_day = date(year=2015, month=12, day=26) >>> new_year = date(year=2016, month=1, day=1) >>> for day in daterange(christmas, new_year): ... print(repr(day)) datetime.date(2015, 12, 25) datetime.date(2015, 12, 26) datetime.date(2015, 12, 27) datetime.date(2015, 12, 28) datetime.date(2015, 12, 29) datetime.date(2015, 12, 30) datetime.date(2015, 12, 31) >>> for day in daterange(christmas, boxing_day): ... print(repr(day)) datetime.date(2015, 12, 25) >>> for day in daterange(date(2017, 5, 1), date(2017, 8, 1), ... step=(0, 1, 0), inclusive=True): ... print(repr(day)) datetime.date(2017, 5, 1) datetime.date(2017, 6, 1) datetime.date(2017, 7, 1) datetime.date(2017, 8, 1) *Be careful when using stop=None, as this will yield an infinite sequence of dates.* z%start expected datetime.date instancez,stop expected datetime.date instance or Nonerr*zBstep expected int, timedelta, or tuple (year, month, day), not: %r NcdS)NFr)nowstops rzdaterange..sUrr#)r1r0) isinstancer TypeErrorrrrBoperatorgtgeltledivmodr0replacer1) startrpstep inclusivey_stepm_stepd_stepfinishedrom_y_step cur_months r dateranger8sf eT " "A?@@@ HJtT**HFGGG2!%Vc&kk ,,,!"At,&#@F ,,, FI & &@ 8:>?@@ @ frkF =** $="+<8;;"+<8;; ChsD!!  5"(#)a-6)A2"F"F Hi++38h#6%.]55CFl hsD!! FsA33BBhourscLeZdZdZdefdZedZdZdZ dZ dZ d S) ConstantTZInfoz A :class:`~datetime.tzinfo` subtype whose *offset* remains constant (no daylight savings). Args: name (str): Name of the timezone. offset (datetime.timedelta): Offset of the timezone. ConstantTZc"||_||_dSN)nameoffset)selfrrs r__init__zConstantTZInfo.__init__s  rc0t|jdz S)Nr()rrrs rutcoffset_hourszConstantTZInfo.utcoffset_hourssT[))W55rc|jSr)rrrs r utcoffsetzConstantTZInfo.utcoffsets {rc|jSr)rrs rtznamezConstantTZInfo.tznames yrctSr)ZEROrs rdstzConstantTZInfo.dsts rcD|jj}|d|jd|jdS)Nz(name=z , offset=)) __class____name__rr)rcns r__repr__zConstantTZInfo.__repr__s) ^ $+-22tyyy$+++FFrN) r __module__ __qualname____doc__rrpropertyrrrrrrrrrrs)66X6GGGGGrrUTCceZdZdZeej ZeZej reej ZdZ dZ dZ dZdZdS) LocalTZInfoaKThe ``LocalTZInfo`` type takes data available in the time module about the local timezone and makes a practical :class:`datetime.tzinfo` to represent the timezone settings of the operating system. For a more in-depth integration with the operating system, check out `tzlocal`_. It builds on `pytz`_ and implements heuristics for many versions of major operating systems to provide the official ``pytz`` tzinfo, instead of the LocalTZ generalization. .. _tzlocal: https://pypi.python.org/pypi/tzlocal .. _pytz: https://pypi.python.org/pypi/pytz r$c |j|j|j|j|j|j|ddf }tjtj |}|j dkS)Nr) r1r0r+r)r'r%weekdaytime localtimemktimetm_isdst)rrdt_tlocal_ts ris_dstzLocalTZInfo.is_dstsX2627BI 2::<<B0.T!2!233!##rcH||r|jS|jSr)r _dst_offset _std_offsetrs rrzLocalTZInfo.utcoffsets& ;;r?? $# #rcX||r|j|jz StSr)rrrrrs rrzLocalTZInfo.dsts* ;;r?? 7#d&66 6 rcLtj||Sr)rrrrs rrzLocalTZInfo.tznames{4;;r??++rc d|jjzS)Nz%s())rrrs rrzLocalTZInfo.__repr__s///rN)rrrrrrtimezonerrdaylightaltzonerrrrrrrrrrs  )T]N333KK }7i 666 $$$     ,,,00000rrc\d|z }|r|t|z }|S)N)rr)r days_to_gos r_first_sunday_on_or_afterrs3RZZ\\!J$ i ### Ir  c0eZdZdZdZdZdZdZdZdS) USTimeZonezCopied directly from the Python docs, the ``USTimeZone`` is a :class:`datetime.tzinfo` subtype used to create the :data:`Eastern`, :data:`Central`, :data:`Mountain`, and :data:`Pacific` tzinfo types. cZt||_||_||_||_dS)Nr)r stdoffsetreprnamestdnamedstname)rrrrrs rrzUSTimeZone.__init__s-"///    rc|jSr)rrs rrzUSTimeZone.__repr__s }rcH||r|jS|jSr)rrrrs rrzUSTimeZone.tznames$ 88B<< < < rc<|j||zSr)rrrs rrzUSTimeZone.utcoffset s~ ,,rc||jtS|j|usJd|jkrtt}}nOd|jcxkrdkrnnt t }}n+d|jcxkrdkrnntt}}ntSt| |j}t| |j}|| dcxkr|kr nntStS)Niiiii)r1)r) rrr1 DSTSTART_2007 DSTEND_2007DSTSTART_1987_2006DSTEND_1987_2006DSTSTART_1967_1986DSTEND_1967_1986rrzHOUR)rrdststartdstendr{ends rrzUSTimeZone.dst#s\    KyD     "'> ,kfHH BG    d     13CfHH BG    d     13CfHHK)(*:*:*:*H*HII'BG(D(DEE BJJdJ++    c     KKrN) rrrrrrrrrrrrrr si     ---rrEasternESTEDTiCentralCSTCDTiMountainMSTMDTiPacificPSTPDT)NrT)Nr)r#F)2rrerrOrtrrrrrrcompilerr"rQrP_FLOAT_PATTERNr=dictreversedr@rIparse_tdrKr`rerkrrrrr fromtimestamprutcfromtimestamprrLocalTZrrrrrrrrrrrrrrrrsB, 666666666666&6rz%  6 yy###X . yy$$$h / yy&&& / yya   % ( yya   & ) yyb!!!7 + yyc"""F +  - 7 6g 6 6 6''w''' >rz>OPP 4CC+38GCRCL+A+ACCCDD'"'"'"T ++++\1111@6V V V V xy||yqGGGGGVGGG>nU$h$Q,, 'h'** (0(0(0(0(0&(0(0(0V +--"Aq!$$ hq"a## XaAq))8Ar2q)) XaB**#44444444n *RUE 2 2 *RUE 2 2 :b*eU 3 3 *RUE 2 2r