iSrSSKrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r J r SSKJ r SSK Jr SS KJr SS KJrJrJrJrJrJrJrJrJrJrJrJrJr SS KJr SS K!J"r" SS K#J$r$J%r%J&r&J'r' SSK(J)r)J*r* SSK+J,r, \\ \-4r.\Sr/\Sr0\Sr1"SS5r2\2Rg\Rh5\2l4\2Rg\Rj5\2l5g)z_ Provides the :class:`Arrow ` class, an enhanced ``datetime`` replacement. Ndate)datetime)time) timedeltatimezonetzinfo)trunc) struct_time) AnyClassVarFinal GeneratorIterableListLiteralMappingOptionalTupleUnioncastoverload)tz) relativedelta) formatterlocalesparserutil)DEFAULT_LOCALEDEHUMANIZE_LOCALES)TimeFrameLiteral)yearyearsmonthmonthsdaydayshourhoursminuteminutessecondseconds microsecond microsecondsweekweeksquarterquarters)[)()z(]z[]) autor-r+r)r'r1r%r3r#c \rSrSr%Sr\R r\\\ S'\S\ S'\S\ S'/SQr \ \ \ \ S'\ VVs/sHoS3PM snnr\ \ \ \ S 'S r\ \\ S 'S r\ \\ S 'Sr\ \\ S'Sr\ \\ S'Sr\ \\ S'Sr\ \\ S'Sr\ \\ S'Sr\ \\ S'Sr\ \\ S'S\\\\\\\S.r\ \\\4\ S'\\ S'SS!\S"\S#\S$\S%\S&\S'\S(\\S)\S*S 4S+jjr \!SS(\\"S*S4S,jj5r#\!SS-j5r$\!SS.\%\\\ 4S(\\S*S4S/jj5r&\!S.\%\\\ 4S*S4S0j5r'\!SS1\S(\\S*S4S2jj5r(\!SS3\)S(\\S*S4S4jj5r*\!SS5\ S6\ S(\\S*S4S7jj5r+\!S8\S*S4S9j5r,\!SS:\-S;\%S\4S<\%S\S 4S=\\S>\\S*\.S?4 S@jj5r/SS:\-SB\SC\0SD\1SE\S*\2SF4 SGjjr3S:\-S)\S*S4SHjr4S:\-S)\S*S4SIjr5\!SS:\-S;\S<\S=\\S>\\SC\0SD\1S*\6\2SF4SJjj5r7\!SS:\-S;\S<\SK\S=\\SC\0SD\1S*\6\2SF4SLjj5r8S*\ 4SMjr9S*\ 4SNjr:SO\ S*\ 4SPjr;S*\4SQjrS*\"4STj5r?\>S*\4SUj5r@\>S*\4SVj5rAS*\4SWjrB\>S*\4SXj5rC\>S*\4SYj5rD\>S*\4SZj5rE\>S*\14S[j5rF\>S*\14S\j5rGSS]jrHS)\S*S4S^jrISS_\1S)\S*S4S`jjrJS=\S*S4SajrKSb\L4S6\ Sc\ S*\ 4SdjjrMS \LSASe4Sf\%S\S 4Sc\ Sg\1Sh\%\N\ \N4S*\ 4 SijjrOSSj\ Sc\ S*S4SkjjrPSS;SS\\S*\2\\44Sj5rs\oS3SS*\14Sj5rtSrug s snnf)ArrowNaAn :class:`Arrow ` object. Implements the ``datetime`` interface, behaving as an aware ``datetime`` while implementing additional functionality. :param year: the calendar year. :param month: the calendar month. :param day: the calendar day. :param hour: (optional) the hour. Defaults to 0. :param minute: (optional) the minute, Defaults to 0. :param second: (optional) the second, Defaults to 0. :param microsecond: (optional) the microsecond. Defaults to 0. :param tzinfo: (optional) A timezone expression. Defaults to UTC. :param fold: (optional) 0 or 1, used to disambiguate repeated wall times. Defaults to 0. .. _tz-expr: Recognized timezone expressions: - A ``tzinfo`` object. - A ``str`` describing a timezone, similar to 'US/Pacific', or 'Europe/Berlin'. - A ``str`` in ISO 8601 style, as in '+07:00'. - A ``str``, one of the following: 'local', 'utc', 'UTC'. Usage:: >>> import arrow >>> arrow.Arrow(2013, 5, 5, 12, 30, 45) resolutionminmax)r#r%r'r)r+r-r/_ATTRSs _ATTRS_PLURAL_MONTHS_PER_QUARTER _MONTHS_PER_YEAR<_SECS_PER_MINUTEi_SECS_PER_HOURiQ _SECS_PER_DAYi: _SECS_PER_WEEKgDA_SECS_PER_MONTHgP(^A_SECS_PER_QUARTERi3_SECS_PER_YEARg?)r-r+r)r'r1r%r3r# _SECS_MAP _datetimeNr#r%r'r)r+r-r/r kwargsreturnc Uc[RnO[U[5(a][ US5(aL[ US5(a;UR (a*[ RRUR 5nO4[U[5(a[ RRU5nU RSS5n [XX4XVXxU S9 Ul g)NlocalizezonefoldrrT) rutc isinstance dt_tzinfohasattrrSr TzinfoParserparsestrget dt_datetimerN) selfr#r%r'r)r+r-r/r rOrTs H/home/mande/repo/quber/.venv/lib/python3.13/site-packages/arrow/arrow.py__init__Arrow.__init__s >\\F vy ) ) ++'' ((..v{{;F  $ $((..v6Fzz&!$$ FKd c`Uc-[R"5R5Rn[R"U5nU"URUR UR URURURURUR[USS5S9 $)aConstructs an :class:`Arrow ` object, representing "now" in the given timezone. :param tzinfo: (optional) a ``tzinfo`` object. Defaults to local time. Usage:: >>> arrow.now('Asia/Baku') rTrrU) r^now astimezoner r#r%r'r)r+r-r/getattr)clsr dts r`re Arrow.nows > __&113::F __V $ GG HH FF GG II II NN IIVQ'  rcc[R"[R5nU"URUR UR URURURURUR[USS5S9 $)zConstructs an :class:`Arrow ` object, representing "now" in UTC time. Usage:: >>> arrow.utcnow() rTrrU) r^rerrVr#r%r'r)r+r-r/r rg)rhris r`utcnow Arrow.utcnowsg__X\\ * GG HH FF GG II II NN IIVQ'  rc timestampc^Uc.[R"5R5RnO4[ U[ 5(a[ RRU5n[R"U5(d[SU<S35e[R"[U55n[R"X5nU"URUR UR"UR$UR&UR(UR*UR[-USS5S9 $)aConstructs an :class:`Arrow ` object from a timestamp, converted to the given timezone. :param timestamp: an ``int`` or ``float`` timestamp, or a ``str`` that converts to either. :param tzinfo: (optional) a ``tzinfo`` object. Defaults to local time. The provided timestamp is invalid.rTrrU)r^rerfr rWr\rrZr[r is_timestamp ValueErrornormalize_timestampfloat fromtimestampr#r%r'r)r+r-r/rg)rhrnr ris r`rvArrow.fromtimestamps > __&113::F  $ $((..v6F  ++6ym<PQ Q,,U9-=>  & &y 9 GG HH FF GG II II NN IIVQ'  rcc[R"U5(d[SU<S35e[R"[ U55n[ R "U[R5nU"URURURURURURUR[R[!USS5S9 $)zConstructs an :class:`Arrow ` object from a timestamp, in UTC time. :param timestamp: an ``int`` or ``float`` timestamp, or a ``str`` that converts to either. rprqrTrrU)rrrrsrtrur^rvrrVr#r%r'r)r+r-r/rg)rhrnris r`utcfromtimestampArrow.utcfromtimestamps  ++6ym<PQ Q,,U9-=>  & &y(,, ? GG HH FF GG II II NN LLVQ'  rcricUc*URc[RnO URnU"URURUR UR URURURU[USS5S9 $)aConstructs an :class:`Arrow ` object from a ``datetime`` and optional replacement timezone. :param dt: the ``datetime`` :param tzinfo: (optional) A :ref:`timezone expression `. Defaults to ``dt``'s timezone, or UTC if naive. Usage:: >>> dt datetime.datetime(2021, 4, 7, 13, 48, tzinfo=tzfile('/usr/share/zoneinfo/US/Pacific')) >>> arrow.Arrow.fromdatetime(dt) rTrrU) r rrVr#r%r'r)r+r-r/rg)rhrir s r` fromdatetimeArrow.fromdatetime-sr$ >yy ! GG HH FF GG II II NN VQ'  rcrcvUc[RnU"URURURUS9$)zConstructs an :class:`Arrow ` object from a ``date`` and optional replacement timezone. All time values are set to 0. :param date: the ``date`` :param tzinfo: (optional) A :ref:`timezone expression `. Defaults to UTC. r )rrVr#r%r')rhrr s r`fromdateArrow.fromdateQs/ >\\F499djj$((6BBrcdate_strfmtc [R"X5nUc URnU"URURUR UR URURURU[USS5S9 $)a"Constructs an :class:`Arrow ` object from a date string and format, in the style of ``datetime.strptime``. Optionally replaces the parsed timezone. :param date_str: the date string. :param fmt: the format string using datetime format codes. :param tzinfo: (optional) A :ref:`timezone expression `. Defaults to the parsed timezone if ``fmt`` contains a timezone directive, otherwise UTC. Usage:: >>> arrow.Arrow.strptime('20-01-2019 15:49:10', '%d-%m-%Y %H:%M:%S') rTrrU) r^strptimer r#r%r'r)r+r-r/rg)rhrrr ris r`rArrow.strptime`so& ! !( 0 >YYF GG HH FF GG II II NN VQ'  rcordinalc,[R"U5 [R"U5nU"URUR UR URURURURUR[USS5S9 $)zConstructs an :class:`Arrow ` object corresponding to the Gregorian Ordinal. :param ordinal: an ``int`` corresponding to a Gregorian Ordinal. Usage:: >>> arrow.fromordinal(737741) rTrrU) rvalidate_ordinalr^ fromordinalr#r%r'r)r+r-r/r rg)rhrris r`rArrow.fromordinalss g&  $ $W - GG HH FF GG II II NN IIVQ'  rcframestartendrlimit)r9NNc## URU5upgnURUc UROU5n URU5R U S9nUR X55up5URU5R U S9nUR U5n URn Sn Sn X::aX:aU S- n U v URVs/sHn[X5PM nnU"USU 06R"S SS0Xx0D6n US ;aU RU :aSn U (a%URU 5(dU R U S 9n X::aX:aMggggs snf7f) aReturns an iterator of :class:`Arrow ` objects, representing points in time between two inputs. :param frame: The timeframe. Can be any ``datetime`` property (day, hour, minute...). :param start: A datetime expression, the start of the range. :param end: (optional) A datetime expression, the end of the range. :param tz: (optional) A :ref:`timezone expression `. Defaults to ``start``'s timezone, or UTC if ``start`` is naive. :param limit: (optional) A maximum number of tuples to return. **NOTE**: The ``end`` or ``limit`` must be provided. Call with ``end`` alone to return the entire range. Call with ``limit`` alone to return a maximum # of results from the start. Call with both to cap a range at a maximum # of results. **NOTE**: ``tz`` internally **replaces** the timezones of both ``start`` and ``end`` before iterating. As such, either call with naive objects and ``tz``, or aware objects from the same timezone and no ``tz``. Supported frame values: year, quarter, month, week, day, hour, minute, second, microsecond. Recognized datetime expressions: - An :class:`Arrow ` object. - A ``datetime`` object. Usage:: >>> start = datetime(2013, 5, 5, 12, 30) >>> end = datetime(2013, 5, 5, 17, 15) >>> for r in arrow.Arrow.range('hour', start, end): ... print(repr(r)) ... **NOTE**: Unlike Python's ``range``, ``end`` *may* be included in the returned iterator:: >>> start = datetime(2013, 5, 5, 12, 30) >>> end = datetime(2013, 5, 5, 13, 30) >>> for r in arrow.Arrow.range('hour', start, end): ... print(repr(r)) ... Nr Frr check_imaginaryT)r%r3r#)r') _get_frames _get_tzinfor _get_datetimereplace_get_iteration_paramsr|r'r>rgshift_is_last_day_of_month)rhrrrrr_frame_relativerelative_stepsr current original_dayday_is_clippedifvaluess r`range Arrow.rangesYv-0OOE,B)>D!!%(000?..s: $,,F,;""5)yy  n FAM36::>:agg):F>61&177 $)7(HG44|9S!%c&?&?&H&H!//l/;nnn?sCEEA+E EFcountboundsexact week_start)r9r9c\[R"U5 URU5upgnUS:XaSUs=::aS::d O [S5eSn O US:XaSn OUn Un U(dURR U 5n URSU S-n U V s/sHn [ X 5PM nn [S [U5- 5HnURS5 M UR"US UR06n US:Xa<XPR5:aSOS nU RUR5U- *U- S 9n O&US:Xa U RURS- S -*S 9n U R"SSS0XrU-0D6nUS S:XaU RSS9n USS:XaURSS9nU U4$s sn f)anReturns a tuple of two new :class:`Arrow ` objects, representing the timespan of the :class:`Arrow ` object in a given timeframe. :param frame: the timeframe. Can be any ``datetime`` property (day, hour, minute...). :param count: (optional) the number of frames to span. :param bounds: (optional) a ``str`` of either '()', '(]', '[)', or '[]' that specifies whether to include or exclude the start and end values in the span. '(' excludes the start, '[' includes the start, ')' excludes the end, and ']' includes the end. If the bounds are not specified, the default bound '[)' is used. :param exact: (optional) whether to have the start of the timespan begin exactly at the time specified by ``start`` and the end of the timespan truncated so as not to extend beyond ``end``. :param week_start: (optional) only used in combination with the week timeframe. Follows isoweekday() where Monday is 1 and Sunday is 7. Supported frame values: year, quarter, month, week, day, hour, minute, second. Usage:: >>> arrow.utcnow() >>> arrow.utcnow().span('hour') (, ) >>> arrow.utcnow().span('day') (, ) >>> arrow.utcnow().span('day', count=2) (, ) >>> arrow.utcnow().span('day', bounds='[]') (, ) >>> arrow.utcnow().span('week') (, ) >>> arrow.utcnow().span('week', week_start=6) (, ) r1rz,week_start argument must be between 1 and 7.r'r3r%NrAr r)r()r&rT(r0)r)rvalidate_boundsrrsr>indexrgrlenappend __class__r isoweekdayrr%)r_rrrrrframe_absoluterrattrfloorrframesrrrdeltaceils r`span Arrow.spansd V$9=9I9I%9P6 V # 'a' !OPPD y (D!DKK%%d+E[[519-F0671gd&F71s6{?+ a ,NNF?4;;?E''//*;; 4??+` object, representing the "floor" of the timespan of the :class:`Arrow ` object in a given timeframe. Equivalent to the first element in the 2-tuple returned by :func:`span `. :param frame: the timeframe. Can be any ``datetime`` property (day, hour, minute...). :param week_start: (optional) only used in combination with the week timeframe. Follows isoweekday() where Monday is 1 and Sunday is 7. Usage:: >>> arrow.utcnow().floor('hour') >>> arrow.utcnow().floor('week', week_start=7) rrr_rrOs r`r Arrow.floorV(yy)&)!,,rcc .UR"U40UD6S$)aReturns a new :class:`Arrow ` object, representing the "ceiling" of the timespan of the :class:`Arrow ` object in a given timeframe. Equivalent to the second element in the 2-tuple returned by :func:`span `. :param frame: the timeframe. Can be any ``datetime`` property (day, hour, minute...). :param week_start: (optional) only used in combination with the week timeframe. Follows isoweekday() where Monday is 1 and Sunday is 7. Usage:: >>> arrow.utcnow().ceil('hour') >>> arrow.utcnow().ceil('week', week_start=7) rrrs r`r Arrow.ceillrrcc## URUc UROU5nURX(5RXS9SnURX85nUR XX4U5n U(dU Hn U RXUS9v M U HOn U RXUS9upX:aUn USS:Xa U [ SS9- n X:Xa gU [ SS9-U:Xa gX4v MQ g7f) a Returns an iterator of tuples, each :class:`Arrow ` objects, representing a series of timespans between two inputs. :param frame: The timeframe. Can be any ``datetime`` property (day, hour, minute...). :param start: A datetime expression, the start of the range. :param end: (optional) A datetime expression, the end of the range. :param tz: (optional) A :ref:`timezone expression `. Defaults to ``start``'s timezone, or UTC if ``start`` is naive. :param limit: (optional) A maximum number of tuples to return. :param bounds: (optional) a ``str`` of either '()', '(]', '[)', or '[]' that specifies whether to include or exclude the start and end values in each span in the range. '(' excludes the start, '[' includes the start, ')' excludes the end, and ']' includes the end. If the bounds are not specified, the default bound '[)' is used. :param exact: (optional) whether to have the first timespan start exactly at the time specified by ``start`` and the final span truncated so as not to extend beyond ``end``. **NOTE**: The ``end`` or ``limit`` must be provided. Call with ``end`` alone to return the entire range. Call with ``limit`` alone to return a maximum # of results from the start. Call with both to cap a range at a maximum # of results. **NOTE**: ``tz`` internally **replaces** the timezones of both ``start`` and ``end`` before iterating. As such, either call with naive objects and ``tz``, or aware objects from the same timezone and no ``tz``. Supported frame values: year, quarter, month, week, day, hour, minute, second, microsecond. Recognized datetime expressions: - An :class:`Arrow ` object. - A ``datetime`` object. **NOTE**: Unlike Python's ``range``, ``end`` will *always* be included in the returned iterator of timespans. Usage: >>> start = datetime(2013, 5, 5, 12, 30) >>> end = datetime(2013, 5, 5, 17, 15) >>> for r in arrow.Arrow.span_range('hour', start, end): ... print(r) ... (, ) (, ) (, ) (, ) (, ) (, ) N)rrrrrrrr)rr r|rrr) rhrrrrrrrr _rangerrrs r` span_rangeArrow.span_ranges|D  /44U4HKs+5%8ffUf??A&&U&CKEz!9#Mr::D|B773>+ sCC intervalc ## US:a [S5e[URXX5XgS95n[U5up[ US- 5Hn [U5upM X4v M8![ a M)f=f![ a gf=f7f)anReturns an iterator of tuples, each :class:`Arrow ` objects, representing a series of intervals between two inputs. :param frame: The timeframe. Can be any ``datetime`` property (day, hour, minute...). :param start: A datetime expression, the start of the range. :param end: (optional) A datetime expression, the end of the range. :param interval: (optional) Time interval for the given time frame. :param tz: (optional) A timezone expression. Defaults to UTC. :param bounds: (optional) a ``str`` of either '()', '(]', '[)', or '[]' that specifies whether to include or exclude the start and end values in the intervals. '(' excludes the start, '[' includes the start, ')' excludes the end, and ']' includes the end. If the bounds are not specified, the default bound '[)' is used. :param exact: (optional) whether to have the first timespan start exactly at the time specified by ``start`` and the final interval truncated so as not to extend beyond ``end``. Supported frame values: year, quarter, month, week, day, hour, minute, second Recognized datetime expressions: - An :class:`Arrow ` object. - A ``datetime`` object. Recognized timezone expressions: - A ``tzinfo`` object. - A ``str`` describing a timezone, similar to 'US/Pacific', or 'Europe/Berlin'. - A ``str`` in ISO 8601 style, as in '+07:00'. - A ``str``, one of the following: 'local', 'utc', 'UTC'. Usage: >>> start = datetime(2013, 5, 5, 12, 30) >>> end = datetime(2013, 5, 5, 17, 15) >>> for r in arrow.Arrow.interval('hour', start, end, 2): ... print(r) ... (, ) (, ) (, ) rz%interval has to be a positive integerrN)rsiterrnextr StopIteration) rhrrrrrrr spanRange intvlStartintvlEndrs r`rArrow.intervalsh a<DE E NN5N M  '+I$ x!|,A!&*9o 8- !** )! !!  sL-BA8 A' A8%B' A51A84A55A88 BBBBcXSURRSUR5S3$)N)r__name____str__r_s r`__repr__Arrow.__repr__s)4>>**+2dlln-=R@@rcc6URR5$NrN isoformatrs r`r Arrow.__str__s~~''))rc formatstrcX[U5S:aURU5$[U5$)Nr)rformatr\)r_rs r` __format__Arrow.__format__"s' y>A ;;y) )4yrcc6URR5$r)rN__hash__rs r`rArrow.__hash__(s~~&&((rcnamec:US:XaUR5S$US:Xa([URS- UR- 5S-$UR S5(d[ UR US5nUbU$[[[RX55$)Nr1rr3r) isocalendarintr%rB startswithrgrNrobject__getattribute__)r_rvalues r` __getattr__Arrow.__getattr__-s 6>##%a( ( 9  Q$*B*BBCaG Gs###*4>>4#FE  C00<==rccJ[[URR5$)zGets the ``tzinfo`` of the :class:`Arrow ` object. Usage:: >>> arw=arrow.utcnow() >>> arw.tzinfo tzutc() )rrXrNr rs r`r Arrow.tzinfo<sIt~~4455rccUR$)zReturns a datetime representation of the :class:`Arrow ` object. Usage:: >>> arw=arrow.utcnow() >>> arw.datetime datetime.datetime(2019, 1, 24, 16, 35, 27, 276649, tzinfo=tzutc()) rNrs r`rArrow.datetimeKs~~rcc4URRSS9$)aReturns a naive datetime representation of the :class:`Arrow ` object. Usage:: >>> nairobi = arrow.now('Africa/Nairobi') >>> nairobi >>> nairobi.naive datetime.datetime(2019, 1, 23, 19, 27, 12, 297999) Nr )rNrrs r`naive Arrow.naiveYs~~%%T%22rcc6URR5$)zReturns a timestamp representation of the :class:`Arrow ` object, in UTC time. Usage:: >>> arrow.utcnow().timestamp() 1616882340.256501 )rNrnrs r`rnArrow.timestampj~~''))rcc4[UR55$)zReturns an integer timestamp representation of the :class:`Arrow ` object, in UTC time. Usage:: >>> arrow.utcnow().int_timestamp 1548260567 )rrnrs r` int_timestampArrow.int_timestampws4>>#$$rcc"UR5$)zReturns a floating-point timestamp representation of the :class:`Arrow ` object, in UTC time. Usage:: >>> arrow.utcnow().float_timestamp 1548260516.830896 )rnrs r`float_timestampArrow.float_timestamps~~rcc.URR$)zLReturns the ``fold`` value of the :class:`Arrow ` object.)rNrTrs r`rT Arrow.folds~~"""rccB[R"UR5$)zrIndicates whether the :class:`Arrow ` object is a repeated wall time in the current timezone. ) dateutil_tzdatetime_ambiguousrNrs r` ambiguousArrow.ambiguouss--dnn==rccL[R"UR5(+$)z`Indicates whether the :class: `Arrow ` object exists in the current timezone.)rdatetime_existsrNrs r` imaginaryArrow.imaginarys..t~~>>>rcc8URUR5$)zReturns a new :class:`Arrow ` object, cloned from the current one. Usage: >>> arw = arrow.utcnow() >>> cloned = arw.clone() )r|rNrs r`clone Arrow.clones  00rcc 0nUR5HEup4X0R;aXBU'MUS;a[SUS35eUS;dM7[SU<S35e URR"S 0UD6nUR S5nUb UR U5nUR US9nUR S 5nUbUR US 9nURU5$) aReturns a new :class:`Arrow ` object with attributes updated according to inputs. Use property names to set their value absolutely:: >>> import arrow >>> arw = arrow.utcnow() >>> arw >>> arw.replace(year=2014, month=6) You can also replace the timezone without conversion, using a :ref:`timezone expression `:: >>> arw.replace(tzinfo=tz.tzlocal()) )r1r3zSetting absolute z is not supported.)r rTzUnknown attribute: .r r rTrUr)itemsr>rsrNrr]rr|)r_rOabsolute_kwargskeyrrr rTs r`r Arrow.replaces* ,,.JCkk!',$++ #4SE9K!LMM.. #6sgQ!?@@ )..((;?;H%  %%f-FooVo4Gzz&!  oo4o0G  ))rcrc 0n/SQnUR5HJupVXPR;dXT;aXcU'MSRURU-5n[SUS35e UR SS5 US==UR SS5UR -- ss'UR[S0UD6-nU(a1[R"U5(d[R"U5nURU5$) a Returns a new :class:`Arrow ` object with attributes updated according to inputs. Parameters: check_imaginary (bool): If True (default), will check for and resolve imaginary times (like during DST transitions). If False, skips this check. Use pluralized property names to relatively shift their current value: >>> import arrow >>> arw = arrow.utcnow() >>> arw >>> arw.shift(years=1, months=-1) Day-of-the-week relative shifting can use either Python's weekday numbers (Monday = 0, Tuesday = 1 .. Sunday = 6) or using dateutil.relativedelta's day instances (MO, TU .. SU). When using weekday numbers, the returned date will always be greater than or equal to the starting date. Using the above code (which is a Saturday) and asking it to shift to Saturday: >>> arw.shift(weekday=5) While asking for a Monday: >>> arw.shift(weekday=0) )r2r4weekday, z>Invalid shift time frame. Please select one of the following: rr&rr4r) rr@joinrs setdefaultpoprBrNrrr resolve_imaginaryr|) r_rrOrelative_kwargsadditional_attrsrrsupported_attrrs r`r Arrow.shiftsF; ,,.JC(((C,C',$!%4+=+=@P+P!Q TUcTddef ) ""8Q/!    A .1I1I I !..=#C?#CC ;#>#>w#G#G!33G` object, converted to the target timezone. :param tz: A :ref:`timezone expression `. Usage:: >>> utc = arrow.utcnow() >>> utc >>> utc.to('US/Pacific') >>> utc.to(tz.tzlocal()) >>> utc.to('-07:00') >>> utc.to('local') >>> utc.to('local').to('utc') rTrrU)rWrXrrZr[rNrfrr#r%r'r)r+r-r/r rg)r_rris r`toArrow.to!s:"i(($$**2.B ^^ & &r *~~ GG HH FF GG II II NN IIVQ'  rczYYYY-MM-DD HH:mm:ssZZlocalecb[R"U5RURU5$)a%Returns a string representation of the :class:`Arrow ` object, formatted according to the provided format string. For a list of formatting values, see :ref:`supported-tokens` :param fmt: the format string. :param locale: the locale to format. Usage:: >>> arrow.utcnow().format('YYYY-MM-DD HH:mm:ss ZZ') '2013-05-09 03:56:47 -00:00' >>> arrow.utcnow().format('X') '1368071882' >>> arrow.utcnow().format('MMMM DD, YYYY') 'May 09, 2013' >>> arrow.utcnow().format() '2013-05-09 03:56:47 -00:00' )rDateTimeFormatterrrN)r_rr$s r`r Arrow.formatQs&4**6299$..#NNrcr7other only_distance granularityc ^^^^Un[R"U5nUce[R"[R 5R [R S9nURTRR5nO[U[5(a URnO[U[5(aWURc$UR TRRS9nOIURTRR5nO#[S[U5R<S35e[T[5(a[!T5S:XaTSm[#[%TRU- R'555nUS:aSOSm[)U5=pTS:XGaU S :aUR+S US 9$U TR,:aTU -n UR+S XS 9$U TR,S -:aUR+STUS 9$U TR.:a,T[1U TR,-S 5-n UR+SXS 9$U TR.S -:aUR+STUS 9$U TR2:a,T[1U TR.-S 5-n UR+SXS 9$TRU:a[5UTR5O[5TRU5nUR6TR8-UR:-nUR<S:aUS- n[?UTR85nU TR2S -:aUR+STUS 9$U TR@:a-T[1U TR2-S 5-nUR+SUUS 9$US:a=U TRB:a-US:XaUR+STUS 9$TU-nUR+SUUS 9$U TR@S -:aUR+STUS 9$U TRD:a-T[1U TR@-S 5-nUR+SUUS 9$U TRBS -:aUR+STUS 9$T[1U TRB-S 5-nUR+SUUS 9$[T[F5(Ga,[I[JT5mTS:Xa.T[MU 5-n[)U5S :aUR+S US 9$OTS:XaTU -TR,- nOTS:XaTU -TR.- nOTS:XaTU -TR2- nOoTS:XaTU -TR@- nOVTS:XaTU -TRD- nO=TS:XaTU -TRN- nO$TS:XaTU -TRB- nO [QS5e[S[)U55S:waTS- mUR+TUUS 9$T(d [QS5e/mS [LS![JS"[L4UUUU4S#jjn[MU 5nS$nUH nU"UU5nM [!T5[!T5:a [QS5eURUTUS 9$![Van[QS%US&U<S'35eSnAff=f)(aQReturns a localized, humanized representation of a relative difference in time. :param other: (optional) an :class:`Arrow ` or ``datetime`` object. Defaults to now in the current :class:`Arrow ` object's timezone. :param locale: (optional) a ``str`` specifying a locale. Defaults to 'en-us'. :param only_distance: (optional) returns only time difference eg: "11 seconds" without "in" or "ago" part. :param granularity: (optional) defines the precision of the output. Set it to strings 'second', 'minute', 'hour', 'day', 'week', 'month' or 'year' or a list of any combination of these strings Usage:: >>> earlier = arrow.utcnow().shift(hours=-2) >>> earlier.humanize() '2 hours ago' >>> later = earlier.shift(hours=4) >>> later.humanize(earlier) 'in 4 hours' Nr z!Invalid 'other' argument of type z4. Argument must be of type None, Arrow, or datetime.rrrr7 re)r)r.r+r,r)r*r'r(r%r&r1r2r#r$r-r3z|Invalid level of granularity. Please select between 'second', 'minute', 'hour', 'day', 'week', 'month', 'quarter' or 'year'.r?zEmpty granularity list provided. Please select one or more from 'second', 'minute', 'hour', 'day', 'week', 'month', 'quarter', 'year'._delta_framerPc>UT;awTU-TRU- nUTRU-n[[U55S:wa&TR[ [ US-5U45 U$TRX45 U$)Nrr?)rMr absrrr")r/r0rr*r_sign timeframess r`gather_timeframes)Arrow.humanize..gather_timeframess, $v v0F F$.."88 U,1&--!%&6 !Eu M "M'--vo>!Mrc)r#r3r%r1r'r)r+r-zHumanization of the z0 granularity is not currently translated in the z> locale. Please consider making a contribution to this locale.),r get_localer^rerrVrrfrNr rWr9 TypeErrortyperlistrrround total_secondsr2describerFrGr=rHrr$rDr&r(r<rIrLrJr\rr"rurKrsr describe_multiKeyError)r_r(r$r)r* locale_namerVrir/ delta_seconddiffr.r,r* calendar_diffcalendar_monthsr(r&r2r$rr5rrer3r4s` ` @@r`humanizeArrow.humanizems8 ##F+ =//(,,/77x||7LC 5 56B u % %B { + +||#]]$..*?*?]@%%dnn&;&;<3DK4H4H3KLEE  k4 ( (S-=-B%a.KUDNNR/>>@ABaZrQ!&k) X f$"9!??5 ?NN$///"\1G!??!7+D11A55!??8T?WWD///"S9N9N)NPQ%RRG!??!7+D//!33!??64}?UUD... 3|t7J7J'JA#NNE!??7E?WW~~*""dnn5&t~~r: "''$*?*??-BVBVV !%%*#q(O"%ot7L7L"M$,,q00!??5$m?TTD///#ld6H6H&H!"LLD!??64}?UU$)dT5H5H.H&!+%#T / "&!7%$fM / D//!33!??64}?UUD000 3|t7J7J'JA#NNE!??7E?WWD//!33!??64}?UU!3|t7J7J'JA#NNE!??7E?WWK--"#3[A (* 5#66E5zA~%uMRR& H, </$2G2GGE F* </$2E2EEE E) </$2D2DDE F* </$2E2EEE G+ </$2F2FFE I- </$2H2HHE F* </$2E2EEE$y U$)3&K{EWW#$@ DF  "e "=M "RW " "l+ 8$E-eU;E$z?S%55$y ,,Z},UU &qc)YZeYhiHH  s|%Y$Y'#Y ;Y#Y+;Y'B0Y` object, that represents the time difference relative to the attributes of the :class:`Arrow ` object. :param timestring: a ``str`` representing a humanized relative time. :param locale: (optional) a ``str`` specifying a locale. Defaults to 'en-us'. Usage:: >>> arw = arrow.utcnow() >>> arw >>> earlier = arw.dehumanize("2 days ago") >>> earlier >>> arw = arrow.utcnow() >>> arw >>> later = arw.dehumanize("in a month") >>> later r-z*Dehumanize does not currently support the zN locale, please consider making a contribution to add support for this locale.)r.r,r*r(r2r&r$r)rer.r,r*r(r2r&r$Fz\d+z (^|\b|\d)rreTrr?zInput string not valid. Note: Some locales do not support the week granularity in Arrow. If you are attempting to use the week granularity on an unsupported locale, this could be the cause of this error.z.*^$zInvalid input String. String does not contain any relative time information. String should either represent a time in the future or a time in the past. Ex: 'in 5 seconds' or '5 seconds ago'.rr)rr7lowerrr!rsr|rNdictfromkeysrecompiler4rrWrr\rsearchgroup isnumericr2ranyfuturefindallpastr)r_rHr$ locale_objnormalized_locale_name current_timetime_object_info unit_visited num_patternunit unit_objectstrings_to_search time_delta time_string search_stringpatternmatch match_string num_match change_valuetime_unit_to_changekv future_stringfuture_patternfuture_pattern_match past_string past_patternpast_pattern_matchsign_val time_changess r` dehumanizeArrow.dehumanize@sK6''/ "(!7!7S!A !); ; D+w//$/!%)3{+;$<! ,=+B+B+D' #K 0 - 4 4V < ** -%AB|4${{} '..|< !!+!5!5!7!7SZ=Q!$'y'8#9L5=)-L&'*$i## 34R8C?Cb#9E !4548 01I,E"?b\%7%7%9?%9TQQD%9?@@E  #)) %,,T2 qq$9:-55lC oo !((. zzQ{m1"56 )11,? H !H % H9  5E4J4J4LM4LDAq8a<4L M!!G$G,GGE@@Ns"M 4M !Mc[R"U5 [U[5(d[ S[ U5<S35e[U[5(d[ S[ U5<S35eUSS:HnUSS:HnUR nUR nUR nXvs=:*=(a U:*Os =(a! U=(d Xv:=(a U=(d Xh:$)afReturns a boolean denoting whether the :class:`Arrow ` object is between the start and end limits. :param start: an :class:`Arrow ` object. :param end: an :class:`Arrow ` object. :param bounds: (optional) a ``str`` of either '()', '(]', '[)', or '[]' that specifies whether to include or exclude the start and end values in the range. '(' excludes the start, '[' includes the start, ')' excludes the end, and ']' includes the end. If the bounds are not specified, the default bound '()' is used. Usage:: >>> start = arrow.get(datetime(2013, 5, 5, 12, 30, 10)) >>> end = arrow.get(datetime(2013, 5, 5, 12, 30, 36)) >>> arrow.get(datetime(2013, 5, 5, 12, 30, 27)).is_between(start, end) True >>> start = arrow.get(datetime(2013, 5, 5)) >>> end = arrow.get(datetime(2013, 5, 8)) >>> arrow.get(datetime(2013, 5, 8)).is_between(start, end, '[]') True >>> start = arrow.get(datetime(2013, 5, 5)) >>> end = arrow.get(datetime(2013, 5, 8)) >>> arrow.get(datetime(2013, 5, 8)).is_between(start, end, '[)') False z)Cannot parse start date argument type of rz'Cannot parse end date argument type of r[r])rrrWr9r8r9r) r_rrr include_start include_end target_tsstart_tsend_tss r` is_betweenArrow.is_betweensF V$%'';DK?!L #u%%Ed5k_TUVW Wq S( Qi3& (( (($$ , ,f , 46("6 42 2 rcc6URR5$)zReturns a ``date`` object with the same year, month and day. Usage:: >>> arrow.utcnow().date() datetime.date(2019, 1, 23) )rNrrs r`r Arrow.date ~~""$$rcc6URR5$)zReturns a ``time`` object with the same hour, minute, second, microsecond. Usage:: >>> arrow.utcnow().time() datetime.time(12, 15, 34, 68352) )rNrrs r`r Arrow.timerrcc6URR5$)zReturns a ``time`` object with the same hour, minute, second, microsecond and tzinfo. Usage:: >>> arrow.utcnow().timetz() datetime.time(12, 5, 18, 298893, tzinfo=tzutc()) )rNtimetzrs r`r Arrow.timetz!s~~$$&&rcc8URRU5$)aWReturns a ``datetime`` object, converted to the specified timezone. :param tz: a ``tzinfo`` object. Usage:: >>> pacific=arrow.now('US/Pacific') >>> nyc=arrow.now('America/New_York').tzinfo >>> pacific.astimezone(nyc) datetime.datetime(2019, 1, 20, 10, 24, 22, 328172, tzinfo=tzfile('/usr/share/zoneinfo/America/New_York')) )rNrf)r_rs r`rfArrow.astimezone.s~~((,,rcc6URR5$)zReturns a ``timedelta`` object representing the whole number of minutes difference from UTC time. Usage:: >>> arrow.now('US/Pacific').utcoffset() datetime.timedelta(-1, 57600) )rN utcoffsetrs r`rArrow.utcoffset>rrcc6URR5$)zpReturns the daylight savings time adjustment. Usage:: >>> arrow.utcnow().dst() datetime.timedelta(0) )rNdstrs r`r Arrow.dstKs~~!!##rcc6URR5$)zReturns a ``time.struct_time``, in the current timezone. Usage:: >>> arrow.utcnow().timetuple() time.struct_time(tm_year=2019, tm_mon=1, tm_mday=20, tm_hour=15, tm_min=17, tm_sec=8, tm_wday=6, tm_yday=20, tm_isdst=0) )rN timetuplers r`rArrow.timetupleW~~''))rcc6URR5$)zReturns a ``time.struct_time``, in UTC time. Usage:: >>> arrow.utcnow().utctimetuple() time.struct_time(tm_year=2019, tm_mon=1, tm_mday=19, tm_hour=21, tm_min=41, tm_sec=7, tm_wday=5, tm_yday=19, tm_isdst=0) )rN utctimetuplers r`rArrow.utctimetuplecs~~**,,rcc6URR5$)znReturns the proleptic Gregorian ordinal of the date. Usage:: >>> arrow.utcnow().toordinal() 737078 )rN toordinalrs r`rArrow.toordinalorrcc6URR5$)zcReturns the day of the week as an integer (0-6). Usage:: >>> arrow.utcnow().weekday() 5 )rNrrs r`r Arrow.weekday{s~~%%''rcc6URR5$)zjReturns the ISO day of the week as an integer (1-7). Usage:: >>> arrow.utcnow().isoweekday() 6 )rNrrs r`rArrow.isoweekdays~~((**rcc6URR5$)z~Returns a 3-tuple, (ISO year, ISO week number, ISO weekday). Usage:: >>> arrow.utcnow().isocalendar() (2019, 3, 6) )rNrrs r`rArrow.isocalendars~~))++rcseptimespecc8URRX5$)zReturns an ISO 8601 formatted representation of the date and time. Usage:: >>> arrow.utcnow().isoformat() '2019-01-19T18:30:52.442118+00:00' r)r_rrs r`rArrow.isoformats~~''66rcc6URR5$)zReturns a ctime formatted representation of the date and time. Usage:: >>> arrow.utcnow().ctime() 'Sat Jan 19 18:26:50 2019' )rNctimers r`r Arrow.ctimes~~##%%rcrc8URRU5$)zFormats in the style of ``datetime.strftime``. :param format: the format string. Usage:: >>> arrow.utcnow().strftime('%d-%m-%Y %H:%M:%S') '23-01-2019 12:28:17' )rNstrftime)r_rs r`rArrow.strftimes~~&&v..rcc"UR5$)zSerializes for the ``for_json`` protocol of simplejson. Usage:: >>> arrow.utcnow().for_json() '2019-01-19T18:25:36.760079+00:00' )rrs r`for_jsonArrow.for_jsons~~rcc[U[[45(a3URURU-URR 5$[ $r)rWrrr|rNr NotImplementedr_r(s r`__add__ Arrow.__add__s@ ei7 8 8$$T^^e%;T^^=R=RS Srcc$URU5$r)rrs r`__radd__Arrow.__radd__s||E""rccgrrrs r`__sub__ Arrow.__sub__ rccgrrrs r`rrrrccN[U[[45(a3URURU- URR 5$[U[ 5(aURU- $[U[5(aURUR- $[$r) rWrrr|rNr r^r9rrs r`rrs| ei7 8 8$$T^^e%;T^^=R=RS S { + +>>E) ) u % %>>EOO3 3rccT[U[5(aXR- $[$r)rWr^rNrrs r`__rsub__Arrow.__rsub__s" e[ ) )>>) )rccv[U[[45(dgURUR U5:H$)NF)rWr9r^rNrrs r`__eq__ Arrow.__eq__s1%%!566~~!3!3E!:::rccf[U[[45(dgURU5(+$)NT)rWr9r^rrs r`__ne__ Arrow.__ne__s)%%!566;;u%%%rcc[U[[45(d[$URUR U5:$rrWr9r^rrNrrs r`__gt__ Arrow.__gt__4%%!566! !~~ 2 25 999rcc[U[[45(d[$URUR U5:$rrrs r`__ge__ Arrow.__ge__ 4%%!566! !~~!3!3E!:::rcc[U[[45(d[$URUR U5:$rrrs r`__lt__ Arrow.__lt__rrcc[U[[45(d[$URUR U5:*$rrrs r`__le__ Arrow.__le__rrctz_exprcUc[R$[U[5(aU$[R R U5$![Ra [U<S35ef=f)z1Get normalized tzinfo object from various inputs.z not recognized as a timezone.) rrVrWrXrrZr[ ParserErrorrs)rs r`rArrow._get_tzinfosl ?<<  gy ) )N O**0099%% O G;.L!MNN Os A $A/exprc[U[5(a UR$[U[5(aU$[R "U5(a&[ U5nURU5R$[U<S35e)z0Get datetime object from a specified expression.z+ not recognized as a datetime or timestamp.) rWr9rr^rrrruryrs)rhrrns r`rArrow._get_datetime*sq dE " "== k * *K   t $ $d I'' 2;; ;x'RST TrccXR;aXS3S4$USS:XaUSSUR;aUSSUS4$US;agUS;agS R/S Q5n[S US US 35e)zFinds relevant timeframe and steps for use in range and span methods. Returns a 3 element tuple in the form (frame, plural frame, step), for example ("day", "days", 1) r?rrN)r1r2)r1r2r)r3r4)r3r&rAr) zyear(s)zmonth(s)zday(s)zhour(s)z minute(s)z second(s)zmicrosecond(s)zweek(s)z quarter(s)zRange or span over frame z" not supported. Supported frames: r)r>rrs)rhr supporteds r`rArrow._get_frames9s :: 6Q& & "X_crcjj!89dA% % & &% , ,)   I+D61ST]S^^_` rccpUcUc [S5eURU4$UcU[R4$X4$)z3Sets default end and limit values for range method.z$One of 'end' or 'limit' is required.)rsr=sysmaxsize)rhrrs r`rArrow._get_iteration_paramsZsF ;} !GHH77E> !}CKK'': rcc[[UR5[R"UR UR 5S:H$)zOReturns a boolean indicating whether the datetime is the last day of the month.r)rrr'calendar monthranger#r%rs r`rArrow._is_last_day_of_monthhs5C"h&9&9$))TZZ&PQR&SSSrcr)rrrrNr)rPr9)NNN)rr5Fr)NNr5F)rNr5F)T)en_us)r6)Tr7)vr __module__ __qualname____firstlineno____doc__r^r;rr__annotations__r>rrr\r@rBrrDrFrGrHrIrJrurKrLrMrr"rTZ_EXPRr ra classmethodrXrerlrrvryr|rrrr _T_FRAMESrr_BOUNDSboolrrrrrrrrrrrrpropertyr rrrnrrrTrr rrrr"r r _GRANULARITYrFrvrdt_timerrrfrrr rrrrrrrrrrrrrrrrrrrrrr staticmethodrrrrr__static_attributes__).0as00r`r9r9Ns @'2&<& > > 6 6 6 +  3{33 *5 * %s % %      #c## >4>>?4?? 1,*,*,*\;*T;*C;*G;*z, W, , b1OO:=O O<48$#?E QWk4/0QQ Q <l);;< Q QfIHsIHCIHgIHb 8 8 8  8  8 x %d % %g % ' '-Xi0-[- *8I. * $Xi( $ *; * -k - *3 * ( ( +C + ,U3S=1 , 7S 7# 73 7 &s & /s /s /  #  SW #eI}$<=#'# U9m#;<    U;#78 Y   S U9g+=%> ci;C;D; &C&D& :C:D: ;C;D; :C:D: ;C;D; OXg. O9 O O U+sE3>? U  U UyU3S=-A@  HSM eCQTHo  TGTTT[7'@sSr9)6rrrQrrrr^rrrrr rXmathr r typingr rrrrrrrrrrrrdateutilrrdateutil.relativedeltararrowrrrrarrow.constantsr r! arrow.localesr"r\rrrrr9r|r<r=rrcr`rs  ,$(( '022>*  3    * ( )   ]T]T@9   { /   { / rc