o h"J@sddlmZddlmZmZddlmZddlZddlZddl m Z ddl m Z mZmZmZmZddlmZddlmZmZdd lmZdd lmZdd lmZdd lmZdd lm Z ddl!m"Z"m#Z#m$Z$m%Z%ddl&m'm(Z)ddl*m'm+m,Z-ddl*m.Z.ddl/m0Z0ddl1m2Z2m3Z3ddl4m5Z5erddl6m7Z7ddl8m9Z9m:Z:m;Z;mZ>e>?ddiddiZ@ddZAe5gde"jBe"dde5dge"Gdd d e0ZC     d(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 PeriodsklassrcKsV|d}|jdkr#|dd}t|}t||d}|j|fi|S||fi|S)Ndataint64freqdtype)popr(rr _simple_new)clsdvaluesr&r(r.L/var/www/html/env/lib/python3.10/site-packages/pandas/core/indexes/period.py_new_PeriodIndexDs    r0)strftime start_timeend_timeT)wrap is_leap_yearc seZdZUdZdZded<ded<ded<eZd Ze d_d d Z e d`ddZ e ejfdddedadbddZe ejdcddddZe e ejjdedd Ze e ejjded!d"Ze e ejjded#d$Z     % dfdgd+d,Zeddddddddd-dhd.d/Zedd0dhd1d2Ze did4d5Zdjd7d8Zdkd:d;Zdlfd@dA Ze dmdBdCZe dndDdEZfdFdGZdHdIZ dodMdNZ!dpdQdRZ"e e#j$dqfdTdU Z$drdXdYZ%e e#j&dsdtd]d^Z&Z'S)u 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]cCstjSN)libindex PeriodEngineselfr.r.r/ _engine_typeszPeriodIndex._engine_typer cCs|jjSr;)r(_resolution_objr>r.r.r/rAszPeriodIndex._resolution_objzpandas.arrays.PeriodArray)other other_nameNEhowstrr cCs"|j||}t|j||jdSNname)r8asfreqtyper*rIr?r&rEarrr.r.r/rJszPeriodIndex.asfreqstartrcCs|j||}tj||jdSrG)r8 to_timestamprr*rIrLr.r.r/rOszPeriodIndex.to_timestamprcCt|jj|jdSrG)rr8hourrIr>r.r.r/rQzPeriodIndex.hourcCrPrG)rr8minuterIr>r.r.r/rSrRzPeriodIndex.minutecCrPrG)rr8secondrIr>r.r.r/rTrRzPeriodIndex.secondF Dtype | NonecopyboolrIHashable | Nonec Kshd}d} |st|ttfr|j} t||s*ttt||} td| t |r7t j dt t d|durDt j dt t dt|||}|duri|duri|sY|d|jdi|d|ij}d}nQ|rw|durstdtd t||}|rt||r|j|kr||}|dur|durtj|tjd }t|}t||d }n|dur|durtd t||d }|r|}|j||| d S)N>dayrQyearmonthrSrTquarterz-__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&)rIrefsr.) isinstancerr _referencessetissubsetnextiter TypeErrorlenwarningswarn FutureWarningrr_raise_scalar_data_error from_fieldsr8 ValueErrorrr&rJnpasarrayr%rrrrVr*) r+r$ordinalr&r(rVrIfieldsvalid_field_setr^argumentr.r.r/__new__sT       zPeriodIndex.__new__)rZr\r[rYrQrSrTr&c Cs>|||||||d} dd| D} tj| |d} || S)N)rZr\r[rYrQrSrTcSsi|] \}}|dur||qSr;r.).0keyvaluer.r.r/ Wsz+PeriodIndex.from_fields..)rpr&)itemsr _from_fieldsr*) r+rZr\r[rYrQrSrTr&rprMr.r.r/rkAs  zPeriodIndex.from_fieldsrHcCs4tj|tjd}t|}tj||d}|j||dS)Nr'rH)rmrnr%rrr*)r+ordinalsr&rIr(r$r.r.r/ from_ordinals[szPeriodIndex.from_ordinalsnpt.NDArray[np.object_]cCstj|tdS)Nr')rmrnobjectr>r.r.r/r-eszPeriodIndex.valuesint | npt.NDArray[np.int64]cCst|ttjttjfrt|jtr|j|}|Sn!t|t r.|j |jj kr)|j St ||t |r;t|ts9J|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)r_rrm timedelta64r ndarrayr&r8 _check_timedeltalike_freq_compatrbasenrrint)r?rBdeltar.r.r/_maybe_convert_timedeltais     z$PeriodIndex._maybe_convert_timedeltarcCs |j|kS)zF Can we compare values of the given dtype to our own? r')r?r(r.r.r/_is_comparable_dtypes z PeriodIndex._is_comparable_dtypewheremasknpt.NDArray[np.bool_] np.ndarraycs<t|trt|j|jd}n t|tstdt||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)r_rr6_valuesr&resuper asof_locs)r?rr __class__r.r/rs  zPeriodIndex.asof_locscCsHt|dkrdS|jstd|j}t|dd|dddkS)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)rfis_monotonic_increasingrlasi8rWall)r?r-r.r.r/is_fulls $zPeriodIndex.is_fullcCsdS)Nperiodr.r>r.r.r/ inferred_typeszPeriodIndex.inferred_typecs(t||}|j|jkr||}|Sr;)r_convert_tolerancer(r)r? tolerancetargetrr.r/rs  zPeriodIndex._convert_tolerancec Cs(|}||t||jrt}nkt|traz ||\}}Wnty3}z td|d|d}~ww| |rRz| ||WStyQ}zt||d}~ww||j kr]| |}nt|t|t rl||nt|trw| |}nt|zt||WSty}zt||d}~ww)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(rr_rF_parse_with_resorlKeyError_can_partial_date_slice_partial_date_slicerA_cast_partial_indexing_scalarr _disallow_mismatched_indexingrrget_loc)r?ruorig_keyparsedresoerrr.r.r/rs@            zPeriodIndex.get_locrur NonecCs|j|jkr t|dSr;)_dtyper(r)r?rur.r.r/rs z)PeriodIndex._disallow_mismatched_indexinglabelrc Cs8z t||jd}W|Sty}zt||d}~ww)Nr)r r&rlr)r?rrrr.r.r/rs z)PeriodIndex._cast_partial_indexing_scalarsidecs"t|tr ||}t||Sr;)r_rrr_maybe_cast_slice_bound)r?rrrr.r/rs  z#PeriodIndex._maybe_cast_slice_boundrrcCs<t|j|j}t||d}|j|jdd|j|jddfS)NrrN)rEend)r get attr_abbrevr rJr&)r?rrr&ivr.r.r/_parsed_string_to_boundss  z$PeriodIndex._parsed_string_to_boundsrperiodsrcCs&|durtdt|jd||S)Nz%`freq` argument is not supported for z.shift)rerK__name__)r?rr&r.r.r/shifts zPeriodIndex.shift)r9r:)r9r )NrD)rErFr9r )NrN)rErFr9r)r9r)NNNNFN)r(rUrVrWrIrXr9r )r9r )r9r|)r9r~)r(rr9rW)rrrrr9r)r9rW)r9rF)rur r9r)rrr9r )rrF)rr rr)rN)rrr9r )(r __module__ __qualname____doc___typ__annotations__r _data_cls!_supports_partial_string_indexingpropertyr@r rArrJ_shared_doc_kwargsrOrQfgetrSrTrs classmethodrkr{r-rrrrrrrrrrrrr __classcell__r.r.rr/r6Ps \      W   "     >  r6r int | NonerIrXr9cCsnt|||dkr td|durt|tst|tsd}t||||\}}t|}t||d}t||dS)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'rH) comcount_not_nonerlr_r r_generate_rangerr6)rNrrr&rIr$r(r.r.r/ period_range#s8  r)NNNNN)rrrIrXr9r6)E __future__rrrtypingrrgnumpyrm pandas._libsrr<pandas._libs.tslibsrrr r r pandas._libs.tslibs.dtypesr pandas.util._decoratorsr rpandas.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._typingrrr r!dict_index_doc_kwargsupdaterr0 _field_opsr6rr.r.r.r/sZ                Q