+ xȇi^RIHt^RIHt^RIt^RIHtHtHtH t H t H t H t ^RI t ^RIt^RIHtHt^RIHt^RIHtHtHtHtHtHtHtHtH t H!t!H"t"H#t$H%t%^RI&H't'H(t(^R I)H*t*^R I+H,t,H-t-^R I.H/t/H0t0H1t1H2t2H3t3^R I4H5t5H6t6H7t7^R I8H9t9H:t:^RI;HH?t?H@t@HAtAHBtB^RICHDtD^RIEHFtG^RIHHIuHJtK]'d1^RILHMtMHNtN^RIOHPtPHQtQHRtRHStSHTtTHUtUHVtVHWtW^RI;HXtX^RIEHYtYHZtZ^RI[H\t\] !R]R7t]RR/t^R1RRllt_]7!R4!RR]GP]$P44tbRR ltcR2R!R"lltd] R#R$l4te] R%R&l4teR'R(lteR1R)R*lltR3R+R,lltfR4R-R.lltgR/R0lthR#)5) annotations) timedeltaN) TYPE_CHECKINGAnyLiteralSelfTypeVarcastoverload)algoslib) NDArrayBacked) BaseOffsetDayNaTNaTType Timedeltaadd_overflowsafeastype_overflowsafedt64arr_to_periodarrget_unit_from_dtypeiNaTparsingperiod to_offset) FreqGroupPeriodDtypeBase)isleapyear_arr)Tick delta_to_tick)DIFFERENT_FREQIncompatibleFrequencyPeriodget_period_field_arrperiod_asfreq_arr)cache_readonlydoc set_module) ensure_object pandas_dtype)DatetimeTZDtype PeriodDtype)ABCIndexABCPeriodIndex ABCSeriesABCTimedeltaArray)isna) datetimelike)CallableSequence) AnyArrayLikeDtypeDtypeObj FillnaOptionsNpDtype NumpySorterNumpyValueArrayLikenpt)ExtensionDtype) DatetimeArrayTimedeltaArray)ExtensionArray BaseOffsetT)boundklass PeriodArrayc V^8dQhRRRR/#)namestr docstringz str | None)formats"i/Users/max/.openclaw/workspace/postharvest/venv/lib/python3.14/site-packages/pandas/core/arrays/period.py __annotate__rMqs#*c@aV3RlpSVnWn\V4#)cb<VPPp\SVPV4pV#N)dtype _dtype_coder$asi8)selfbaseresultrGs& rLf_field_accessor..frs)zz%%%dDIIt< rN)__name____doc__property)rGrIrXsf& rL_field_accessorr]qs  AJI A;rNz pandas.arraysc:a]tRt^|t$RtRtRt]P!] 4t ] 3t Rt R]R&Rst]RRl4t.tR ]R &R .tR ]R &.RtOtR ]R &.RuOtR ]R&]],],tR ]R&.RvOtR ]R&R]R&RwR!R"llt]R#R$l4t]R%RR&R /R'R(ll4t]R&R /R)R*ll4t]RxR+R,ll4t]R-4t]R.R/l4tR0R1lt R2R3lt!R4R5lt"]#R6R7l4t$]R8R9l4t%]R:R;l4t&RyR<R=llt'RxR>lt(])!RR?4t*])!RR@4t+])!RRA4t,])!RRB4t-])!RRC4t.])!RRD4t/])!RRE4t0]0t1])!RRF4t2]2t3]3t4])!RRG4;t5t6])!RRH4t7])!RRI4t8])!RRJ4t9]9t:]RKRLl4t;RzRMRNllt!Rr/]?BRQRRRSRR/BR{RTRUll4t@R|RVRWlltARXRYRZR/R[R\lltBR}R^V3R_llltCR~R`RalltDRbRRcRR&R]/RdRelltERfRgltFRhRiltGV3RjltHRkRlltIRmtJRnR]RoR /RpV3RqllltKRrtLV;tM#)rDa Pandas ExtensionArray for storing Period data. Users should use :func:`~pandas.array` to create new instances. Parameters ---------- values : Union[PeriodArray, Series[period], ndarray[int], PeriodIndex] The data to store. These should be arrays that can be directly converted to ordinals without inference or copy (PeriodArray, ndarray[int64]), or a box around such an array (Series[period], PeriodIndex). dtype : PeriodDtype, optional A PeriodDtype instance from which to extract a `freq`. If both `freq` and `dtype` are specified, then the frequencies must match. copy : bool, default False Whether to copy the ordinals before storing. Attributes ---------- None Methods ------- None See Also -------- Period: Represents a period of time. PeriodIndex : Immutable Index for period data. period_range: Create a fixed-frequency PeriodArray. array: Construct a pandas array. Notes ----- There are two components to a PeriodArray - ordinals : integer ndarray - freq : pd.tseries.offsets.Offset The values are physically stored as a 1-D ndarray of integers. These are called "ordinals" and represent some kind of offset from a base. The `freq` indicates the span covered by each element of the array. All elements in the PeriodArray have the same `freq`. Examples -------- >>> pd.arrays.PeriodArray(pd.PeriodIndex(["2023-01-01", "2023-01-02"], freq="D")) ['2023-01-01', '2023-01-02'] Length: 2, dtype: period[D] i periodarrayc "\V\4#rQ) isinstancer,)xs&rLPeriodArray.s ;BrNzCallable[[DtypeObj], bool]_is_recognized_dtypecV^8dQhRR/#)rFreturnz type[Period]rJ)rKs"rLrMPeriodArray.__annotate__slrNc \#rQ)r#rUs&rL _scalar_typePeriodArray._scalar_types rNz list[str] _other_ops is_leap_year _bool_ops _object_opsyearmonthdayhourminutesecondweek day_of_week day_of_yearquarterqyear days_in_month _field_ops_datetimelike_ops_datetimelike_methodsr,_dtypeNFc$V^8dQhRRRRRR/#)rFrR Dtype | NonecopyboolrgNonerJ)rKs"rLrMrhs"44l44RV4rNc Ve1\V4p\V\4'g\RV R24h\V\4'd4VP p\V\ V44'g \R4hM"\V\4'd VP p\V\ V44'dAVe&W!P8wd\WP4hVPVPr!V'g\P!VRR7pM\P!VRVR7pVf \R4h\!\V4p\"P$!WV4R#)NzInvalid dtype z for PeriodArrayzIncorrect dtypeint64rRrRrz-dtype is not specified and cannot be inferred)r*rar, ValueErrorr/_valuestype TypeErrorr.rRraise_on_incompatiblefreq_ndarraynpasarrayarrayr r__init__)rUvaluesrRrs&&&&rLrPeriodArray.__init__s   'Ee[11 >%8H!IJJ fi ( (^^Ffd4j11 1222 / /^^F fd4j ) ) Ull%:+FJJ??"OOV\\EZZg6FXXfG$?F =LM M[%(tU3rNc$V^8dQhRRRRRR/#)rFrznpt.NDArray[np.int64]rRr,rgrrJ)rKs"rLrMrhs(((%((  (rNc Rp\V\P4'dVPR8XgQV4hV!WR7#)z Should be numpy array of type i8i8r)rarndarrayrR)clsrrR assertion_msgs&&& rL _simple_newPeriodArray._simple_news;; &"**--&,,$2FU UF6''rNrRrc$V^8dQhRRRRRR/#)rFrRrrrrgrrJ)rKs"rLrMrh s*** *  *  *rNc Ve \V4pV'd$\V\4'dVPpMRp\W4'd1\ VP V4V'dVP 4pV#\P!V\R7pT;'g\P!V4p\P!WT4p\V4pV!WbR7#)Nr) r*rar,rvalidate_dtype_freqrRrrrobject libperiod extract_freqextract_ordinals)rscalarsrRrrperiodsordinalss&&$$ rL_from_sequencePeriodArray._from_sequence s   'E Z{33::DD g # #  t 4!,,.N**WF366y--g6--g<D!8))rNc$V^8dQhRRRRRR/#)rFrRr=rrrgrrJ)rKs"rLrMrh(s)CC .C6:C CrNc (VPWVR7#)r)r)rstringsrRrs&&$$rL_from_sequence_of_strings%PeriodArray._from_sequence_of_strings's!!'T!BBrNcV^8dQhRR/#)rFrgrrJ)rKs"rLrMrh.s&&d&rNc \V\4'd\V4Pp\ WV4wr\V4pV!WR7#)z Construct a PeriodArray from a datetime64 array Parameters ---------- data : ndarray[datetime64[ns], datetime64[ns, tz]] freq : str or Tick tz : tzinfo, optional Returns ------- PeriodArray[freq] r)rarr,_freqstrr)rdatartzrRs&&&& rL_from_datetime64PeriodArray._from_datetime64-sD dJ ' 't$--D)$b9 D!4%%rNc \P!V4pVe\P!V4pVfVe\ WW44wrTWT3#\ R4h)Nz/Not enough parameters to construct Period range)dtlvalidate_periodsr#_maybe_convert_freq_get_ordinal_ranger)rstartendrrsubarrs&&&&& rL_generate_rangePeriodArray._generate_rangeBsX&&w/  --d3D  -e'HLF|NO OrNc V^8dQhRRRR/#)rFfieldsdictrgrrJ)rKs"rLrMrhQs44T4D4rNc Z\RRV/VBwr2\V4pVPW4R7#)rrrJ)_range_from_fieldsr,r)rrrrrRs&$$ rL _from_fieldsPeriodArray._from_fieldsPs1)>t>v> D!v33rNc V^8dQhRRRR/#)rFvaluePeriod | NaTTypergznp.int64rJ)rKs"rLrMrh\s" T T T  TrNc V\Jd!\P!VP4#\ WP 4'd2VP V4\P!VP4#\RV R24h)z!'value' should be a Period. Got 'z ' instead.) rrr_valuerark_check_compatible_withordinalrrUrs&&rL _unbox_scalarPeriodArray._unbox_scalar\se C<88ELL) ) 00 1 1  ' ' .88EMM* *@zRS SrNc V^8dQhRRRR/#)rFrrHrgr#rJ)rKs"rLrMrhis----rNc .\WPR7#))r)r#rrs&&rL_scalar_from_stringPeriodArray._scalar_from_stringise)),,rNc V^8dQhRRRR/#)rFotherzPeriod | NaTType | PeriodArrayrgrrJ)rKs"rLrMrhos00,J0t0rNc TV\JdR#VPVP4R#rQ)r_require_matching_freqrrUrs&&rLr"PeriodArray._check_compatible_withos C<  ##EJJ/rNcV^8dQhRR/#)rFrgr,rJ)rKs"rLrMrhzs{rNc VP#rQ)rrjs&rLrRPeriodArray.dtypeys {{rNcV^8dQhRR/#)rFrgrrJ)rKs"rLrMrhsjrNc .VPP#)z3 Return the frequency object for this PeriodArray. rRrrjs&rLrPeriodArray.freq~s zzrNcV^8dQhRR/#)rFrgrHrJ)rKs"rLrMrhs///rNc @\VP4P#rQ)r,rrrjs&rLfreqstrPeriodArray.freqstrs499%...rNc$V^8dQhRRRRRR/#)rFrRzNpDtype | Nonerz bool | Nonergz np.ndarrayrJ)rKs"rLrMrhs$22#22=2 2rNc VR8XdV'gX\P!VPVR7pVP'd"VP 4pRVP nV#\P!VPVR7#VRJd \R4hV\8XdVP(#\P!\V4\R7#)rrFz:Unable to avoid copy while creating an array as requested.) rrrT _readonlyviewflags writeablerrr_isnanlistr)rUrRrrWs&&& rL __array__PeriodArray.__array__s D=DIIU;>>>#[[]F-2FLL* xx 77 5=L  D=KK< xxT &11rNc .^RIp^RIHpVeVPP V4'd-VP VP VP4VR7#\W4'dCVPVP8wd'\RVP RVP R24hM\RV R24hV!VP4pVP VP VP4R R7pVPPWE4#) z& Convert myself into a pyarrow Array. N)ArrowPeriodType)maskrzENot supported to convert PeriodArray to array with different 'freq' (z vs )z)Not supported to convert PeriodArray to 'z' typer)pyarrow(pandas.core.arrays.arrow.extension_typesrtypes is_integerrrr1rarrrr@ from_storage)rUrrr period_type storage_arrays&& rL__arrow_array__PeriodArray.__arrow_array__s L  }}''--}}T]]4}PPD22<<499,###'<<.TYYKqB-  ?vVL&dll3  dmm$))+G T %%22;NNrNaN The year of the period. See Also -------- PeriodIndex.day_of_year : The ordinal day of the year. PeriodIndex.dayofyear : The ordinal day of the year. PeriodIndex.is_leap_year : Logical indicating if the date belongs to a leap year. PeriodIndex.weekofyear : The week ordinal of the year. PeriodIndex.year : The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y") >>> idx.year Index([2023, 2024, 2025], dtype='int64') a The month as January=1, December=12. See Also -------- PeriodIndex.days_in_month : The number of days in the month. PeriodIndex.daysinmonth : The number of days in the month. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.month Index([1, 2, 3], dtype='int64') a The days of the period. See Also -------- PeriodIndex.day_of_week : The day of the week with Monday=0, Sunday=6. PeriodIndex.day_of_year : The ordinal day of the year. PeriodIndex.dayofweek : The day of the week with Monday=0, Sunday=6. PeriodIndex.dayofyear : The ordinal day of the year. PeriodIndex.days_in_month : The number of days in the month. PeriodIndex.daysinmonth : The number of days in the month. PeriodIndex.weekday : The day of the week with Monday=0, Sunday=6. Examples -------- >>> idx = pd.PeriodIndex(['2020-01-31', '2020-02-28'], freq='D') >>> idx.day Index([31, 28], dtype='int64') a The hour of the period. See Also -------- PeriodIndex.minute : The minute of the period. PeriodIndex.second : The second of the period. PeriodIndex.to_timestamp : Cast to DatetimeArray/Index. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01 10:00", "2023-01-01 11:00"], freq='h') >>> idx.hour Index([10, 11], dtype='int64') a The minute of the period. See Also -------- PeriodIndex.hour : The hour of the period. PeriodIndex.second : The second of the period. PeriodIndex.to_timestamp : Cast to DatetimeArray/Index. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01 10:30:00", ... "2023-01-01 11:50:00"], freq='min') >>> idx.minute Index([30, 50], dtype='int64') a The second of the period. See Also -------- PeriodIndex.hour : The hour of the period. PeriodIndex.minute : The minute of the period. PeriodIndex.to_timestamp : Cast to DatetimeArray/Index. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01 10:00:30", ... "2023-01-01 10:00:31"], freq='s') >>> idx.second Index([30, 31], dtype='int64') av The week ordinal of the year. See Also -------- PeriodIndex.day_of_week : The day of the week with Monday=0, Sunday=6. PeriodIndex.dayofweek : The day of the week with Monday=0, Sunday=6. PeriodIndex.week : The week ordinal of the year. PeriodIndex.weekday : The day of the week with Monday=0, Sunday=6. PeriodIndex.year : The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.week # It can be written `weekofyear` Index([5, 9, 13], dtype='int64') a( The day of the week with Monday=0, Sunday=6. See Also -------- PeriodIndex.day : The days of the period. PeriodIndex.day_of_week : The day of the week with Monday=0, Sunday=6. PeriodIndex.day_of_year : The ordinal day of the year. PeriodIndex.dayofweek : The day of the week with Monday=0, Sunday=6. PeriodIndex.dayofyear : The ordinal day of the year. PeriodIndex.week : The week ordinal of the year. PeriodIndex.weekday : The day of the week with Monday=0, Sunday=6. PeriodIndex.weekofyear : The week ordinal of the year. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01", "2023-01-02", "2023-01-03"], freq="D") >>> idx.weekday Index([6, 0, 1], dtype='int64') a The ordinal day of the year. See Also -------- PeriodIndex.day : The days of the period. PeriodIndex.day_of_week : The day of the week with Monday=0, Sunday=6. PeriodIndex.day_of_year : The ordinal day of the year. PeriodIndex.dayofweek : The day of the week with Monday=0, Sunday=6. PeriodIndex.dayofyear : The ordinal day of the year. PeriodIndex.weekday : The day of the week with Monday=0, Sunday=6. PeriodIndex.weekofyear : The week ordinal of the year. PeriodIndex.year : The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-10", "2023-02-01", "2023-03-01"], freq="D") >>> idx.dayofyear Index([10, 32, 60], dtype='int64') >>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y") >>> idx PeriodIndex(['2023', '2024', '2025'], dtype='period[Y-DEC]') >>> idx.dayofyear Index([365, 366, 365], dtype='int64') ah The quarter of the date. See Also -------- PeriodIndex.qyear : Fiscal year the Period lies in according to its starting-quarter. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.quarter Index([1, 1, 1], dtype='int64') a Fiscal year the Period lies in according to its starting-quarter. The `year` and the `qyear` of the period will be the same if the fiscal and calendar years are the same. When they are not, the fiscal year can be different from the calendar year of the period. Returns ------- int The fiscal year of the period. See Also -------- PeriodIndex.quarter : The quarter of the date. PeriodIndex.year : The year of the period. Examples -------- If the natural and fiscal year are the same, `qyear` and `year` will be the same. >>> per = pd.Period('2018Q1', freq='Q') >>> per.qyear 2018 >>> per.year 2018 If the fiscal year starts in April (`Q-MAR`), the first quarter of 2018 will start in April 2017. `year` will then be 2017, but `qyear` will be the fiscal year, 2018. >>> per = pd.Period('2018Q1', freq='Q-MAR') >>> per.start_time Timestamp('2017-04-01 00:00:00') >>> per.qyear 2018 >>> per.year 2017 a The number of days in the month. See Also -------- PeriodIndex.day : The days of the period. PeriodIndex.days_in_month : The number of days in the month. PeriodIndex.daysinmonth : The number of days in the month. PeriodIndex.month : The month as January=1, December=12. Examples -------- For Series: >>> period = pd.period_range('2020-1-1 00:00', '2020-3-1 00:00', freq='M') >>> s = pd.Series(period) >>> s 0 2020-01 1 2020-02 2 2020-03 dtype: period[M] >>> s.dt.days_in_month 0 31 1 29 2 31 dtype: int64 For PeriodIndex: >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.days_in_month # It can be also entered as `daysinmonth` Index([31, 28, 31], dtype='int64') cV^8dQhRR/#)rFrgznpt.NDArray[np.bool_]rJ)rKs"rLrMrhs5535rNc T\\P!VP44#)aR Logical indicating if the date belongs to a leap year. See Also -------- PeriodIndex.qyear : Fiscal year the Period lies in according to its starting-quarter. PeriodIndex.year : The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y") >>> idx.is_leap_year array([False, True, False]) )rrrrqrjs&rLrnPeriodArray.is_leap_years"bjj344rNc V^8dQhRRRR/#)rFhowrHrgr>rJ)rKs"rLrMrhsmm3m]mrNc ^RIHp\P!V4pVPP R8XgVR8XdRpMRpVR8HpV'dVR8XgVPR8Xd9\ ^RR7\ ^VR7, pVPRR 7V,#\ ^VR7pWP,PRR 7V, #Vf6VPP4p\V^4pVPpTp M"\P!V4pVPp VPWR 7p \P !V P"V 4p VP$!WP&R 7p V P(V8XgQhVPP*R8Xd\,P.!VP"4p \1V 4^8XdYV ^,pWP&P28XdVPV nV #V^8XdVPP V nV #V P7R 4p Vev\9V4p\;V P\<4'dK\;V\<4'g5\ V4\ V PP>R 78XdWnV #) ap Cast to DatetimeArray/Index. If possible, gives microsecond-unit DatetimeArray/Index. Otherwise gives nanosecond unit. Parameters ---------- freq : str or DateOffset, optional Target frequency. The default is 'D' for week or longer, 's' otherwise. how : {'s', 'e', 'start', 'end'} Whether to use the start or end of the time period being converted. Returns ------- DatetimeArray/Index Timestamp representation of given Period-like object. See Also -------- PeriodIndex.day : The days of the period. PeriodIndex.from_fields : Construct a PeriodIndex from fields (year, month, day, etc.). PeriodIndex.from_ordinals : Construct a PeriodIndex from ordinals. PeriodIndex.hour : The hour of the period. PeriodIndex.minute : The minute of the period. PeriodIndex.month : The month as January=1, December=12. PeriodIndex.second : The second of the period. PeriodIndex.year : The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.to_timestamp() DatetimeIndex(['2023-01-01', '2023-02-01', '2023-03-01'], dtype='datetime64[us]', freq='MS') The frequency will not be inferred if the index contains less than three elements, or if the values of index are not strictly monotonic: >>> idx = pd.PeriodIndex(["2023-01", "2023-02"], freq="M") >>> idx.to_timestamp() DatetimeIndex(['2023-01-01', '2023-02-01'], dtype='datetime64[us]', freq=None) >>> idx = pd.PeriodIndex( ... ["2023-01", "2023-02", "2023-02", "2023-03"], freq="2M" ... ) >>> idx.to_timestamp() DatetimeIndex(['2023-01-01', '2023-02-01', '2023-02-01', '2023-03-01'], dtype='datetime64[us]', freq=None) )r>nsusEBD)unitr)rrinferdays) pandas.core.arraysr>rvalidate_end_aliasrrVr to_timestampr_get_to_timestamp_baserrr#r_period_dtype_codeasfreqperiodarr_to_dt64arrrTrrRr rGlibalgos unique_deltaslen_n_freq _with_freqrrarn)rUrrr>r radjust freq_coderRrVnew_parrnew_datadtadiffsdiffs&&& rLrPeriodArray.to_timestamps j 5**3/ 99>>T !TT\DDSj s{dii3."13/)AD2II((W(5>>"140yy(6676CfLL < ::>DD--d3D**D;;t;-11(--F**8>>Jxx4 99>>S **4995E5zQQx::==( $ CIJQY $ CIJ..)C sxx--&tS11!$9#((**+EE $IJrNcV^8dQhRR/#)rFrgrrJ)rKs"rLrMrhgs??.?rNc D\P!WPR7#))rr)r# _from_ordinalr)rUrbs&&rL _box_funcPeriodArray._box_funcgs##AII>>rNr PeriodIndex other_namec V^8dQhRRRR/#)rFrrHrgrrJ)rKs"rLrMrhksC1C1SC14C1rNc 0\P!V4p\V\4'd(\ VR4'd\ V4P p\P!V4pVPPpVPpVPpVR8HpV'd%WPPP,^, pMTp\WsWF4pVP 'd\"WP$&\ V4p \'V4!WR7#)a Convert the {klass} to the specified frequency `freq`. Equivalent to applying :meth:`pandas.Period.asfreq` with the given arguments to each :class:`~pandas.Period` in this {klass}. Parameters ---------- freq : str A frequency. how : str {{'E', 'S'}}, default 'E' Whether the elements should be aligned to the end or start within pa period. * 'E', 'END', or 'FINISH' for end, * 'S', 'START', or 'BEGIN' for start. January 31st ('END') vs. January 1st ('START') for example. Returns ------- {klass} The transformed {klass} with the new frequency. See Also -------- {other}.asfreq: Convert each Period in a {other_name} to the given frequency. Period.asfreq : Convert a :class:`~pandas.Period` object to the given frequency. Examples -------- >>> pidx = pd.period_range("2010-01-01", "2015-01-01", freq="Y") >>> pidx PeriodIndex(['2010', '2011', '2012', '2013', '2014', '2015'], dtype='period[Y-DEC]') >>> pidx.asfreq("M") PeriodIndex(['2010-12', '2011-12', '2012-12', '2013-12', '2014-12', '2015-12'], dtype='period[M]') >>> pidx.asfreq("M", how="S") PeriodIndex(['2010-01', '2011-01', '2012-01', '2013-01', '2014-01', '2015-01'], dtype='period[M]') rrr)rrrarhasattrr,rr#rrrSrrTrRrr%_hasnarrr) rUrrbase1base2rTrrrrRs &&& rLrPeriodArray.asfreqjs\**3/ dJ ' 'GD:N,O,Ot$--D))$/ ''''yySj ZZ]]*Q.GG$WU@ ;;;$(H[[ !D!Dz(00rNc V^8dQhRRRR/#)rFboxedrrgzCallable[[object], str]rJ)rKs"rLrMrhs1HrNc 6V'd\#RP#)z'{}')rHrK)rUr2s&&rL _formatterPeriodArray._formatters J}}rNna_repr date_formatc V^8dQhRRRR/#)rFr6z str | floatrgznpt.NDArray[np.object_]rJ)rKs"rLrMrhs  $  rNc n\P!VPVPPW4#)z# actually format my specific types )rperiod_array_strftimerTrRrS)rUr6r7kwargss&$$,rL_format_native_types PeriodArray._format_native_typess, .. IItzz--v  rNTcV^8dQhRR/#)rFrrrJ)rKs"rLrMrhs00$0rNc <\V4pWP8XdV'gV#VP4#\V\4'dVP VP 4#\P!VR4'g\V\4'dR\VRR4p\P!V4pVP4PV4PV4#\ SV`EWR7#)MrNr)r*rrrar,rrr is_np_dtyper+getattrr dtype_to_unitr tz_localizeas_unitsuperastype)rUrRrrr  __class__s&&& rLrHPeriodArray.astypesU# KK  yy{" e[ ) );;uzz* * ??5# & &*UO*L*Ld+B$$U+D$$&2226>>tD Dw~e~//rNc(V^8dQhRRRRRRRR/#) rFrz$NumpyValueArrayLike | ExtensionArraysidezLiteral['left', 'right']sorterzNumpySorter | Nonergznpt.NDArray[np.intp] | np.intprJ)rKs"rLrMrhs8 E E3 E' E# E ( ErNc VPV4PR4pVPPR4pVPWBVR7#)M8[ns])rLrM)_validate_setitem_valuerr searchsorted)rUrrLrMnpvaluem8arrs&&&& rLrQPeriodArray.searchsortedsK ..u5::8D ""8,!!'V!DDrNlimit limit_areac ,V^8dQhRRRRRRRRR R /#) rFmethodr8rUz int | NonerVz#Literal['inside', 'outside'] | NonerrrgrrJ)rKs"rLrMrhs>  8    rNc VPR4pVPWW4R7pV'd&\RVPVP44#V#)rO)rXrUrVrr)r_pad_or_backfillr rR)rUrXrUrVrrrWs&$$$$ rLrZPeriodArray._pad_or_backfillsPii!%%:&   DJJ 78 8KrNc$V^8dQhRRRRRR/#)rFrznp.ndarray | intopzCallable[[Any, Any], Any]rgrrJ)rKs"rLrMrhs$88%8+D8 8rNc V\P\P39gQhV\PJdV)p\VP\ P !VRR74p\V4!W0PR7#)z Add or subtract array of integers. Parameters ---------- other : np.ndarray[int64] or int op : {operator.add, operator.sub} Returns ------- result : PeriodArray rr) operatoraddsubrrTrrrrR)rUrr] res_valuess&&& rL_addsub_int_array_or_scalar'PeriodArray._addsub_int_array_or_scalars`hllHLL1111  FE%diiE1NO Dz*JJ77rNcV^8dQhRR/#)rFrrrJ)rKs"rLrMrhsGGGrNc (\V\4'dQh\V\4'd)V\P!VP R4,#VP VRR7VPVP \P4#)rT)rV) rarrr timedelta64rrrcr_r`rs&&rL _add_offsetPeriodArray._add_offsetsjeT**** eS ! !"..#66 6 ##E#5//FFrNc <\VP\\34'g \ W4h\ V4'd\ SV`V4#\V\4'd6\P!\VPR7P4pM)\P!\V4P4pVPV4#)z\ Parameters ---------- other : timedelta, Tick, np.timedelta64 Returns ------- PeriodArray r )rarrrrr1rG_add_timedeltalike_scalarrrrrasm8_add_timedelta_arraylike)rUrtdrIs&& rLrk%PeriodArray._add_timedeltalike_scalars$))dC[11'4 4 ;;74U; ; eS ! !I5773889BIe,112B,,R00rNc V^8dQhRRRR/#)rFrz,TimedeltaArray | npt.NDArray[np.timedelta64]rgrrJ)rKs"rLrMrh4s#8#8A#8 #8rNc VPP4'g\RVP 24h\P!RVPP R24p\ \P !V4VRRR7p\TP\P !TPR444p\T4!YPPR 7# \dp\R4ThRp?ii;i) zc Parameters ---------- other : TimedeltaArray or ndarray[timedelta64] Returns ------- PeriodArray z2Cannot add or subtract timedelta64[ns] dtype from m8[]FrRrround_okznCannot add/subtract timedelta-like from PeriodArray that is not an integer multiple of the PeriodArray's freq.Nrr) rR _is_tick_likerr _td64_unitrrrr"rrTrr)rUrrRdeltaerrrbs&& rLrm$PeriodArray._add_timedelta_arraylike4szz''))DTZZLQ 3tzz445Q78 ' 5!UUE&diiEJJt ? ?Ie,112BE"B >'eeTE 4 $$U++  >'4# = >s=C22 D= D  Dskipnakeepdimsc$V^8dQhRRRRRR/#)rFrGrHrrrrJ)rKs"rLrMrhs$$(;?rNc <\SV`!V3RVRV/VBpV'd=\V\P4'dVP WPP R7#V#)rrr)rG_reducerarrrrR)rUrGrrr;rWrIs&&$$, rLrPeriodArray._reducesRRfRxR6R  62::66&&vZZ&@ @ rNrJ)r) start_timeend_timer)rqrrrsrtrurv weekofyearweekdayrw dayofweekrx dayofyearryrzr{r| daysinmonth)strftimerrNFrQ)NN)Nr)Nr)F)T)leftN)NrZ __module__ __qualname____firstlineno__r[__array_priority___typrrr_internal_fill_valuer#_recognized_scalarsre__annotations___infer_matchesr\rkrmrorpr}r~rr classmethodrrrrrrrrrr&rRrrrrr]rqrrrsrtrurvrrwrxrrrryrzr{r|rrnrr&r'_shared_doc_kwargsrr4r<rHrQrZrcrhrkrmr}r__static_attributes__ __classcell__)rIs@rLrDrD|s4n D88D>!)84!N J *+Iy+?K?J &$. #;i#GyG'M9M  4:((*# *  **6C=BCC &&(  44 T- 0 //24O<   D*   E"    C,   D$ F& F&! J( D! K.IG- I : G" ' * EX$ #MH K 55$mb? M M]M}MC1NC1P  ', :> 00, E!  ;?   ,8*G10#8J#,P+/BGrNcV^8dQhRR/#)rFrgr"rJ)rKs"rLrMrMs!&!&*?!&rNc\V\P\34'gVfRpM\V\4'dZ\ P !4;_uu_4\ P!RR\R7\V4PpRRR4ML\V\\\34'dVPpM\\!V44Pp\VP"4Pp\$P&!\)V4P*VXR7p\-V4# +'giLf;i)a Helper function to render a consistent error message when raising IncompatibleFrequency. Parameters ---------- left : PeriodArray right : None, DateOffset, Period, ndarray, or timedelta-like Returns ------- IncompatibleFrequency Exception to be raised by the caller. NignorezPeriodDtype\[B\] is deprecated)category)rown_freq other_freq)rarrr0rwarningscatch_warningsfilterwarnings FutureWarningr,rr.rDr#rr rrr!rKrrZr")rrightrrmsgs&& rLrrs %"**&7899U] E: & &  $ $ & &  # #;m %U+44J ' & ENK@ A A]] "9U#34<< 499%..H    J  (z C ! %%' &s !3D?? E c(V^8dQhRRRRRRRR/#) rFrz,Sequence[Period | str | None] | AnyArrayLikerzstr | Tick | BaseOffset | NonerrrgrDrJ)rKs"rLrMrMs6]9]9 6]9 (]9 ]9 ]9rNc\VRR4p\P!VR4'd\P W4#\ V\ 4'd5\V4pVe$WP8XdV#VPV4#V#\ V\P\\\34'g \V4p\P!V4pV'd \ V4pMRpVPP R8Xd\#V4^8d \%R4hVPP R9dDVP'\P(RR7p\*P,!Wq4p\WR 7#\/V4pVf\*P0!V4p\ V4p\P3WR 7#) a Construct a new PeriodArray from a sequence of Period scalars. Parameters ---------- data : Sequence of Period objects A sequence of Period objects. These are required to all have the same ``freq.`` Missing values can be indicated by ``None`` or ``pandas.NaT``. freq : str, Tick, or Offset The frequency of every element of the array. This can be specified to avoid inferring the `freq` from `data`. copy : bool, default False Whether to ensure a copy of the data is made. Returns ------- PeriodArray See Also -------- PeriodArray pandas.PeriodIndex Examples -------- >>> period_array([pd.Period("2017", freq="Y"), pd.Period("2018", freq="Y")]) ['2017', '2018'] Length: 2, dtype: period[Y-DEC] >>> period_array([pd.Period("2017", freq="Y"), pd.Period("2018", freq="Y"), pd.NaT]) ['2017', '2018', 'NaT'] Length: 3, dtype: period[Y-DEC] Integers that look like years are handled >>> period_array([2000, 2001, 2002], freq="D") ['2000-01-01', '2001-01-01', '2002-01-01'] Length: 3, dtype: period[D] Datetime-like strings may also be passed >>> period_array(["2000-Q1", "2000-Q2", "2000-Q3", "2000-Q4"], freq="Q") ['2000Q1', '2000Q2', '2000Q3', '2000Q4'] Length: 4, dtype: period[Q-DEC] rRNr@rXz9PeriodIndex does not allow floating point in constructioniuFrAr)rCr rBrDrrar,rrrrrtupler/rrRkindrrrHrr from_ordinalsr)rr) rrr data_dtypeoutarrdatarRarrrs &&& rL period_arrayrsgnw-J z3''++D77*k**$  & ::d# #  dRZZui@ A ADzjjG D!}}S S\A%5STT}}T!nnRXXEn2**35811  !D |%%d+  E  % %d % 88rNc V^8dQhRRRR/#)rFrrArgrJ)rKs"rLrMrMsEE[E[ErNcR#rQrJrs&&rLrrsBErNc V^8dQhRRRR/#)rFrztimedelta | str | NonergrrJ)rKs"rLrMrMsOO%;O OrNcR#rQrJrs&&rLrrsLOrNc V^8dQhRRRR/#)rFrz1BaseOffsetT | BaseOffset | timedelta | str | NonergrArJ)rKs"rLrMrMs""B""rNcVe\VRR7pVeZ\V4p\V\4'g \ R4hVfVP pV#WP 8wd \ R4hV#)a< If both a dtype and a freq are available, ensure they match. If only dtype is available, extract the implied freq. Parameters ---------- dtype : dtype freq : DateOffset or None Returns ------- freq : DateOffset Raises ------ ValueError : non-period dtype IncompatibleFrequency : mismatch between dtype and freq T is_periodzdtype must be PeriodDtypez&specified freq and dtype are different)rr*rar,rrr"rs&&rLrrss* . U#%--89 9 <::D K ZZ '(PQ Q KrNcV^8dQhRR/#)rFrgz(tuple[npt.NDArray[np.int64], BaseOffset]rJ)rKs"rLrMrM?s%N%N-%NrNc\VP\P4'dVPPR8wd\ RVP 24hVfg\V\ 4'dVP VPrM`\V\4'd"VP VPPrM(\V\ \34'd VP p\VP4p\P!V4pVPp\VPR4WBVR7V3#)a Convert a datetime-like array to values Period ordinals. Parameters ---------- data : Union[Series[datetime64[ns]], DatetimeIndex, ndarray[datetime64ns]] freq : Optional[Union[str, Tick]] Must match the `freq` on the `data` if `data` is a DatetimeIndex or Series. tz : Optional[tzinfo] Returns ------- ordinals : ndarray[int64] freq : Tick The frequency extracted from the Series or DatetimeIndex if that's used. r@z Wrong dtype: r)reso)rarRrrrr-rrr/dtrr#rrc_dt64arr_to_periodarrr)rrrrrVs&&& rLrr?s, djj"(( + +tzz#/E= 566 | dH % %tyy$ i ( (tww||$ D8Y/ 0 0|| tzz *D  % %d +D  " "D !$))D/4$ G MMrNcV^8dQhRR/#)rFmultintrJ)rKs"rLrMrMgs...rNc\P!WV4^8wd \R4hVe\VRR7pVPpVe \ W4pVe \ W4p\ V\ 4p\ V\ 4pV'd/V'd'VPVP8wd \R4hV\Jg V\Jd \R4hVfBV'dVPpM V'dVPpM \R4hVPpVeW$,pVfU\P!VPV, V,VP^,V\PR7pWs3#\P!VPVPV,V\PR7pWs3#\P!VPVP^,V\PR7pWs3#)rFzOOf the three parameters: start, end, and periods, exactly two must be specifiedTrz!start and end must have same freqzstart and end must not be NaTz#Could not infer freq from start/endr) comcount_not_nonerrrr#rarrrarangerr)rrrrr is_start_per is_end_perrs&&&&& rLrrgs %g.!3 ,   .vv u# SeV,LC(J uzzSXX'=<== |scz899 | ::D 88DBC Cvv. =99 g%,ckkAot288D : 99 u}}w6BHHD :yy aRXXN :rNcV^8dQhRR/#)rFrgztuple[np.ndarray, BaseOffset]rJ)rKs"rLrMrMs.4.4#.4rNcVf^pVf^pVf^pVf^p.pVEe Vf7\RRR7p\\\PP 4p M[\VRR7p\ P!V4p V \\\PP 48wd \R4hVPp \W4wr\WRR7FLwr\P!WV 4wr\ P!W^^^^^^V 4 pVPV4KN Mv\VRR7p\ P!V4p \WW4WV4p\VRR/F7wp pppppVP\ P!V VVVVV^^V 4 4K9 \ P"!V\ P$R7V3#)NQTrzbase must equal FR_QTR)strictrr)rr rrFR_QTRrrfreq_to_dtype_codeAssertionErrorr_make_field_arraysziprquarter_to_myearperiod_ordinalappendrrr)rqrrrzrsrtrurvrrrVryq calendar_yearcalendar_monthvalarraysmthdhmnss&&&&&&&& rLrrs | ~ ~ {H <SD1DY--334DTT2D//5DtC!1!1!7!788$%=>>,,*49 d3DA,3,D,DQ7,S )M**q!Q1aC OOC 4.++D1#DFK#&#r?pandas.core.arrays.baser@rArr] DatelikeOps PeriodMixinrDrrrrrrrJrNrLrsK".6  ,2    97m:6  ]  OH#//9#8#8HHV !&P]9@ E E O O"J%NP.b.4brN