w:iH SSKJr SSKJrJr SSKrSSKJrJrJrJ r J r J r J r SSK rSSKJr SSKJrJrJrJrJrJr SSKJrJr S6SjrS6S jrS6S jrS6S jrS6S jrS6S jr S6Sjr!S6Sjr"S6Sjr#S6Sjr$"SS5r%0r&S7Sjr'S8Sjr("SS\)5r*"SS\*S9r+\%"SSS\"\"S5S9S 9r,\%"S!S"S#\"\"S#5S9S 9r-\%"S$S%S#\"\"S&5S9S 9r.\%"S'S(S#\"\ "S)5S9S 9r/\%"S*\"S+S#S#5S#S#\"\"S,5S9S-9r0\%"S.S&S#\"\"S,5S9S 9r1\%"S/S#S#\"5\"S05/S 9r2\%"S1S#S#\"5\"S#5/S 9r3"S2S3\+5r4\+4S8S4jjr5/S5Qr6g)9) annotations)datetime timedeltaN)FRMOSASUTHTUWE)PerformanceWarning) DateOffset DatetimeIndexSeries Timestampconcat date_range)DayEastercUR5S:XaU[S5-$UR5S:XaU[S5-$U$)zl If holiday falls on Saturday, use following Monday instead; if holiday falls on Sunday, use Monday instead weekdayrdts Y/srv/projetos/modelo_ml_acdoc/venv/lib/python3.13/site-packages/pandas/tseries/holiday.py next_mondayr %C  zz|qIaL   IaL  IcvUR5nUS;aU[S5-$US:XaU[S5-$U$)z For second holiday of two adjacent ones! If holiday falls on Saturday, use following Monday instead; if holiday falls on Sunday or Monday, use following Tuesday instead (because Monday is already taken by adjacent holiday on the day before) )rrrrrr)rdows rnext_monday_or_tuesdayr%1s@ **,C f}IaL   axIaL  Ir"cUR5S:XaU[S5- $UR5S:XaU[S5- $U$)zF If holiday falls on Saturday or Sunday, use previous Friday instead. rrrrrrs rprevious_fridayr'@sC zz|qIaL   IaL  Ir"cJUR5S:XaU[S5-$U$)zB If holiday falls on Sunday, use day thereafter (Monday) instead. rrrrs rsunday_to_mondayr)Ks& zz|qIaL  Ir"cUR5S:XaU[S5-$UR5S:XaU[S5-$U$)z If holiday falls on Sunday or Saturday, use day thereafter (Monday) instead. Needed for holidays such as Christmas observation in Europe rrrrrrs rweekend_to_mondayr+TsC  zz|qIaL   IaL  Ir"cUR5S:XaU[S5- $UR5S:XaU[S5-$U$)z If holiday falls on Saturday, use day before (Friday) instead; if holiday falls on Sunday, use day thereafter (Monday) instead. rrrrrs rnearest_workdayr-ar!r"cU[SS9- nUR5S:a"U[SS9- nUR5S:aM"U$)z+ returns next weekday used for observances rdaysrrrs r next_workdayr3mG) B **,  iQ **,  Ir"cU[SS9-nUR5S:a"U[SS9-nUR5S:aM"U$)z/ returns previous weekday used for observances rr/r1r2rs rprevious_workdayr6xr4r"c*[[U55$)z0 returns previous workday after nearest workday )r6r-rs rbefore_nearest_workdayr8s OB/ 00r"c*[[U55$)zc returns next workday after nearest workday needed for Boxing day or multiple holidays in a series )r3r-rs rafter_nearest_workdayr:s + ,,r"c\rSrSr%SrS\S'S\S'S\S'SSS jjrSS jrSSS jjrSS jr SS jr Sr g)HolidayzM Class that defines a holiday with start/end dates and rules for observance. zTimestamp | None start_dateend_dateztuple[int, ...] | None days_of_weekNc UbUb [S5eXlX lX0lX@lXPlUb [ U5OUUlUb [ U5OUUlX`l U b[U 5[:XdeXl g)a Parameters ---------- name : str Name of the holiday , defaults to class name offset : array of pandas.tseries.offsets or class from pandas.tseries.offsets computes offset from date observance: function computes when holiday is given a pandas Timestamp days_of_week: provide a tuple of days e.g (0,1,2,3,) for Monday Through Thursday Monday=0,..,Sunday=6 Examples -------- >>> from dateutil.relativedelta import MO >>> USMemorialDay = pd.tseries.holiday.Holiday( ... "Memorial Day", month=5, day=31, offset=pd.DateOffset(weekday=MO(-1)) ... ) >>> USMemorialDay Holiday: Memorial Day (month=5, day=31, offset=) >>> USLaborDay = pd.tseries.holiday.Holiday( ... "Labor Day", month=9, day=1, offset=pd.DateOffset(weekday=MO(1)) ... ) >>> USLaborDay Holiday: Labor Day (month=9, day=1, offset=) >>> July3rd = pd.tseries.holiday.Holiday("July 3rd", month=7, day=3) >>> July3rd Holiday: July 3rd (month=7, day=3, ) >>> NewYears = pd.tseries.holiday.Holiday( ... "New Years Day", month=1, day=1, ... observance=pd.tseries.holiday.nearest_workday ... ) >>> NewYears # doctest: +SKIP Holiday: New Years Day ( month=1, day=1, observance= ) >>> July3rd = pd.tseries.holiday.Holiday( ... "July 3rd", month=7, day=3, ... days_of_week=(0, 1, 2, 3) ... ) >>> July3rd Holiday: July 3rd (month=7, day=3, ) Nz&Cannot use both offset and observance.) NotImplementedErrornameyearmonthdayoffsetrr>r? observancetypetupler@) selfrCrDrErFrGrHr>r?r@s r__init__Holiday.__init__s|  *"8%&NO O    %/%;Ij ! 08/C (+ $#tL'9U'BBB(r"c,SnURbUSURS3- nUSURSURS3- nURbUSUR3- nURbUSUR3- nSUR S US 3nU$) Nzyear=z, zmonth=z, day=zoffset=z observance=z Holiday: z ())rDrErFrGrHrC)rKinforeprs r__repr__Holiday.__repr__s 99 eDII;b) )D & F488*B77 ;; " gdkk]+ +D ?? & k$//!23 3D499+RvQ/ r"c"[U5n[U5nUnUnURb][[URURUR55n[ U/5nU(a[ URUS9$U$URX5nURU5n URb<U [R"U RUR5R5n URb/[!URR#UR$5U5nUR&b/[)UR&R#UR$5U5nU X:X:*-n U(a[ URU S9$U $)a Calculate holidays observed between start date and end date Parameters ---------- start_date : starting date, datetime-like, optional end_date : ending date, datetime-like, optional return_name : bool, optional, default=False If True, return a series that has dates and holiday names. False will only return dates. Returns ------- Series or DatetimeIndex Series if return_name is True )index)rrDrrErFrrrC_reference_dates _apply_ruler@npisin dayofweekravelr>max tz_localizetzr?min) rKr>r? return_namefilter_start_datefilter_end_daterdtidates holiday_datess rre Holiday.datessg&z* X&&" 99 8DIItzz488DEB%Cdiis33 %%j;((/    ()!++%%%' M ?? & #++,=,@,@ACT!  == $! ))/*<*<=O&  /M4T U  $))=9 9r"cURb%URRUR5nURb%URRUR5n[ SS9n[ [ URS- URUR55n[ [ URS-URUR55n[UUUURS9nU$)a Get reference dates for the holiday. Return reference dates for the holiday also returning the year prior to the start_date and year following the end_date. This ensures that any offsets to be applied will yield the holidays within the passed in dates. r)years)startendfreqr_) r>r^r_r?rrrrDrErFr)rKr>r? year_offsetreference_start_datereference_end_dateres rrWHoliday._reference_dates4s ?? &44Z]]CJ == $}}00?H q) ( Z__q($**dhh ? ' X]]Q& DHH = &"}}   r"c^UR(aUR5$TRbURU4Sj5$TRb[ TR[ 5(dTR/nO TRnUH@n[R"5 [R"S[5 X- nSSS5 MB U$!,(df  MU=f)z Apply the given offset/observance to a DatetimeIndex of dates. Parameters ---------- dates : DatetimeIndex Dates to apply the given offset/observance rule Returns ------- Dates with rules applied Nc&>TRU5$N)rH)drKs r%Holiday._apply_rule..hstq'9r"ignore) emptycopyrHmaprG isinstancelistwarningscatch_warnings simplefilterr )rKreoffsetsrGs` rrXHoliday._apply_ruleWs ;;::<  ?? &999: : ;; "dkk400;;-++!,,.))(4FGOE/."  /.s % C C" ) rFr@r?rErCrHrGr>rD)NNNNNNNNrCstrreturnNone)rrF)raboolrzSeries | DatetimeIndex)r>rr?rrr)rerrr) __name__ __module__ __qualname____firstlineno____doc____annotations__rLrSrerWrX__static_attributes__r"rr<r<s ! ((  L)L) L)\  9>9159 9v!#!/8! !Fr"r<chURnU[U'g![a URnN"f=frs)rCAttributeErrorrholiday_calendars)clsrCs rregisterr{s7xx"d ||s 11c[U"5$)z Return an instance of a calendar based on its name. Parameters ---------- name : str Calendar name to return an instance of )r)rCs r get_calendarrs T " $$r"c,^\rSrSrSU4SjjrSrU=r$)HolidayCalendarMetaClassic>>[TU]XX#5n[U5 U$rs)super__new__r)rclsnamebasesattrscalendar_class __class__s rr HolidayCalendarMetaClass.__new__s!uD r"r)rr)rrrrrr __classcell__rs@rrrs r"rc^\rSrSr%Sr/rS\S'\"\"SSS55r \"\"SSS 55r S r SSU4S jjjr SS jr SSS jjr\S5rSSSjjrSrU=r$)AbstractHolidayCalendariz@ Abstract interface to create holidays following certain rules. z list[Holiday]rulesiri Ncz>[TU]5 U(d[U5RnXlUbX lgg)a Initializes holiday object with a given set a rules. Normally classes just have the rules defined within them. Parameters ---------- name : str Name of the holiday calendar, defaults to class name rules : array of Holiday objects A set of rules used to create the holidays. N)rrLrIrrCr)rKrCrrs rrL AbstractHolidayCalendar.__init__s7 :&&D  J r"cRURHnURU:XdMUs $ grsrrC)rKrCrules rrule_from_name&AbstractHolidayCalendar.rule_from_names&JJDyyD  r"c VURc[SURS35eUc[RnUc[R n[ U5n[ U5nURb$XRS:dX RS:ajURVs/sHoDRXSS9PM nnU(a [U5nO[[/5[S9nXUR54UlURSnXaUnU(aU$UR$s snf) ap Returns a curve with holidays between start_date and end_date Parameters ---------- start : starting date, datetime-like, optional end : ending date, datetime-like, optional return_name : bool, optional If True, return a series that has dates and holiday names. False will only return a DatetimeIndex of dates. Returns ------- DatetimeIndex of holidays zHoliday Calendar z" does not have any rules specifiedrrT)ra)rVdtyper)r ExceptionrCrr>r?r_cachererrrobject sort_indexrV)rKrjrkrar pre_holidaysholidayss rr AbstractHolidayCalendar.holidayss :: #DII;.PQ  =+66E ;)22C% n ;; %++a."8C++a.#& O>> !/s"D&cURn[U[5(dU/nUVs0sHo"RU_M nnURn[U[5(dU/nUVs0sHo"RU_M nnUR U5 [UR 55$![a Nf=fs snf![a Nf=fs snf)a? Merge holiday calendars together. The base calendar will take precedence to other. The merge will be done based on each holiday's name. Parameters ---------- base : AbstractHolidayCalendar instance/subclass or array of Holiday objects other : AbstractHolidayCalendar instance/subclass or array of Holiday objects )rrr{r|rCupdatevalues)baseotherholidayother_holidays base_holidayss r merge_class#AbstractHolidayCalendar.merge_classs KKE%&&GE?DEuG,,/uE ::D$%%6D>BCd7w.d Cm,N))+,,#    F    Ds. B-B= C+C- B:9B: CCcDURX5nU(aX0lgU$)a Merge holiday calendars together. The caller's class rules take precedence. The merge will be done based on each holiday's name. Parameters ---------- other : holiday calendar inplace : bool (default=False) If True set rule_table to holidays, else return array of Holidays N)rr)rKrinplacers rmergeAbstractHolidayCalendar.merges!##D0 !JOr")rrCr)rONrrCr)NNF)rarr)rr)rrrrrrrrrr>r?rrLrr staticmethodrrrrrs@rrrssE=8D!Q/0J$B/0H F(8"t - -Dr"r) metaclassz Memorial Dayrr)r)rErFrGz Labor Day rz Columbus Day rzThanksgiving Day r1z#Birthday of Martin Luther King, Jr.i)r>rErFrGzWashington's Birthdayz Good Fridayz Easter Mondaycz\rSrSrSr\"SSS\S9\\\ \"SSSS \S 9\"S S S \S9\ \ \"SSS\S9\ \"SSS\S9/ r Srg)USFederalHolidayCalendariDz US Federal Government Holiday Calendar based on rules specified by: https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/ zNew Year's Dayr)rErFrHz$Juneteenth National Independence Dayrz 2021-06-18)rErFr>rHzIndependence Dayr1z Veterans Dayrz Christmas DayrrN)rrrrrr<r-USMartinLutherKingJrUSPresidentsDay USMemorialDay USLaborDay USColumbusDayUSThanksgivingDayrrrr"rrrDsu  q_M 2#&   "!Obb_MrroN# Er"rcN[RX5n[X4X@S.5nU$)Nr)rrrI)rCrr base_classrrs rHolidayCalendarFactoryr_s) # / / rs",    1-ccL" %tR(@Rj!Jr"v,F [qBqE9R S "!Jr!u,E ba 2a50I)a#  be $ 1!Jr!u4M]!FHc"g;N O aQ#a&?QR 66?V  r"