o 5caK@sddlmZddlmZmZddlmZddlZddlZddl m Z m Z ddl mZmZmZmZmZddlmZmZmZddlmZmZdd lmZdd lmZmZmZdd l m!Z!dd l"m#Z#dd l$m%Z%m&Z&m'Z'm(Z(ddl)m*m+Z,ddl-m*m.m/Z0ddl-m1Z1ddl2m3Z3ddl4m5Z5m6Z6ddl7m8Z8ddl9m:Z:e;e0j<ZddZ?e8gde%j@e%dde8ddge%Gddde3ZA d%d&d#d$ZBdS)') annotations)datetime timedelta)HashableN)indexlib) BaseOffsetNaTPeriod ResolutionTick)DtypeDtypeObjnpt)cache_readonlydoc)find_stack_level)is_datetime64_any_dtype is_integer pandas_dtype) PeriodDtype)is_valid_na_for_dtype) PeriodArray period_arrayraise_on_incompatiblevalidate_dtype_freq)maybe_extract_name)DatetimeIndexOpsMixin) DatetimeIndexIndex) inherit_names) Int64Index target_klasszPeriodIndex or list of PeriodsklassrcKsN|d}|jdkr|dd}t||d}|j|fi|S||fi|S)Ndataint64freqr&)popdtyper _simple_new)clsdvaluesr&r.P/var/www/html/gps/gps/lib/python3.10/site-packages/pandas/core/indexes/period.py_new_PeriodIndexDs    r0)strftime start_timeend_timeT)wrap is_leap_year_format_native_typescseZdZUdZdZded<ded<ded<eZd Ze dSd d Z e dTddZ e ejfdddedUdVddZe ejdWdXddZe e ejjdYddZe e ejjdYd d!Ze e ejjdYd"d#Z     $ dZd[d*d+Ze d\d-d.Zd]d0d1Zd^d3d4Zd_fd9d: Ze ejd ejfd`fd;d< Ze dad=d>Ze dbd?d@ZfdAdBZ dcdCdDZ!dddGdHZ"dIdJZ#e e$j%ejfdefdLdM Z%dfdQdRZ&Z'S)g 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 month : int, array, or Series, default None quarter : int, array, or Series, default None day : int, array, or Series, default None hour : int, array, or Series, default None minute : int, array, or Series, default None second : int, array, or Series, default None 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 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(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/rBszPeriodIndex._resolution_objzpandas.arrays.PeriodArray)other other_nameNEhowstrcCs"|j||}t|j||jdSNname)r9asfreqtyper*rJr@r&rFarrr.r.r/rKszPeriodIndex.asfreqstartrcCs|j||}tj||jdSrH)r9 to_timestamprr*rJrMr.r.r/rPszPeriodIndex.to_timestampr!cCt|jj|jdSrH)r!r9hourrJr?r.r.r/rRzPeriodIndex.hourcCrQrH)r!r9minuterJr?r.r.r/rTrSzPeriodIndex.minutecCrQrH)r!r9secondrJr?r.r.r/rUrSzPeriodIndex.secondF Dtype | NonecopyboolrJrc Ks hd}t||stt||d} td| t|||}|durE|durE|s1|dtddd||\}} | }t||d}n3t||}|r[t ||r[|j |kr[| |}|durr|durrt j |t jd}t||d}nt||d}|r~|}|j||dS)N>dayrRyearmonthrTrUquarterrz-__new__() got an unexpected keyword argument r'r))r$r&rI)setissubsetlist TypeErrorr_scalar_data_errorr_generate_ranger isinstancer&rKnpasarrayr%rrWr*) r+r$ordinalr&r)rWrJfieldsvalid_field_setargumentfreq2r.r.r/__new__s*       zPeriodIndex.__new__ np.ndarraycCstj|tdS)Nr])rerfobjectr?r.r.r/r-szPeriodIndex.valuesint | npt.NDArray[np.int64]cCsrt|ttjttjfrt|jtr|j|}|Snt|t r.|j |jj kr)|j St ||t |r4|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)rdrre timedelta64r ndarrayr&r9 _check_timedeltalike_freq_compatrbasenrr)r@rCdeltar.r.r/_maybe_convert_timedeltas     z$PeriodIndex._maybe_convert_timedeltarcCs2t|tsdS|j}|j}|j|jko|j|jkS)zF Can we compare values of the given dtype to our own? F)rdrr&_period_dtype_codert)r@r)r&own_freqr.r.r/_is_comparable_dtypeCs  z PeriodIndex._is_comparable_dtypewherermasknpt.NDArray[np.bool_]cs<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)rdrr7_valuesr&rasuper asof_locs)r@rzr{ __class__r.r/rYs  zPeriodIndex.asof_locscs`t|}|tjurtjdttdnd}t|r(t|dd}|j |d |St j ||dS)NzThe 'how' keyword in PeriodIndex.astype is deprecated and will be removed in a future version. Use index.to_timestamp(how=how) instead.) stacklevelrOtzrF)rW) rr no_defaultwarningswarn FutureWarningrrgetattrrP tz_localizer~astype)r@r)rWrFrrr.r/rfs  zPeriodIndex.astypecCsDt|dkrdS|jstd|j}|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)lenis_monotonic_increasing ValueErrorasi8all)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)rv)r@ tolerancetargetrr.r/rs  zPeriodIndex._convert_tolerancec CsR|}||t||jrt}n~t|trtz ||\}}Wnty3}z td|d|d}~ww| |rRz| ||WStyQ}zt||d}~ww||j krf| |}|j |||d}|S|durnt|| |}nt|tr||}nt|tr| |}nt|z t ||||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)methodr)_check_indexing_errorrr)r rdrG_parse_with_resorKeyError_can_partial_date_slice_partial_date_slicerB_cast_partial_indexing_scalarget_locr _maybe_cast_for_get_locrr) r@keyrrorig_keyparsedresoerrlocr.r.r/rsH             zPeriodIndex.get_locrr cCs0|j}|j}|j|jkr|j|jkst||Sr<)r&rtrwr)r@rsfreqkfreqr.r.r/rs  z#PeriodIndex._maybe_cast_for_get_locc Cs8z t||jd}W|Sty}zt||d}~ww)Nr')r r&rr)r@labelrrr.r.r/rs z)PeriodIndex._cast_partial_indexing_scalarsidecs&t|tr ||}tj|||dS)N)kind)rdrrr~_maybe_cast_slice_bound)r@rrrrr.r/rs  z#PeriodIndex._maybe_cast_slice_boundrrrcCs.t||jd}|j|jdd|j|jddfS)Nr'rOrend)r attr_abbrevrKr&)r@rrivr.r.r/_parsed_string_to_bounds s z$PeriodIndex._parsed_string_to_bounds)r:r;)r:r )NrE)rFrGr:r7)NrO)rFrGr:r)r:r!)NNNNFN)r)rVrWrXrJrr:r7)r:rm)r:ro)r)rr:rX)rzrr{r|r:rm)rWrX)r:rX)r:rG)NN)rr r:r )rrG)rr rr)(__name__ __module__ __qualname____doc___typ__annotations__r _data_cls!_supports_partial_string_indexingpropertyrArrBrrK_shared_doc_kwargsrPrRfgetrTrUrlr-rvryrrrrrrrrrrrrrr __classcell__r.r.rr/r7Osr E      B   $     Fr7periods int | Noner:cCsjt|||dkr td|durt|tst|tsd}tj||||id\}}t||d}t||dS)a Return a fixed frequency PeriodIndex. The day (calendar) is the default frequency. Parameters ---------- start : str or period-like, default None Left bound for generating periods. end : str 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 specifiedND)rhr'rI)comcount_not_nonerrdr rrcr7)rOrrr&rJr$r.r.r/ period_ranges4  r)NNNNN)rrr:r7)C __future__rrrtypingrrnumpyre pandas._libsrr=rpandas._libs.tslibsrr r r r pandas._typingr rrpandas.util._decoratorsrrpandas.util._exceptionsrpandas.core.dtypes.commonrrrpandas.core.dtypes.dtypesrpandas.core.dtypes.missingrpandas.core.arrays.periodrrrrpandas.core.commoncorecommonrpandas.core.indexes.baseindexesrsibaser pandas.core.indexes.datetimelikerpandas.core.indexes.datetimesrrpandas.core.indexes.extensionr pandas.core.indexes.numericr!dict_index_doc_kwargsupdaterr0 _field_opsr7rr.r.r.r/sL            =