E g"JJddlmZddlmZmZddlmZddlZddlZddl m Z ddl m Z mZmZmZmZddlmZddlmZmZdd lmZdd lmZdd lmZdd lmZdd lm Z ddl!m"Z"m#Z#m$Z$m%Z%ddl&m'cm(Z)ddl*m'cm+cm,Z-ddl*m.Z.ddl/m0Z0ddl1m2Z2m3Z3ddl4m5Z5erddl6m7Z7ddl8m9Z9m:Z:m;Z;mZ>e>?ddiddiZ@dZAe5gde"jBze"de5dge"Gdde0ZC d&d'd%ZDdS)() annotations)datetime timedelta) TYPE_CHECKINGN)index) BaseOffsetNaTPeriod ResolutionTick)OFFSET_TO_PERIOD_FREQSTR)cache_readonlydoc)find_stack_level) is_integer) PeriodDtype) ABCSeries)is_valid_na_for_dtype) PeriodArray period_arrayraise_on_incompatiblevalidate_dtype_freq)maybe_extract_name)DatetimeIndexOpsMixin) DatetimeIndexIndex) inherit_names)Hashable)DtypeDtypeObjSelfnpt target_klasszPeriodIndex or list of Periodsklassrc |d}|jdkrD|dd}t|}t||}|j|fi|S||fi|S)Ndataint64freqdtype)popr*rr _simple_new)clsdvaluesr(r*s O/var/www/sysmax/venv/lib/python3.11/site-packages/pandas/core/indexes/period.py_new_PeriodIndexr1Ds UU6]]F |wuuVT""D!!V5111sv+++++s6Q)strftime start_timeend_timeT)wrap is_leap_yearc &eZdZUdZdZded<ded<ded<eZd Ze dHd Z e dIdZ e ejfdddedJdKdZe ejdLdMdZe e ejjdNdZe e ejjdNdZe e ejjdNdZ dOdPd$Zeddddddddd%dQd&Zedd'dQd(Ze dRd*ZdSd,ZdTd.ZdUfd3 Ze dVd4Ze dWd5Zfd6Zd7Z dXd;Z!dYd>Z"e e#j$dZfd@ Z$d[dCZ%e e#j&d\d]dGZ&xZ'S)^ PeriodIndexa Immutable ndarray holding ordinal values indicating regular periods in time. Index keys are boxed to Period objects which carries the metadata (eg, frequency information). Parameters ---------- data : array-like (1d int np.ndarray or PeriodArray), optional Optional period-like data to construct index with. copy : bool Make a copy of input ndarray. freq : str or period object, optional One of pandas period strings or corresponding objects. year : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. month : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. quarter : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. day : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. hour : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. minute : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. second : int, array, or Series, default None .. deprecated:: 2.2.0 Use PeriodIndex.from_fields instead. dtype : str or PeriodDtype, default None Attributes ---------- day dayofweek day_of_week dayofyear day_of_year days_in_month daysinmonth end_time freq freqstr hour is_leap_year minute month quarter qyear second start_time week weekday weekofyear year Methods ------- asfreq strftime to_timestamp from_fields from_ordinals See Also -------- Index : The base pandas Index type. Period : Represents a period of time. DatetimeIndex : Index with datetime64 data. TimedeltaIndex : Index of timedelta64 data. period_range : Create a fixed-frequency PeriodIndex. Examples -------- >>> idx = pd.PeriodIndex.from_fields(year=[2000, 2002], quarter=[1, 3]) >>> idx PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]') periodindexr_datarr(rr*Treturntype[libindex.PeriodEngine]ctjSN)libindex PeriodEngineselfs r0 _engine_typezPeriodIndex._engine_types $$r2r c|jjSr?)r*_resolution_objrBs r0rFzPeriodIndex._resolution_objsz))r2zpandas.arrays.PeriodArray)other other_nameNEhowstrr!c|j||}t|||jSNname)r;asfreqtyper,rOrCr(rJarrs r0rPzPeriodIndex.asfreqs<jc**Dzz%%c %:::r2startrcn|j||}tj||jSrM)r; to_timestamprr,rOrRs r0rVzPeriodIndex.to_timestamps1j%%dC00(49====r2rcBt|jj|jSrM)rr;hourrOrBs r0rXzPeriodIndex.hoursTZ_495555r2cBt|jj|jSrM)rr;minuterOrBs r0rZzPeriodIndex.minuteTZ&TY7777r2cBt|jj|jSrM)rr;secondrOrBs r0r]zPeriodIndex.secondr[r2F Dtype | NonecopyboolrOHashable | Nonec Zhd}d} |s#t|ttfr|j} t ||s>t tt ||z } td| t|r(tj dtt|(tj dttt|||}|2|0|s|d|jdi|d|ij}d}n|r |t%dt%d t'||}|r0t||r |j|kr||}|C|At-j|t,j }t3|}t5|| }n$||t%d t7|| }|r|}|||| S)N>dayrXyearmonthrZr]quarterz-__new__() got an unexpected keyword argument zXConstructing PeriodIndex from fields is deprecated. Use PeriodIndex.from_fields instead.) stacklevelzThe 'ordinal' keyword in PeriodIndex is deprecated and will be removed in a future version. Use PeriodIndex.from_ordinals instead.r(Fz Cannot pass both data and fieldsz#Cannot pass both ordinal and fieldsr)z!Cannot pass both data and ordinal)r&r()rOrefs) isinstancerr _referencessetissubsetnextiter TypeErrorlenwarningswarn FutureWarningrr_raise_scalar_data_error from_fieldsr; ValueErrorrr(rPnpasarrayr'rrrr_r,) r-r&ordinalr(r*r_rOfieldsvalid_field_setrharguments r0__new__zPeriodIndex.__new__sv    $ 4%);<< $#D6{{##O44 DV!>??@@HVHVVWW W [[  M3+--        M+--     "$c22 z+PeriodIndex.from_fields..Ws#SSSeAR#uARARARr2)r{r()itemsr _from_fieldsr,) r-rdrfrercrXrZr]r(r{rSs r0rvzPeriodIndex.from_fieldsAsj  TSv||~~SSS&f4@@@s###r2rNctj|tj}t|}t j||}|||S)Nr)rN)rxryr'rrr,)r-ordinalsr(rOr*r&s r0 from_ordinalszPeriodIndex.from_ordinals[sP:hbh777D!!&xu===t$///r2npt.NDArray[np.object_]c8tj|tS)Nr))rxryobjectrBs r0r/zPeriodIndex.valuesesz$f----r2int | npt.NDArray[np.int64]ct|ttjttjfr7t|jtr|j|}|Snit|tr,|j |jj kr|j St||t|rt|tsJ|St|d)a Convert timedelta-like input to an integer multiple of self.freq Parameters ---------- other : timedelta, np.timedelta64, DateOffset, int, np.ndarray Returns ------- converted : int, np.ndarray[int64] Raises ------ IncompatibleFrequency : if the input cannot be written as a multiple of self.freq. Note IncompatibleFrequency subclasses ValueError. N)rjrrx timedelta64r ndarrayr(r; _check_timedeltalike_freq_compatrbasenrrint)rCrGdeltas r0_maybe_convert_timedeltaz$PeriodIndex._maybe_convert_timedeltais" eirzJ K K $)T**  CCEJJ  z * * zTY^++w'e44 4    eS)) ) ) )L$D$///r2r c|j|kS)zF Can we compare values of the given dtype to our own? r))rCr*s r0_is_comparable_dtypez PeriodIndex._is_comparable_dtypeszU""r2wheremasknpt.NDArray[np.bool_] np.ndarrayct|trt|j|j}n$t|tst dt ||S)z where : array of timestamps mask : np.ndarray[bool] Array of booleans where data is not NA. r(z6asof_locs `where` must be DatetimeIndex or PeriodIndex)rjrr9_valuesr(rpsuper asof_locs)rCrr __class__s r0rzPeriodIndex.asof_locssl e] + + V DI>>>EEE;// VTUU Uww  ---r2ct|dkrdS|jstd|j}t |dd|ddz dkS)z Returns True if this PeriodIndex is range-like in that all Periods between start and end are present, in order. rTzIndex is not monotonicN)rqis_monotonic_increasingrwasi8r`all)rCr/s r0is_fullzPeriodIndex.is_fullsm t99>>4+ 7566 6fQRRj6#2#;.!388::;;;r2cdS)NperiodrirBs r0 inferred_typezPeriodIndex.inferred_types xr2ct||}|j|jkr||}|Sr?)r_convert_tolerancer*r)rC tolerancetargetrs r0rzPeriodIndex._convert_tolerancesF GG..y&AA : % %55i@@Ir2cL|}||t||jr t}n8t |t r ||\}}n&#t$r}td|d|d}~wwxYw| |r9 | ||S#t$r}t||d}~wwxYw||j kr| |}ntt|t |tr||n:t |tr| |}nt| t!j||S#t$r}t||d}~wwxYw)a Get integer location for requested label. Parameters ---------- key : Period, NaT, str, or datetime String or datetime key must be parsable as Period. Returns ------- loc : int or ndarray[int64] Raises ------ KeyError Key is not present in the index. TypeError If key is listlike or otherwise not hashable. zCannot interpret 'z ' as periodN)_check_indexing_errorrr*r rjrK_parse_with_resorwKeyError_can_partial_date_slice_partial_date_slicerF_cast_partial_indexing_scalarr _disallow_mismatched_indexingrrget_loc)rCrorig_keyparsedresoerrs r0rzPeriodIndex.get_locs( ""3''' dj 1 1 CC S ! !  O#44S99  O O ODCDDDEE3N O++D11 1133D&AAA111"3--S01t+++88@@smm# V $ $  . .s 3 3 3 3 X & & 44S99CC3--  .=s++ + . . .8$$# - .sH A%% B/BB!B77 CCC/F F#FF#rr NonecD|j|jkrt|dSr?)_dtyper*r)rCrs r0rz)PeriodIndex._disallow_mismatched_indexings% : # #3--  $ #r2labelrcz t||j}n"#t$r}t||d}~wwxYw|S)Nr)r r(rwr)rCrrrs r0rz)PeriodIndex._cast_partial_indexing_scalarsQ +E 222FF + + +5//s * + s 838sidect|tr||}t||Sr?)rjrrr_maybe_cast_slice_bound)rCrrrs r0rz#PeriodIndex._maybe_cast_slice_boundsB eX & & >66u==Eww..ud;;;r2rrctj|j|j}t||}||jd||jdfS)NrrT)rJend)r get attr_abbrevr rPr()rCrrr(ivs r0_parsed_string_to_boundsz$PeriodIndex._parsed_string_to_boundss['+D,NOO F & & & $) 11299TYE93R3RSSr2rperiodsrcZ|%tdt|jd||zS)Nz%`freq` argument is not supported for z.shift)rprQ__name__)rCrr(s r0shiftzPeriodIndex.shifts=  ST 8KSSS g~r2)r<r=)r<r )NrI)rJrKr<r!)NrT)rJrKr<r)r<r)NNNNFN)r*r^r_r`rOrar<r!)r<r!)r<r)r<r)r*r r<r`)rrrrr<r)r<r`)r<rK)rr r<r)rrr<r )rrK)rr rr)rN)rrr<r!)(r __module__ __qualname____doc___typ__annotations__r _data_cls!_supports_partial_string_indexingpropertyrDrrFrrP_shared_doc_kwargsrVrXfgetrZr]r~ classmethodrvrr/rrrrrrrrrrrrr __classcell__)rs@r0r9r9PsZZx DI(,% %%%X%***^* S)    ;;;;  ; S !"">>>>#">S  666 X6S  !!888"!X8S  !!888"!X8 " $U;U;U;U;U;n   $$$$$[$23700000[0...X. 0 0 0 0D#### . . . . . . < < <X <X     <.<.<.|     S  677<<<<<87< TTTT  S  $%%&%r2r9r int | NonerOrar<cFtj|||dkrtd|,t|tst|tsd}t j||||\}}t|}t ||}t||S)a Return a fixed frequency PeriodIndex. The day (calendar) is the default frequency. Parameters ---------- start : str, datetime, date, pandas.Timestamp, or period-like, default None Left bound for generating periods. end : str, datetime, date, pandas.Timestamp, or period-like, default None Right bound for generating periods. periods : int, default None Number of periods to generate. freq : str or DateOffset, optional Frequency alias. By default the freq is taken from `start` or `end` if those are Period objects. Otherwise, the default is ``"D"`` for daily frequency. name : str, default None Name of the resulting PeriodIndex. Returns ------- PeriodIndex Notes ----- Of the three parameters: ``start``, ``end``, and ``periods``, exactly two must be specified. To learn more about the frequency strings, please see `this link `__. Examples -------- >>> pd.period_range(start='2017-01-01', end='2018-01-01', freq='M') PeriodIndex(['2017-01', '2017-02', '2017-03', '2017-04', '2017-05', '2017-06', '2017-07', '2017-08', '2017-09', '2017-10', '2017-11', '2017-12', '2018-01'], dtype='period[M]') If ``start`` or ``end`` are ``Period`` objects, they will be used as anchor endpoints for a ``PeriodIndex`` with frequency matching that of the ``period_range`` constructor. >>> pd.period_range(start=pd.Period('2017Q1', freq='Q'), ... end=pd.Period('2017Q2', freq='Q'), freq='M') PeriodIndex(['2017-03', '2017-04', '2017-05', '2017-06'], dtype='period[M]') rzOOf the three parameters: start, end, and periods, exactly two must be specifiedNDr)rN) comcount_not_nonerwrjr r_generate_rangerr9)rTrrr(rOr&r*s r0 period_ranger#sp %g..!33 ,    |Zv66|z#v?V?V|,UC$GGJD$   E t5 ) ) )D t$ ' ' ''r2)NNNNN)rrrOrar<r9)E __future__rrrtypingrrrnumpyrx pandas._libsrr@pandas._libs.tslibsrr r r r pandas._libs.tslibs.dtypesr pandas.util._decoratorsrrpandas.util._exceptionsrpandas.core.dtypes.commonrpandas.core.dtypes.dtypesrpandas.core.dtypes.genericrpandas.core.dtypes.missingrpandas.core.arrays.periodrrrrpandas.core.commoncorecommonrpandas.core.indexes.baseindexesribaser pandas.core.indexes.datetimelikerpandas.core.indexes.datetimesrrpandas.core.indexes.extensionrcollections.abcrpandas._typingrr r!r"dict_index_doc_kwargsupdaterr1 _field_opsr9rrir2r0rs""""""! ******@?????544444000000111111000000<<<<<< ! ((((((((((((777777BBBBBB877777((((((D011.*JKLLL ]    ***[-CC  --JJJJJ'JJ.-  J\    C(C(C(C(C(C(C(r2