fchTO SrSSKrSSKrSSKrSSKrSSKJrJrJrJrJ r \Rr Sr \R"S5r SrS\"SS9S 4S\"S S9S 4S\"S S9S 4S\"SS9S4S\"SS9S4S\"SS9S4S\"SS9S4/r\Vs/sHoSUS-USUS4PM snr\Vs/sHoSPM snrSr\R"S\-5r\"\SS5VVs0sHu pUSUS-_M snnrSr\rSrSASjrSBSjrSrSCS jr\"S5r\"SS!9r"S"S#\5r\"S$5r\R@"S\5r!"S%S&\5r"\""5r#S'r$\"SS(S)S5r%\"SS*SS5r&\"SS+SS5r'\"SS,S-S5r(\"SS+S.S5r)\(r*"S/S0\5r+\+"S1S2S3S45r,\+"S5S6S7S85r-\+"S9S:S;S<5r.\+"S=S>S?S@5r/gs snfs snfs snnf)DaPython'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 timedeltadatedatetimetimezonecUR(a U[- nO$UR[RS9[- n[ R "U5$)ueConverts 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 >>> timestamp = int(time.time()) >>> utc_dt = datetime.fromtimestamp(timestamp, timezone.utc) >>> timestamp - dt_to_timestamp(utc_dt) 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)r EPOCH_AWAREreplacerutcr total_seconds)dttds 1lib/python3.13/site-packages/boltons/timeutils.pydt_to_timestamprAs?, yy +  ZZx||Z ,{ :  " "2 &&z\Dcx[RU5Vs/sHn[U5PM nn[U6$s snf)aParses the limited subset of `ISO8601-formatted time`_ strings as returned by :meth:`datetime.datetime.isoformat`. >>> epoch_dt = datetime.fromtimestamp(0, timezone.utc).replace(tzinfo=None) >>> 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.now(timezone.utc).replace(tzinfo=None) >>> 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 ) _NONDIGIT_REsplitintr)iso_strpdt_argss risoparseras9. ,11':;:!s1v:G; W %s)\s*(?P\w)\w*)sc r0n[RU5H>nURS5URS5pC[Un[U5nX1U'M@ [S0UD6$![a& [ SU<S[R 5<35ef=f![ a [ SU<SU<35ef=f)a>Robustly 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 valueunitzinvalid time unit z, expected one of zinvalid time value for unit z: ) _PARSE_TD_REfinditergroup_PARSE_TD_KW_MAPKeyError ValueErrorkeysfloatr)text td_kwargsmatchr/r0unit_keys rparse_timedeltar>s2I&&t,kk'*EKK,?t @'-H .%LE$(-  !y !! @ $&6&;&;&=?@ @ @  . $e-. . .s A% B%0BB6cUS:XaU$US-$)Nrr-r1)r0r/s r_cardinalize_time_unitr@s z #:rcUc1[R"[R5R SS9nX- n[ R "U5n[U5n[R"[U5S- n[Uupn U[ R "U 5- n [X5n U(aU [U [U 554$X4$)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.now(timezone.utc).replace(tzinfo=None) >>> 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 r) rnowrr r rr absbisect _BOUND_DELTAS_BOUNDSroundr@) dotherndigits cardinalizediff diff_secondsabs_diffb_idxbboundbunitbnamef_diff rounded_diffs rdecimal_relative_timerUs@ } X\\*22$2? 9D**40L4yH MM- 2Q 6E"5>F5 I33E: :F)L3E3|;LMMM  rcX[XUSS9up4SnUS:aSn[U5SSUSU3$)aGet 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.now(timezone.utc).replace(tzinfo=None) >>> 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)rKagorzfrom nowg )rUrC)rHrIrJdrtr0phrases r relative_timer\sB2&aTJIC F Qw#hq\4&& **rcN[R"X5nUR5$)a)Parse 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 rstrpdaterbs .  v .F ;;=rc#.# [U[5(d [S5eU(a [U[5(d [S5eUupEn[U5[U5pT[U[5(a[ [U5S9nO$[U[5(aO[ SU-5eXTS-- nUcSnOTX::a(U(a[ RO[ RnO'U(a[ RO[ RnUnU"X5(d\Uv U(a>[URS - U-S5upURURU -U S -S 9nX-nU"X5(dM\g![a SSUpenGN,f=f7f) aTIn 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 Ncg)NFr1)rBstops rdaterange..rsUrr)r+r*) isinstancer TypeErrorrrr7operatorgtgeltledivmodr*r r+) startrfstep inclusivey_stepm_stepd_stepfinishedrBm_y_step cur_months r daterangerz*sqf eT " "?@@ JtT**FGG2!%Vc&k&#F , FI & & 8:>?@ @ rkF |* "+8;;"+8;; Cs!! "(#))a-6)A2"F H++388h#6%.]5Cl s!! ; ,!"At,s1AF E?D,F>F?FFFFhourscN\rSrSrSrS\4Sjr\S5rSr Sr Sr S r S r g ) ConstantTZInfoiz 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. ConstantTZcXlX lgNnameoffset)selfrrs r__init__ConstantTZInfo.__init__s   rcH[R"UR5S- $)Nr!)rr rrs rutcoffset_hoursConstantTZInfo.utcoffset_hourss&&t{{3w??rcUR$r)rrrs r utcoffsetConstantTZInfo.utcoffsets {{rcUR$r)rrs rtznameConstantTZInfo.tznames yyrc[$r)ZEROrs rdstConstantTZInfo.dsts rcpURRnUSUR<SUR<S3$)Nz(name=z , offset=)) __class____name__rr)rcns r__repr__ConstantTZInfo.__repr__s2 ^^ $ $VDII= $++BBrrN)r __module__ __qualname____firstlineno____doc__rrpropertyrrrrr__static_attributes__r1rrr~r~s>)@@Crr~UTCc\rSrSrSr\"\R*S9r\r \R(a\"\R*S9r Sr Sr SrSrSrS rg ) LocalTZInfoia#The ``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 rc URURURURURUR UR 5SS4 n[R"[R"U55nURS:$)Nr) r+r*r%r"r rweekdaytime localtimemktimetm_isdst)rrdt_tlocal_ts ris_dstLocalTZInfo.is_dstsc266277BII 2::<B0..T!23!##rc^URU5(a UR$UR$r)r _dst_offset _std_offsetrs rrLocalTZInfo.utcoffsets' ;;r??## #rclURU5(aURUR- $[$r)rrrrrs rrLocalTZInfo.dsts+ ;;r??##d&6&66 6 rcF[RURU5$r)rrrrs rrLocalTZInfo.tznames{{4;;r?++rc4SURR-$)Nz%s())rrrs rrLocalTZInfo.__repr__s////rr1N)rrrrrrrrrrdaylightaltzonerrrrrrr1rrrrsN T]]N3KK }} 6 $   ,0rrcVSUR5- nU(aU[U5- nU$)N)rr)r days_to_gos r_first_sunday_on_or_afterrs)RZZ\!J i ## Ir  c6\rSrSrSrSrSrSrSrSr Sr g ) USTimeZoneizCopied 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. cD[US9UlX lX0lX@lg)Nr{)r stdoffsetreprnamestdnamedstname)rr|rrrs rrUSTimeZone.__init__s"/   rcUR$r)rrs rrUSTimeZone.__repr__s }}rc^URU5(a UR$UR$r)rrrrs rrUSTimeZone.tzname s# 88B<<<< << rc>URURU5-$r)rrrs rrUSTimeZone.utcoffsets~~ ,,rcUb URc[$URULdeSUR:a [[p2OWSURs=:aS:aO O [ [ p2O1SURs=:aS:aO [$[[p2O[$[URURS95n[URURS95nXARSS9s=::a U:a[$ [$[$)Niiiii)r+r ) rrr+ DSTSTART_2007 DSTEND_2007DSTSTART_1987_2006DSTEND_1987_2006DSTSTART_1967_1986DSTEND_1967_1986rr HOUR)rrdststartdstendrqends rrUSTimeZone.dsts :* KyyD    "''>,kf BGG "d "13Cf BGG "d "K 23CfK)(*:*:*:*HI'BGG(DE JJdJ+ 1c 1K 2K4Kr)rrrrN) rrrrrrrrrrrr1rrrrs    -rrEasternESTEDTiCentralCSTCDTiMountainMSTMDTiPacificPSTPDT)NrT)Nr)rF)0rrerrDrkrrrrrr rcompilerrrFrE_FLOAT_PATTERNr2reversedr5r>parse_tdr@rUr\rbrzrrr~r fromtimestampr rLocalTZrrrrrrrrrrrr)b_r0s000rrs>, @@ '' ':zz% 6 y#X . y$h / y& / ya % ( ya & ) yb!7 + yc"F +  -/6 6gaD1Q4K1qt $g 6&'w!1w' >zz>OP +3GCRL+AC+AZQGTCZ'+AC'"T +\+@6V x|qCVC>U$$Q, (0&(0V -"Aq!$ q"a# aAq)Ar2q) aB*#44n RUE 2 RUE 2 b*eU 3 RUE 2g 7'CsG 'GG