+ xȇiKX^RIHt^RIHtHt^RIHtHt^RIt^RI H t ^RI H t HtHtHtHtHt^RIHt^RIHtHtHt^R IHt^R IHt^R IHt^R IH t ^R I!H"t"H#t#H$t$H%t%^RI&H'uH(t)^RI*H'uH+uH,t-^RI*H.t.^RI/H0t0^RI1H2t2H3t3^RI4H5t5]'d^RI6H7t7^RI8H9t9H:t:H;t;]R?lt&]!]$PN4RFR@RAll4t'RBt(V;t)#)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. 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+TcV^8dQhRR/#)returnztype[libindex.PeriodEngine])formats"r1 __annotate__PeriodIndex.__annotate__s%%9%r3c "\P#N)libindex PeriodEngineselfs&r1 _engine_typePeriodIndex._engine_types$$$r3cV^8dQhRR/#)r<r=r r>)r?s"r1r@rAs***r3c .VPP#rC)r+_resolution_objrFs&r1rLPeriodIndex._resolution_objszz)))r3otherzarrays.PeriodArray other_nameNc V^8dQhRRRR/#)r<howstrr=rr>)r?s"r1r@rAs;;S;4;r3c VPPW4p\V4PW0PR7#name)r:asfreqtyper-rVrGr)rQarrs&&& r1rWPeriodIndex.asfreqs4jj*Dz%%c %::r3c V^8dQhRRRR/#)r<rQrRr=rr>)r?s"r1r@rAs>>3>]>r3c zVPPW4p\P!W0PR7#rT)r: to_timestamprr-rVrYs&&& r1r^PeriodIndex.to_timestamps+jj%%d0((99==r3cV^8dQhRR/#r<r=rr>)r?s"r1r@rAsBBeBr3c Z\VPPVPRR7#FrVcopy)rr:hourrVrFs&r1rfPeriodIndex.hoursTZZ__4995AAr3cV^8dQhRR/#rar>)r?s"r1r@rADDDr3c Z\VPPVPRR7#rc)rr:minuterVrFs&r1rkPeriodIndex.minute!TZZ&&TYYUCCr3cV^8dQhRR/#rar>)r?s"r1r@rArir3c Z\VPPVPRR7#rc)rr:secondrVrFs&r1rpPeriodIndex.secondrmr3c(V^8dQhRRRRRRRR/#) r<r+z Dtype | Nonerez bool | NonerVHashable | Noner=rr>)r?s"r1r@rAs4!;!; !;  !;  !; !;r3c RpV'g)\V\\34'd VPp\ WQV4p\ W24pVP WV4wrV'd4\W4'd#VPV8wdVPV4p\WR7pV'dVP4pVPWVR7#)N)r'r))rVrefs) isinstancerr _referencesrr_maybe_copy_array_inputr)rWrrer-)r.r'r)r+rerVrus&&&&&& r1__new__PeriodIndex.__new__s 4%);<<##D!$c2"5/00UC  Jt))dii4.?;;t$D1 99;DtT::r3yearquartermonthdayrfrkrpcV^8dQhRR/#r<r=rr>)r?s"r1r@rAs<$<$ <$r3c RVRVRVRVRVRVRV/p V P4U U u/uF wrV fK WbK p p p \P!WR7p VPV 4#uup p i) 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]') r{r|r}r~rfrkrp)fieldsr))itemsr _from_fieldsr-) r.r{r|r}r~rfrkrpr)rkeyvaluerZs &$$$$$$$$ r1 from_fieldsPeriodIndex.from_fieldssxf D w U 3 D f f 06||~S~*#*~S&&f@s##Ts A"A"rVcV^8dQhRR/#rr>)r?s"r1r@rABs 0 0D 0r3c \P!V\PR7p\V4p\P !WR7pVP WSR7#)a 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*rU)npasarrayr(rrr-)r.ordinalsr)rVr+r's&&$$ r1 from_ordinalsPeriodIndex.from_ordinalsAsC<::hbhh7D!&&x=t//r3cV^8dQhRR/#)r<r=znpt.NDArray[np.object_]r>)r?s"r1r@rAhs../.r3c :\P!V\R7#)r*)rrobjectrFs&r1r0PeriodIndex.valuesgszz$f--r3cV^8dQhRR/#)r<r=zint | npt.NDArray[np.int64]r>)r?s"r1r@rAks 0 01L 0r3c \V\\P\\P 34'dE\VP \\34'dVPPV4pV#M}\V\4'd=VPVP P8Xd VP#\W4h\V4'd\V\4'gQhV#\VR4h)ae 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)rvrr timedelta64rndarrayr)r r: _check_timedeltalike_freq_compatr basenrrint)rGrNdeltas&& r1_maybe_convert_timedelta$PeriodIndex._maybe_convert_timedeltaks" eirzzJ K K$))dC[11 CCEJ 2z * *zzTYY^^+ww'4 4   eS)) ))L$D$//r3c V^8dQhRRRR/#)r<r+r"r=boolr>)r?s"r1r@rAs##(#t#r3c VPV8H#)z6 Can we compare values of the given dtype to our own? r*)rGr+s&&r1_is_comparable_dtype PeriodIndex._is_comparable_dtypeszzU""r3c$V^8dQhRRRRRR/#)r<wherermaskznpt.NDArray[np.bool_]r=z np.ndarrayr>)r?s"r1r@rAs" . .u .,A .j .r3c <\V\4'd$\VPVPRR7pM!\V\4'g \ R4h\ SV`W4#)za where : array of timestamps mask : np.ndarray[bool] Array of booleans where data is not NA. F)r)rez6asof_locs `where` must be DatetimeIndex or PeriodIndex)rvrr8_valuesr) TypeErrorsuper asof_locs)rGrr __class__s&&&r1rPeriodIndex.asof_locssQ e] + + DIIEJEE;//TU Uw --r3cV^8dQhRR/#)r<r=rr>)r?s"r1r@rAs < < +++56 6fRj6#2;.!388:;;r3cV^8dQhRR/#)r<r=rRr>)r?s"r1r@rAssr3c R#)periodr>rFs&r1 inferred_typePeriodIndex.inferred_typesr3c ~<\SV`W4pVPVP8XdVPV4pV#rC)r_convert_tolerancer+r)rG tolerancetargetrs&&&r1rPeriodIndex._convert_tolerances: G.yA :: %55i@Ir3c TpVPV4\WP4'd\pM\ V\ 4'dkVP V4wr4TPT4'dTPYC4#Y@P8XdTPT4pMf\T4h\ V\4'dVPV4M3\ V\4'dVPV4pM \V4h\ P"!W4# \dp\RT R24ThRp?ii;i \dp\T4ThRp?ii;i \dp\T4ThRp?ii;i)aC 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 rvrR_parse_with_resorKeyError_can_partial_date_slice_partial_date_slicerL_cast_partial_indexing_scalarr _disallow_mismatched_indexingrrget_loc)rGrorig_keyparsedresoerrs&& r1rPeriodIndex.get_locsa( ""3' jj 1 1C S ! ! O#44S9  ++D11133DAA+++88@sm# V $ $  . .s 3 X & &44S9C3-  .==+ +9 O!3C5 DE3N O 1"3-S01, .8$# - .sH D(8E E*( E3EE E' E""E'* F5 FFc V^8dQhRRRR/#)r<rr r=Noner>)r?s"r1r@rAs   D r3c RVPVP8wd \V4hR#rC)_dtyper+r)rGrs&&r1r)PeriodIndex._disallow_mismatched_indexings! :: #3-  $r3c V^8dQhRRRR/#)r<labelrr=r r>)r?s"r1r@rAs8r3c r\WPR7pV# \dp\T4ThRp?ii;i)r)N)r r)rr)rGrrrs&& r1r)PeriodIndex._cast_partial_indexing_scalars: +E 2F  +5/s * +s 6 16cV^8dQhRR/#)r<siderRr>)r?s"r1r@rAs<<3)r?s"r1r@rAsTTZTTr3c \P!VPVP4p\W#R7pVP VP RR7VP VP RR73#)rstart)rQend)rget attr_abbrevr rWr))rGrrr)ivs&&& r1_parsed_string_to_bounds$PeriodIndex._parsed_string_to_boundssW'++D,<,N>NO F & $)) 1299TYYE93RSSr3c V^8dQhRRRR/#)r<periodsrr=rr>)r?s"r1r@rAsSDr3c ^Ve#\R\V4P R24hW,#)Nz%`freq` argument is not supported for z.shift)rrX__name__)rGrr)s&&&r1shiftPeriodIndex.shifts6  7T 8K8K7LFS ~r3r>)NE)NrNNNNN)rN)*r __module__ __qualname____firstlineno____doc___typ__annotations__r _data_cls!_supports_partial_string_indexingpropertyrHrrLrrW_shared_doc_kwargsr^rffgetrkrpry classmethodrrr0rrrrrrrrrrrrr__static_attributes__ __classcell__)rs@r1r8r8RsqL\ D   I(,% %%** "!   ;  ;  ! !">#>    B B   !D"D   !D"D !;F<$<$ <$  <$  <$<$<$<$<$<$| 04 0 0J.. 0D# . . < < <.|   6 67<8< T   $ $%&r3r8c$V^8dQhRRRRRR/#)r<rz int | NonerVrsr=r8r>)r?s"r1r@r@&s/N4N4N4  N4  N4r3c.\P!WV4^8wd \R4hVf/\V\4'g\V\4'gRp\ P !WW#4wrS\V4p\ WVR7p\WTRR7#)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]') zOOf the three parameters: start, end, and periods, exactly two must be specifiedDr*Frd) comcount_not_nonerrvr r_generate_rangerr8)rrrr)rVr'r+s&&&&& r1 period_ranger%sH %g.!3 ,   |Zv66z#v?V?V,,UGJD  E t )D tU 33r3)strftime start_timeend_timer)D __future__rrrtypingrrnumpyr pandas._libsrrDpandas._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_opsr8rr>r3r1r$s(" *@ 110< ! ((7B8(001.*JKL ]  CK,B,BC  - HI'I. IX HN4N4r3