11i+DSrSSKJr SSKJrJr SrSr"SS5rg) z This module defines a Duration class. The class Duration allows to define durations in years and months and can be used as limited replacement for timedelta objects. ) timedelta) ROUND_FLOORDecimalcnX- X!- pCX4- R[5nX5U-- nXa- n[U5U4$)z% A divmod function with boundaries. ) to_integralrint)vallowhighabdivmods J/home/james-whalen/.local/lib/python3.13/site-packages/isodate/duration.pyfquotmodr sC 9djq 5  k *C Ag+CJC s8S=cXUS;agUS;agUS-S:XdUS-S:wa US-S:Xag g ) zG Determines the number of days of a specific month in a specific year. ) ) irdr)yearmonths rmax_days_in_monthr'sB ''  s q0qQ rc\rSrSrSrSSjrSrSrSrSr Sr S r S r S r \ rS r\rS rSrSrSrSSjrSrg)Duration*a A class which represents a duration. The difference to datetime.timedelta is, that this class handles also differences given in years and months. A Duration treats differences given in year, months separately from all other components. A Duration can be used almost like any timedelta object, however there are some restrictions: * It is not really possible to compare Durations, because it is unclear, whether a duration of 1 year is bigger than 365 days or not. * Equality is only tested between the two (year, month vs. timedelta) basic components. A Duration can also be converted into a datetime object, but this requires a start date or an end date. The algorithm to add a duration to a date is defined at http://www.w3.org/TR/xmlschema-2/#adding-durations-to-dateTimes c [U[5(d[[U55n[U [5(d[[U 55n XlXl[ XX4XVU5Ulg)z> Initialise this Duration instance with the given parameters. N) isinstancerstrmonthsyearsrtdelta) selfdaysseconds microseconds millisecondsminuteshoursweeksr.r/s r__init__Duration.__init__AsY&'**S[)F%))CJ'E   s r__repr__Duration.__repr__use8 NN % % NN # # KK   KK   KK $ $ JJ KK;   rcZ[URURUR45$)zX Return a hash of this instance so that it can be used in, for example, dicts and sets. )hashr0r.r/r>s r__hash__Duration.__hash__s" T[[$++tzz:;;rcj[UR*UR*S9nUR*UlU$)zO A simple unary minus. Returns a new Duration instance with all it's negated. r/r.)r)r/r.r0)r1 negdurations r__neg__Duration.__neg__s0 djj[$++F "kk\ rc[U[5(aX[URUR-URUR-S9nURUR-UlU$[ UR5R 5(a([ UR5R 5(d [S5eURUR-n[USS5upCURUR-U-n[XS5nURU:aUnO URnUR[U5[U5[U5S9nURU-$![a Of=f[URURS9nURU-UlU$![a [ $f=f)zM Durations can be added with Duration, timedelta, date and datetime objects. r]>fractional years or months not supported for date calculationsr r%r&day)r,r)r/r.r0float is_integer ValueErrorr&rr%r'rereplacerAttributeErrorNotImplemented) r1other newdurationnewmonthcarrynewyearmaxdaysnewdaynewdts r__add__Duration.__add__s eX & &"jj5;;.t{{U\\7QK"&u||!;K   $**%0022uT[[7I7T7T7V7V W{{T[[0H&xB7OEjj4::-5G':Gyy7" MM\XCK"E;;& &    #DKKHK!%u!4K      s%/DE33 F?F3F88 G  G c[U[5(a:[URU-URU-S9nUR U-UlU$[ $)Nr])r,rr)r/r.r0rkr1rlrms r__mul__Duration.__mul__sK eS ! !"e);DKKRWDWXK!%u!4K  rcp[U[5(aX[URUR- URUR- S9nURUR- UlU$[URURS9nURU- UlU$![ a [ $f=f)zR It is possible to subtract Duration and timedelta objects from Duration objects. r])r,r)r/r.r0 TypeErrorrkrws r__sub__Duration.__sub__s eX & &"jj5;;.t{{U\\7QK"&u||!;K   "DKKHK!%u!4K     s/3B## B54B5c[U[5(a[5nXlX - $[ UR 5R 5(a([ UR5R 5(d [S5eURUR- n[USS5upCURUR - U-n[XS5nURU:aUnO URnUR[U5[U5[U5S9nXR- $![ a ["$f=f)a It is possible to subtract Duration objects from date, datetime and timedelta objects. TODO: there is some weird behaviour in date - timedelta ... if timedelta has seconds or microseconds set, then date - timedelta != date + (-timedelta) for now we follow this behaviour to avoid surprises when mixing timedeltas with Durations, but in case this ever changes in the stdlib we can just do: return -self + other instead of all the current code rbrrcrd)r,rr)r0rfr/rgr.rhr&rr%r'rerirrjrk) r1rltmpdurrnrorprqrrrss r__rsub__Duration.__rsub__s eY ' 'ZF!M=  $**%0022uT[[7I7T7T7V7V W{{T[[0H&xB7OEjj4::-5G':Gyy7" MM\XCK"E;;& &   sDD.. E?Ec8[U[5(aVURS-UR-URS-UR-:XaURUR:XaggURS:XaURS:XaURU:H$g)zn If the years, month part and the timedelta part are both equal, then the two Durations are considered equal. rTFrr,r)r/r.r0r1rls r__eq__Duration.__eq__ s eX & & R$++- b 5<</++- ::?t{{a/;;%' 'rc8[U[5(aVURS-UR-URS-UR-:wdURUR:waggURS:XaURS:XaURU:g$g)zo If the years, month part or the timedelta part is not equal, then the two Durations are considered not equal. rTFrrrs r__ne__Duration.__ne__s eX & & R$++- b 5<</ , ::?t{{a/;;%' 'rNchUcUc [S5eUbUb [S5eUbX-U- $X"U- - $)z Convert this duration into a timedelta object. This method requires a start datetime or end datetimem, but raises an exception if both are given. zstart or end requiredzonly start or end allowed)rh)r1startends r totimedeltaDuration.totimedelta/sO =S[45 5  89 9  LE) )Dj!!r)r.r0r/) rrrrrrrrr)NN)rUrT __qualname____firstlineno____doc__r9r?rDrIrPrVrZr_rt__radd__rx__rmul__r|rrrr__static_attributes__r$rrr)r)*s0 2$* !  <-^HH*(T"" "rr)N) rdatetimerdecimalrrrr'r)r$rrrs((" R"R"r