jNddlmZddlmZmZddlmZmZddlZddl m Z ddl m Z mZmZmZmZmZddlmZddlmZmZmZdd lmZdd lmZdd lmZdd lm Z dd l!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;eddiddiZ?dZ@e5dddge"jAe"de5dge"edGd d!e0ZBed d(d)d'ZCdS)*) annotations)datetime timedelta) TYPE_CHECKINGSelfN)index) BaseOffsetDayNaTPeriod ResolutionTick)OFFSET_TO_PERIOD_FREQSTR)cache_readonlydoc set_module) is_integer) PeriodDtype) ABCSeries)is_valid_na_for_dtype) PeriodArray period_arrayraise_on_incompatiblevalidate_dtype_freq)maybe_extract_name)DatetimeIndexOpsMixin) DatetimeIndexIndex) inherit_names)Hashable)DtypeDtypeObjnpt target_klasszPeriodIndex or list of Periodsklassrc |d}|jdkrD|dd}t|}t||}|j|fi|S||fi|S)Ndataint64freqdtype)popr+rr _simple_new)clsdvaluesr)r+s HC:\Projects\DSCons\.venv\Lib\site-packages\pandas\core\indexes\period.py_new_PeriodIndexr2Fs UU6]]F |wuuVT""D!!V5111sv+++++s6Qstrftime start_timeend_timeT)wrap is_leap_yearpandasc $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)^ PeriodIndexa9 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. freq : str or period object, optional One of pandas period strings or corresponding objects. dtype : str or PeriodDtype, default None A dtype from which to extract a freq. copy : bool, default None Whether to copy input data, only relevant for array, Series, and Index inputs (for other input, e.g. a list, a new array is created anyway). Defaults to True for array input and False for Index/Series. Set to False to avoid copying array input at your own risk (if you know the input data won't be modified elsewhere). Set to True to force copying Series/Index input up front. name : str, default None Name of the resulting PeriodIndex. 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 Raises ------ ValueError Passing the parameter data as a list without specifying either freq or dtype will raise a ValueError: "freq not specified and cannot be inferred" 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(data=["2000Q1", "2002Q3"], freq="Q") >>> idx PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]') periodindexr_datar r)rr+Treturntype[libindex.PeriodEngine]ctjSN)libindex PeriodEngineselfs r1 _engine_typezPeriodIndex._engine_types $$r3r c|jjSrA)r+_resolution_objrDs r1rHzPeriodIndex._resolution_objsz))r3zarrays.PeriodArray)other other_nameNEhowstrrc|j||}t|||jSNname)r=asfreqtyper-rQrEr)rLarrs r1rRzPeriodIndex.asfreqs<jc**Dzz%%c %:::r3startrcn|j||}tj||jSrO)r= to_timestamprr-rQrTs r1rXzPeriodIndex.to_timestamps1j%%dC00(49====r3rcDt|jj|jdSNFrQcopy)rr=hourrQrDs r1r]zPeriodIndex.hoursTZ_495AAAAr3cDt|jj|jdSrZ)rr=minuterQrDs r1r_zPeriodIndex.minute TZ&TYUCCCCr3cDt|jj|jdSrZ)rr=secondrQrDs r1rbzPeriodIndex.secondr`r3 Dtype | Noner\ bool | NonerQHashable | Nonecd}|s#t|ttfr|j}t |||}t ||}||||\}}|r0t||r |j|kr||}t||}|r| }| |||S)N)r'r))rQrefs) isinstancerr _referencesrr_maybe_copy_array_inputr)rRrr\r-)r.r'r)r+r\rQrgs r1__new__zPeriodIndex.__new__s $ 4%);<< $#D!$c22"5$//00tUCC d  %JtS)) %di4.?.?;;t$$DD111  99;;Dt$T:::r3)yearquartermonthdayr]r_rbr)c|||||||d} d| D} tj| |} || S)a  Construct a PeriodIndex from fields (year, month, day, etc.). Parameters ---------- year : int, array, or Series, default None Year for the PeriodIndex. quarter : int, array, or Series, default None Quarter for the PeriodIndex. month : int, array, or Series, default None Month for the PeriodIndex. day : int, array, or Series, default None Day for the PeriodIndex. hour : int, array, or Series, default None Hour for the PeriodIndex. minute : int, array, or Series, default None Minute for the PeriodIndex. second : int, array, or Series, default None Second for the PeriodIndex. freq : str or period object, optional One of pandas period strings or corresponding objects. Returns ------- PeriodIndex See Also -------- PeriodIndex.from_ordinals : Construct a PeriodIndex from ordinals. PeriodIndex.to_timestamp : Cast to DatetimeArray/Index. Examples -------- >>> idx = pd.PeriodIndex.from_fields(year=[2000, 2002], quarter=[1, 3]) >>> idx PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]') )rlrmrnror]r_rbci|] \}}||| SrA).0keyvalues r1 z+PeriodIndex.from_fields..=s#SSSeAR#uARARARr3)fieldsr))itemsr _from_fieldsr-) r.rlrmrnror]r_rbr)rwrUs r1 from_fieldszPeriodIndex.from_fieldsskf  TSv||~~SSS&f4@@@s###r3rPctj|tj}t|}t j||}|||S)aE Construct a PeriodIndex from ordinals. Parameters ---------- ordinals : array-like of int The period offsets from the proleptic Gregorian epoch. freq : str or period object One of pandas period strings or corresponding objects. name : str, default None Name of the resulting PeriodIndex. Returns ------- PeriodIndex See Also -------- PeriodIndex.from_fields : Construct a PeriodIndex from fields (year, month, day, etc.). PeriodIndex.to_timestamp : Cast to DatetimeArray/Index. Examples -------- >>> idx = pd.PeriodIndex.from_ordinals([-1, 0, 1], freq="Q") >>> idx PeriodIndex(['1969Q4', '1970Q1', '1970Q2'], dtype='period[Q-DEC]') r*rP)npasarrayr(rrr-)r.ordinalsr)rQr+r's r1 from_ordinalszPeriodIndex.from_ordinalsAsR<:hbh777D!!&xu===t$///r3npt.NDArray[np.object_]c8tj|tS)Nr*)r|r}objectrDs r1r0zPeriodIndex.valuesgsz$f----r3int | npt.NDArray[np.int64]ct|ttjttjfr>t|jttfr|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)rhrr| timedelta64rndarrayr)r r= _check_timedeltalike_freq_compatr basenrrint)rErIdeltas r1_maybe_convert_timedeltaz$PeriodIndex._maybe_convert_timedeltaks" eirzJ K K $)dC[11  CCEJJ  z * * zTY^++w'e44 4    eS)) ) ))L$D$///r3r"boolc|j|kS)zF Can we compare values of the given dtype to our own? r*)rEr+s r1_is_comparable_dtypez PeriodIndex._is_comparable_dtypeszU""r3wheremasknpt.NDArray[np.bool_] np.ndarrayct|trt|j|jd}n$t|tst dt ||S)z where : array of timestamps mask : np.ndarray[bool] Array of booleans where data is not NA. F)r)r\z6asof_locs `where` must be DatetimeIndex or PeriodIndex)rhrr;_valuesr) TypeErrorsuper asof_locs)rErr __class__s r1rzPeriodIndex.asof_locssn e] + + V DIEJJJEEE;// VTUU Uww  ---r3ct|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)lenis_monotonic_increasing ValueErrorasi8rall)rEr0s r1is_fullzPeriodIndex.is_fullsm t99>>4+ 7566 6fQRRj6#2#;.!388::;;;r3cdS)NperiodrrrDs r1 inferred_typezPeriodIndex.inferred_types xr3ct||}|j|jkr||}|SrA)r_convert_tolerancer+r)rE tolerancetargetrs r1rzPeriodIndex._convert_tolerancesF GG..y&AA : % %55i@@Ir3cL|}||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 rhrM_parse_with_resorKeyError_can_partial_date_slice_partial_date_slicerH_cast_partial_indexing_scalarr _disallow_mismatched_indexingrrget_loc)rErtorig_keyparsedresoerrs r1rzPeriodIndex.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#rtr NonecD|j|jkrt|dSrA)_dtyper+r)rErts r1rz)PeriodIndex._disallow_mismatched_indexings% : # #3--  $ #r3labelrcz t||j}n"#t$r}t||d}~wwxYw|S)Nr))r r)rr)rErrrs r1rz)PeriodIndex._cast_partial_indexing_scalarsQ +E 222FF + + +5//s * + s 838sidect|tr||}t||SrA)rhrrr_maybe_cast_slice_bound)rErrrs r1rz#PeriodIndex._maybe_cast_slice_boundsB eX & & >66u==Eww..ud;;;r3rrctj|j|j}t||}||jd||jdfS)NrrV)rLend)rget attr_abbrevr rRr))rErrr)ivs r1_parsed_string_to_boundsz$PeriodIndex._parsed_string_to_boundss['+D,NOO F & & & $) 11299TYE93R3RSSr3rperiodsrcZ|%tdt|jd||zS)Nz%`freq` argument is not supported for z.shift)rrS__name__)rErr)s r1shiftzPeriodIndex.shifts=  ST 8KSSS g~r3)r>r?)r>r )NrK)rLrMr>r)NrV)rLrMr>r)r>rNNNNN)r+rcr\rdrQrer>r)r>r)r>r)r>r)r+r"r>r)rrrrr>r)r>r)r>rM)rtr r>r)rrr>r )rrM)rr rr)rN)rrr>r)(r __module__ __qualname____doc___typ__annotations__r _data_cls!_supports_partial_string_indexingpropertyrFrrHrrR_shared_doc_kwargsrXr]fgetr_rbrk classmethodrzrr0rrrrrrrrrrrrr __classcell__)rs@r1r;r;RsLL\ DI(,% %%%X%***^* S"    ;;;;  ; S !"">>>>#">S  BBB XBS  !!DDD"!XDS  !!DDD"!XD " $ !;!;!;!;!;F   <$<$<$<$<$[<$|37 0 0 0 0 0[ 0J...X. 0 0 0 0D#### . . . . . . < < <X <X     <.<.<.|     S  677<<<<<87< TTTT  S  $%%&%r3r;r int | NonerQrer>cHtj|||dkrtd|,t|tst|tsd}t j||||\}}t|}t ||}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 A PeriodIndex of fixed frequency periods. See Also -------- date_range : Returns a fixed frequency DatetimeIndex. Period : Represents a period of time. PeriodIndex : Immutable ndarray holding ordinal values indicating regular periods in time. Notes ----- Of the three parameters: ``start``, ``end``, and ``periods``, exactly two must be specified. To learn more about the frequency strings, please see :ref:`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*Fr[) comcount_not_nonerrhr r_generate_rangerr;)rVrrr)rQr'r+s r1 period_ranger%sH %g..!33 ,    |Zv66|z#v?V?V|,UC$GGJD$   E t5 ) ) )D t$U 3 3 33r3r)rrrQrer>r;)D __future__rrrtypingrrnumpyr| pandas._libsrrBpandas._libs.tslibsr r r r r rpandas._libs.tslibs.dtypesrpandas.util._decoratorsrrrpandas.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.abcr pandas._typingr!r"r#dict_index_doc_kwargsupdaterr2 _field_opsr;rrrr3r1rs"""""" ******@????? 100000111111000000<<<<<< ! ((((((((((((777777BBBBBB877777((((((D011.*JKLLL ]    zCK,BC  -- HIIIII'II.- IX H    N4N4N4N4N4N4N4r3