uj= >UddlmZddlmZmZddlmZmZmZddlZddl m Z m Z m Z m Z mZmZmZddlZddlmZddlmZddlmZmZmZmZmZmZdd lmZm Z erdd l!m"Z"d;d Z#d;d Z$d;d Z%d;dZ&d;dZ'd;dZ(d;dZ)d;dZ*d;dZ+d;dZ,GddZ-iZ.de/d<dd9Z>gd:Z?y)?) annotations)datetime timedelta) TYPE_CHECKINGLiteraloverloadN)FRMOSASUTHTUWE) BaseOffset)PerformanceWarning) DateOffset DatetimeIndexSeries Timestampconcat date_range)DayEaster)Callablec|jdk(r|tdzS|jdk(r|tdzS|S)a Move Saturday and Sunday to the following Monday. A holiday on a weekday keeps its date. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.weekend_to_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.next_monday_or_tuesday : Move Saturday to Monday, and Sunday or Monday to Tuesday. tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import next_monday >>> next_monday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2022, 1, 3, 0, 0) >>> next_monday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 3, 0, 0) weekdayrdts a/var/www/html/python-recuperauto-other/env/lib/python3.12/site-packages/pandas/tseries/holiday.py next_mondayr%.DD zz|qIaL   IaL  Icp|j}|dvr|tdzS|dk(r|tdzS|S)as Move Saturday to Monday, and Sunday or Monday to Tuesday. Use this for the second of two adjacent holidays, where the Monday is already taken by the holiday of the day before. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.next_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.after_nearest_workday : Move to the workday after the nearest workday. tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import next_monday_or_tuesday >>> next_monday_or_tuesday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2022, 1, 3, 0, 0) >>> next_monday_or_tuesday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 4, 0, 0) >>> next_monday_or_tuesday(datetime(2022, 1, 3)) # Monday datetime.datetime(2022, 1, 4, 0, 0) )rrrrrr )r#dows r$next_monday_or_tuesdayr*WsAJ **,C f}IaL   axIaL  Ir'c|jdk(r|tdz S|jdk(r|tdz S|S)a Move Saturday and Sunday back to the previous Friday. A holiday on a weekday keeps its date. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.next_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.previous_workday : Move to the previous weekday. tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import previous_friday >>> previous_friday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2021, 12, 31, 0, 0) >>> previous_friday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2021, 12, 31, 0, 0) rrrrr r"s r$previous_fridayr,sDB zz|qIaL   IaL  Ir'cH|jdk(r|tdzS|S)a Move Sunday to the following Monday. A holiday on a Saturday stays where it is. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.weekend_to_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.nearest_workday : Move Saturday to Friday and Sunday to Monday. tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import sunday_to_monday >>> sunday_to_monday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 3, 0, 0) >>> sunday_to_monday(datetime(2022, 1, 1)) # Saturday, unchanged datetime.datetime(2022, 1, 1, 0, 0) rrr r"s r$sunday_to_mondayr.s'D zz|qIaL  Ir'c|jdk(r|tdzS|jdk(r|tdzS|S)a Move Saturday and Sunday to the following Monday. Same as ``next_monday``. Needed for holidays such as the Christmas observation in Europe. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.next_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.sunday_to_monday : Move Sunday to the following Monday. tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import weekend_to_monday >>> weekend_to_monday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2022, 1, 3, 0, 0) >>> weekend_to_monday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 3, 0, 0) rrrrr r"s r$weekend_to_mondayr0r&r'c|jdk(r|tdz S|jdk(r|tdzS|S)a Move Saturday to Friday and Sunday to Monday. Most US federal holidays follow this rule. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.before_nearest_workday : Move to the workday before the nearest workday. tseries.holiday.after_nearest_workday : Move to the workday after the nearest workday. tseries.holiday.USFederalHolidayCalendar : US Federal Government holiday calendar. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import nearest_workday >>> nearest_workday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2021, 12, 31, 0, 0) >>> nearest_workday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 3, 0, 0) rrrr r"s r$nearest_workdayr2r&r'c|tdz }|jdkDr#|tdz }|jdkDr#|S)a  Move to the next weekday. The date is always advanced by at least one day, even when ``dt`` already falls on a weekday. To leave weekdays unchanged and move only weekend dates forward, use ``next_monday`` or ``weekend_to_monday``. Parameters ---------- dt : datetime The date to move forward from. Returns ------- datetime The next weekday after ``dt``. See Also -------- tseries.holiday.previous_workday : Move to the previous weekday. tseries.holiday.next_monday : Move Saturday and Sunday to the following Monday. tseries.holiday.after_nearest_workday : Move to the workday after the nearest workday. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import next_workday >>> next_workday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2022, 1, 3, 0, 0) >>> next_workday(datetime(2022, 1, 5)) # Wednesday, still advances datetime.datetime(2022, 1, 6, 0, 0) rdaysrr!r"s r$ next_workdayr8%HF) B **,  iQ **,  Ir'c|tdz}|jdkDr#|tdz}|jdkDr#|S)a  Move to the previous weekday. The date is always moved back by at least one day, even when ``dt`` already falls on a weekday. To leave weekdays unchanged and move only weekend dates back, use ``previous_friday``. Parameters ---------- dt : datetime The date to move back from. Returns ------- datetime The previous weekday before ``dt``. See Also -------- tseries.holiday.next_workday : Move to the next weekday. tseries.holiday.previous_friday : Move Saturday and Sunday back to the previous Friday. tseries.holiday.before_nearest_workday : Move to the workday before the nearest workday. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import previous_workday >>> previous_workday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2021, 12, 31, 0, 0) >>> previous_workday(datetime(2022, 1, 5)) # Wednesday, still moves back datetime.datetime(2022, 1, 4, 0, 0) rr4r6r7r"s r$previous_workdayr;Or9r'c*tt|S)a Move to the workday before the nearest workday. ``nearest_workday`` runs first, so a Saturday holiday ends up on the Thursday before it. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.nearest_workday : Move Saturday to Friday and Sunday to Monday. tseries.holiday.after_nearest_workday : Move to the workday after the nearest workday. tseries.holiday.previous_workday : Move to the previous weekday. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import before_nearest_workday >>> before_nearest_workday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2021, 12, 30, 0, 0) >>> before_nearest_workday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2021, 12, 31, 0, 0) )r;r2r"s r$before_nearest_workdayr=ysD OB/ 00r'c*tt|S)a Move to the workday after the nearest workday. Needed for Boxing Day, or for several holidays in a row. Parameters ---------- dt : datetime The date the holiday falls on. Returns ------- datetime The date the holiday is observed on. See Also -------- tseries.holiday.nearest_workday : Move Saturday to Friday and Sunday to Monday. tseries.holiday.before_nearest_workday : Move to the workday before the nearest workday. tseries.holiday.next_workday : Move to the next weekday. Examples -------- >>> from datetime import datetime >>> from pandas.tseries.holiday import after_nearest_workday >>> after_nearest_workday(datetime(2022, 1, 1)) # Saturday datetime.datetime(2022, 1, 3, 0, 0) >>> after_nearest_workday(datetime(2022, 1, 2)) # Sunday datetime.datetime(2022, 1, 4, 0, 0) )r8r2r"s r$after_nearest_workdayr?sB + ,,r'ceZdZUdZded<ded<ded< d ddZdd Zedd Ze dd Zedd Z d dd Z ddZ ddZ y)Holidaya Class that defines a holiday with start/end dates and rules for observance. A ``Holiday`` can either be defined by a fixed ``year``/``month``/``day``, or, more commonly, by a recurring ``month``/``day`` combined with an ``offset`` or ``observance`` rule that adjusts the date in each year it is calculated for. Instances of ``Holiday`` are typically collected in the ``rules`` of an :class:`~pandas.tseries.holiday.AbstractHolidayCalendar`. Parameters ---------- name : str Name of the holiday, defaults to class name. year : int, default None Year of the holiday. month : int, default None Month of the holiday. day : int, default None Day of the holiday. offset : DateOffset or list of DateOffset, default None Computes offset from date. See :mod:`pandas.tseries.offsets` for the available offset classes. observance : function, default None Computes when holiday is given a pandas Timestamp. start_date : datetime-like, default None First date the holiday is observed. end_date : datetime-like, default None Last date the holiday is observed. days_of_week : tuple of int or dateutil.relativedelta weekday strs, default None Provide a tuple of days e.g (0,1,2,3,) for Monday through Thursday Monday=0,..,Sunday=6 Only instances of the holiday included in days_of_week will be computed. exclude_dates : DatetimeIndex or default None Specific dates to exclude e.g. skipping a specific year's holiday. See Also -------- tseries.holiday.AbstractHolidayCalendar : Abstract interface to create holidays following certain rules. tseries.holiday.Holiday.dates : Calculate holidays observed between start date and end date. 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, ) zTimestamp | None start_dateend_datetuple[int, ...] | None days_of_weekNc |J| tdt|ts-t|trt d|Ds t d||_||_||_||_ ||_ | t|n||_ | t|n||_ ||_| t| ts t d| |_| t| t"s t d| |_y)Nz&Cannot use both offset and observance.c3<K|]}t|tywN) isinstancer).0offs r$ z#Holiday.__init__..+sJCJsJ7JszAOnly BaseOffsets and flat lists of them are supported for offset.z#days_of_week must be None or tuple.z4exclude_dates must be None or of type DatetimeIndex.)NotImplementedErrorrIrlistall ValueErrornameyearmonthdayoffsetrrBrC observancetuplerEr exclude_dates) selfrQrRrSrTrUrVrBrCrErXs r$__init__zHoliday.__init__s  %)*RSS6:.vt,J6JJ!W    %/%;Ij ! 08/C (+ $$ <(GBC C(%M=)QST T*r'c&d}|j|d|jdz }|d|jd|jdz }|j|d|jz }|j|d|jz }d|j d |d }|S) Nzyear=z, zmonth=z, day=zoffset=z observance=z Holiday: z ())rRrSrTrUrVrQ)rYinforeprs r$__repr__zHoliday.__repr__Cs 99 eDII;b) )D & F488*B77 ;; " gdkk]+ +D ?? & k$//!23 3D499+RvQ/ r'cyrHrYrBrC return_names r$datesz Holiday.datesRsQTr'cyrHrbrcs r$rez Holiday.datesUsr'cyrHrb)rYrBrCs r$rez Holiday.datesZs>> from dateutil.relativedelta import MO >>> USMemorialDay = pd.tseries.holiday.Holiday( ... "Memorial Day", month=5, day=31, offset=pd.DateOffset(weekday=MO(-1)) ... ) >>> USMemorialDay.dates("2020-01-01", "2021-12-31") DatetimeIndex(['2020-05-25', '2021-05-31'], dtype='datetime64[us]', freq=None) )index)rrRrrSrTrrrQ_reference_dates _apply_rulerEnpisin day_of_weekravelrBmax tz_localizetzrCminrX difference) rYrBrCrdfilter_start_datefilter_end_dater#dtire holiday_datess r$rez Holiday.dates]sRz* X&&" 99 8DIItzz488DEB%Cdiis33 %%j(;((/    ()!--%%%' M ?? & #++,=,@,@ACT!  == $! ))/*<*<=O& / /M_4T U     ))44T5G5GHM $))=9 9r'c|j%|jj|j}|j%|jj|j}t d}t t |jdz |j|j}t t |jdz|j|j}t||||j}|S)a0 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)startendfreqrr) rBrqrrrCrrrrRrSrTr)rYrBrC year_offsetreference_start_datereference_end_dateres r$rjzHoliday._reference_datess ?? &44Z]]CJ == $}}00?H q) ( Z__q($**dhh ? ' X]]Q& DHH = &"}}   r'c|jr|jSj|jfdSjwt jt sjg}n j}|D]>}tj5tjdt||z }ddd@|S#1swYLxYw)a 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&j|SrH)rV)drYs r$z%Holiday._apply_rule..stq'9r'ignore) emptycopyrVmaprUrIrNwarningscatch_warnings simplefilterr)rYreoffsetsrUs` r$rkzHoliday._apply_rules ;;::<  ?? &999: : ;; "dkk40;;-++! $,,.$))(4FGVOE$$ $  $$s  CC ) NNNNNNNNN) rQstrrUz$BaseOffset | list[BaseOffset] | NonerVz%Callable[[datetime], datetime] | NonerErDrXzDatetimeIndex | NonereturnNone)rr)rdz Literal[True]rr)rdzLiteral[False]rr)rrF)rdboolrzSeries | DatetimeIndex)rBrrCrrr)rerrr) __name__ __module__ __qualname____doc____annotations__rZr`rrerjrkrbr'r$rArAsN`! ((  7;<@/3.2*+*+ 5 *+:*+-*+,*+ *+X TT 1? ??9>Q15Q Qf!#!/8! !Fr'rAz(dict[str, type[AbstractHolidayCalendar]]holiday_calendarscf |j}|t|<y#t$r|j}Y!wxYw)a Add a holiday calendar class to the registry of named calendars. Calendar classes register themselves as soon as they are defined, so this is rarely called directly. A class is registered under its ``name`` attribute if it has one and under its class name otherwise, and registering a class under a name that is already taken replaces the earlier one. See Also -------- tseries.holiday.get_calendar : Return an instance of a calendar based on its name. tseries.holiday.HolidayCalendarFactory : Create a holiday calendar class from two sets of rules. tseries.holiday.AbstractHolidayCalendar : Abstract interface to create holidays following certain rules. Examples -------- >>> from pandas.tseries.holiday import ( ... AbstractHolidayCalendar, ... USLaborDay, ... get_calendar, ... register, ... ) >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> MyCalendar.name = "us_labor_only" >>> register(MyCalendar) >>> [rule.name for rule in get_calendar("us_labor_only").rules] ['Labor Day'] N)rQAttributeErrorrr)clsrQs r$registerrs8Dxx"d ||s 00AbstractHolidayCalendarct|S)aA Return an instance of a calendar based on its name. The calendar class does not have to be kept around, since every calendar class is registered by name as soon as it is defined. Parameters ---------- name : str Calendar name to return an instance of. This is the class name, unless the class sets a ``name`` attribute. Returns ------- AbstractHolidayCalendar A new instance of the registered calendar class. Raises ------ KeyError If no calendar is registered under ``name``. See Also -------- tseries.holiday.register : Add a holiday calendar class to the registry of named calendars. tseries.holiday.HolidayCalendarFactory : Create a holiday calendar class from two sets of rules. tseries.holiday.AbstractHolidayCalendar : Abstract interface to create holidays following certain rules. Examples -------- >>> from pandas.tseries.holiday import ( ... AbstractHolidayCalendar, ... USLaborDay, ... get_calendar, ... ) >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> cal = get_calendar("MyCalendar") >>> cal.holidays(start="2020-01-01", end="2020-12-31") DatetimeIndex(['2020-09-07'], dtype='datetime64[us]', freq=None) )r)rQs r$ get_calendarr sZ T " $$r'c eZdZdfd ZxZS)HolidayCalendarMetaClasscBt|||||}t||SrH)super__new__r)rclsnamebasesattrscalendar_class __class__s r$rz HolidayCalendarMetaClass.__new__Qs%gueD r')rr)rrrr __classcell__rs@r$rrPs r'rceZdZUdZgZded<eedddZeedddZ d Z d ed <ddfd Z dd Z d ddZ edZdddZxZS)ra Abstract interface to create holidays following certain rules. A subclass normally defines its holidays by setting ``rules`` to a list of :class:`~pandas.tseries.holiday.Holiday` instances directly on the class body. Alternatively, a set of rules can be passed to the constructor. The calendar can then be used to compute the holiday dates falling within a given date range via :meth:`~pandas.tseries.holiday.AbstractHolidayCalendar.holidays`. 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. See Also -------- tseries.holiday.Holiday : Class that defines a holiday with start/end dates and rules for observance. tseries.offsets.CustomBusinessDay : DateOffset subclass representing possibly n business days excluding holidays. Examples -------- >>> from pandas.tseries.holiday import AbstractHolidayCalendar, USLaborDay >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> MyCalendar().holidays(start="2020-01-01", end="2020-12-31") DatetimeIndex(['2020-09-07'], dtype='datetime64[us]', freq=None) z list[Holiday]rulesiri Nz*tuple[Timestamp, Timestamp, Series] | None_cachecrt||st|j}||_|||_yyrH)rrZtyperrQr)rYrQrrs r$rZz AbstractHolidayCalendar.__init__~s9 :&&D  DJ r'cL|jD]}|j|k(s|cSy)a Return the rule for the holiday with the given name. Searches ``self.rules`` for a :class:`~pandas.tseries.holiday.Holiday` whose ``name`` attribute matches exactly. Parameters ---------- name : str Name of the holiday whose rule should be returned. Returns ------- Holiday or None The matching rule from ``self.rules``, or None if no rule with the given name is found. See Also -------- tseries.holiday.AbstractHolidayCalendar.holidays : Return a curve with holidays between start_date and end_date. Examples -------- >>> from pandas.tseries.holiday import AbstractHolidayCalendar, USLaborDay >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> MyCalendar().rule_from_name("Labor Day") Holiday: Labor Day (month=9, day=1, offset=) NrrQ)rYrQrules r$rule_from_namez&AbstractHolidayCalendar.rule_from_names->JJ DyyD   r'c|jtd|jd|tj}|tj }t |}t |}|j}|||dks||dkDrm|jDcgc]}|j||d}}|r t|}nttgt}|||jf}||_|d}|||}|r|S|jScc}w) a( Return a curve with holidays between start_date and end_date. The holidays for the calendar are computed by evaluating the ``dates`` of each rule in ``self.rules`` and merging the results, caching them so that repeated calls covering a previously requested date range do not need to be recomputed. Parameters ---------- start : starting date, datetime-like, optional The earliest date to consider, defaults to :attr:`AbstractHolidayCalendar.start_date`. end : ending date, datetime-like, optional The latest date to consider, defaults to :attr:`AbstractHolidayCalendar.end_date`. 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 or Series DatetimeIndex of holidays, or a Series mapping holiday dates to their names if ``return_name`` is True. See Also -------- tseries.holiday.Holiday.dates : Calculate holidays observed between start date and end date. Examples -------- >>> from pandas.tseries.holiday import AbstractHolidayCalendar, USLaborDay >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> MyCalendar().holidays(start="2020-01-01", end="2020-12-31") DatetimeIndex(['2020-09-07'], dtype='datetime64[us]', freq=None) zHoliday Calendar z" does not have any rules specifiedrrT)rd)ridtyper)r ExceptionrQrrBrCrrrerrrobject sort_indexri)rYr{r|rdcacher pre_holidaysholidayss r$rz AbstractHolidayCalendar.holidayssT :: #DII;.PQ  =+66E ;)22C% n  =EE!H,eAhEIZZ=A 5#4 8L!,/! b(9HC!4!4!67EDK8E#& O>> !#s Dc |j}t|ts|g}|Dcic]}|j|}} |j}t|ts|g}|Dcic]}|j|}}|j |t|j S#t$rYwxYwcc}w#t$rYvwxYwcc}w)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. Returns ------- list of Holiday Combined list of holidays from both calendars, with ``base`` taking precedence over ``other`` for holidays sharing the same name. See Also -------- tseries.holiday.AbstractHolidayCalendar.merge : Merge holiday calendars together. Examples -------- >>> from pandas.tseries.holiday import ( ... AbstractHolidayCalendar, ... USLaborDay, ... USMemorialDay, ... ) >>> class Calendar1(AbstractHolidayCalendar): ... rules = [USMemorialDay] >>> class Calendar2(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> merged = AbstractHolidayCalendar.merge_class(Calendar1, Calendar2) >>> [holiday.name for holiday in merged] ['Labor Day', 'Memorial Day'] )rrrIrNrQupdatevalues)baseotherholidayother_holidays base_holidayss r$ merge_classz#AbstractHolidayCalendar.merge_classsT KKE%&GE?DEG',,/EE ::D$%6D>BC7w.C Cm,N))+,,#    F    Ds- BB. B3C B+*B+3 B?>B?c>|j||}|r||_y|S)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 Calendar, instance/subclass, or array of Holiday objects to merge into this calendar's rules. inplace : bool (default=False) If True set rule_table to holidays, else return array of Holidays. Returns ------- list of Holiday or None The combined list of holidays if ``inplace`` is False, otherwise None. See Also -------- tseries.holiday.AbstractHolidayCalendar.merge_class : Merge holiday calendars together. Examples -------- >>> from pandas.tseries.holiday import ( ... AbstractHolidayCalendar, ... USLaborDay, ... USMemorialDay, ... ) >>> class Calendar1(AbstractHolidayCalendar): ... rules = [USMemorialDay] >>> class Calendar2(AbstractHolidayCalendar): ... rules = [USLaborDay] >>> merged = Calendar1().merge(Calendar2()) >>> [holiday.name for holiday in merged] ['Labor Day', 'Memorial Day'] N)rr)rYrinplacers r$mergezAbstractHolidayCalendar.merge:s&T##D%0 !DJOr')r\N)rQrrr)rQrrzHoliday | None)NNF)rdrrzDatetimeIndex | Seriesr)rr)rrrrrrrrrBrCrrZrr staticmethodrrrrs@r$rrWsBE=8D!Q/0J$B/0H9=F 6=#L9>M"15M" M"^<-<-|..r') metaclassz Memorial Dayrr)r!)rSrTrUz Labor Day rz Columbus Day rzThanksgiving Day r6z#Birthday of Martin Luther King, Jr.i)rBrSrTrUzWashington's Birthdayz Good Fridayz Easter MondayceZdZdZedddeeeeedddde ed d d ee e ed ddee edddeg Z y)USFederalHolidayCalendara US Federal Government holiday calendar. The rules follow the federal holiday schedule published by the US Office of Personnel Management: https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/ Holidays that land on a weekend are observed on the nearest weekday. Pass an instance as the ``calendar`` argument of :class:`~pandas.tseries.offsets.CustomBusinessDay` to skip these dates in business day arithmetic. 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. See Also -------- tseries.holiday.AbstractHolidayCalendar : Abstract interface to create holidays following certain rules. tseries.holiday.nearest_workday : Move Saturday to Friday and Sunday to Monday. tseries.holiday.get_calendar : Return an instance of a calendar based on its name. Examples -------- >>> from pandas.tseries.holiday import USFederalHolidayCalendar >>> USFederalHolidayCalendar().holidays(start="2024-06-01", end="2024-07-31") DatetimeIndex(['2024-06-19', '2024-07-04'], dtype='datetime64[us]', freq=None) zNew Year's Dayr)rSrTrVz$Juneteenth National Independence Dayrz 2021-06-18)rSrTrBrVzIndependence Dayr6z Veterans Dayrz Christmas DayrN) rrrrrAr2USMartinLutherKingJrUSPresidentsDay USMemorialDay USLaborDay USColumbusDayUSThanksgivingDayrrbr'r$rrsv!H  q_M 2#&   "!Obb_MrroN# Er'rcTtj||}t||f||d}|S)a Create a holiday calendar class from two sets of rules. The rules of ``base`` and ``other`` are merged by holiday name, with ``base`` winning any clash, and the result becomes the ``rules`` of a new calendar class. That class registers itself under ``name``, so :func:`~pandas.tseries.holiday.get_calendar` can find it later. Parameters ---------- name : str Name of the calendar class to create. base : AbstractHolidayCalendar Instance/subclass or array of Holiday objects whose rules take precedence. other : AbstractHolidayCalendar Instance/subclass or array of Holiday objects to merge into ``base``. base_class : type, default AbstractHolidayCalendar The class the new calendar class inherits from. Returns ------- type A new subclass of ``base_class`` holding the merged rules. See Also -------- tseries.holiday.AbstractHolidayCalendar.merge_class : Merge holiday calendars together. tseries.holiday.get_calendar : Return an instance of a calendar based on its name. tseries.holiday.register : Add a holiday calendar class to the registry of named calendars. Examples -------- >>> from pandas.tseries.holiday import ( ... AbstractHolidayCalendar, ... HolidayCalendarFactory, ... USLaborDay, ... USMemorialDay, ... ) >>> class MyCalendar(AbstractHolidayCalendar): ... rules = [USMemorialDay] >>> NewCalendar = HolidayCalendarFactory("NewCalendar", MyCalendar, USLaborDay) >>> [rule.name for rule in NewCalendar.rules] ['Labor Day', 'Memorial Day'] r)rrr)rQrr base_classrrs r$HolidayCalendarFactoryrs2b $ / /e rs" 2, (&R*Z%P$N&R&R'T'T"1J!-Hood ?A;@&"R-%`tQ(@Qh!Jr"v,F [qBqE9R S "!Jr!u,E ba 2a50I)a#  be $ 1!Jr!u4M]!FHc"g;N O aQ#a&?QR 666r?V3l r'