]jSSKJr SSKJr SSKrSSKJrJrJrJ r J r J r J r SSK r SSKrSSKJrJr SSKJr SSKJrJrJrJrJrJrJrJrJ r J!r!J"r"J#r$J%r% SSK&J'r'J(r( SS K)J*r* SS K+J,r,J-r- SS K.J/r/J0r0J1r1J2r2J3r3 SS K4J5r5J6r6J7r7 SS K8J9r9J:r: SSK;JJ?r?J@r@JArAJBrB SSKCJDrD SSKEJFrG SSKHJIs JJrK \(a0SSKLJMrMJNrN SSKOJPrPJQrQJRrRJSrSJTrTJUrUJVrVJWrW SSK;JXrX SSKEJYrYJZrZ SSK[J\r\ \ "S\S9r]SS0r^S'S(Sjjr_\7"S5"SS\GR\$R55rbS)SjrcS*S+Sjjrd\ S,S j5re\ S-S!j5reS.S"jreS'S/S#jjrS0S1S$jjrfS2S3S%jjrgS4S&jrhg)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@^U4SjnTUlXl[U5$)Ncb>URRn[TURU5nU$N)dtype _dtype_coder$asi8)selfbaseresultnames V/home/mande/repo/quber/.venv/lib/python3.13/site-packages/pandas/core/arrays/period.pyf_field_accessor..frs)zz%%%dDIIt< )__name____doc__property)rN docstringrPs` rO_field_accessorrWqs  AJI A;rRz pandas.arrayscd^\rSrSr%SrSrSr\R"\ 5r \ 4r Sr S\S'Sr\SYS j5r/rS \S 'S /rS \S '/SQrS \S'/SQrS \S'\\-\-rS \S'/SQrS \S'S\S'SZS[Sjjr\S\Sj5r\SSS.S]Sjj5r\SS.S^Sjj5r\S_S`Sjj5r\S 5r\SaS!j5rSbS"jr ScS#jr!SdS$jr"\#SeS%j5r$\SfS&j5r%\SgS'j5r&ShSiS(jjr'S_S)jr(\)"S*S+5r*\)"S,S-5r+\)"S.S/5r,\)"S0S15r-\)"S2S35r.\)"S4S55r/\)"S6S75r0\0r1\)"S8S95r2\2r3\3r4\)"S:S;5=r5r6\)"SS?5r8\)"S@SA5r9\9r:\SjSBj5r;SkSlSCjjr"SX0\?DSESESF.D6SnSoSGjj5r@SpSqSHjjrASISSJ.SrSKjjrBSsStU4SMjjjrCSuSvSNjjrDSSSLSO.SwSPjjrESxSQjrFSySRjrGU4SSjrHSzSTjrISUrJSLSSV.S{U4SWjjjrKSXrLU=rM$)|rD|a 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"[U[5$rG) isinstancer,)xs rOPeriodArray.s ;BrRzCallable[[DtypeObj], bool]_is_recognized_dtype)rc[$rG)r#rKs rO _scalar_typePeriodArray._scalar_types rRz list[str] _other_ops is_leap_year _bool_ops) start_timeend_timefreq _object_ops)yearmonthdayhourminutesecond weekofyearweekdayweek dayofweek day_of_week dayofyear day_of_yearquarterqyear days_in_month daysinmonth _field_ops_datetimelike_ops)strftime to_timestampasfreq_datetimelike_methodsr,_dtypeNFcUb/[U5n[U[5(d[SUS35e[U[5(a2UR n[U[ U55(d [S5eO![U[5(a UR n[U[ U55(a>Ub$X!R:wa[XR5eURURp!U(d[R"USS9nO[R"USUS9nUc [S5e[![U5n["R$"XU5 g)NzInvalid dtype z for PeriodArrayzIncorrect dtypeint64rHrHcopyz-dtype is not specified and cannot be inferred)r*r\r, ValueErrorr/_valuestype TypeErrorr.rHraise_on_incompatiblerj_ndarraynpasarrayarrayr r__init__)rKvaluesrHrs rOrPeriodArray.__init__s   'Ee[11 >%8H!IJJ fi ( (^^Ffd4j11 1222 / /^^F fd4j ) ) Ull%:+FJJ??"OOV\\EZZg6FXXfG$?F =LM M[%(tU3rRc~Sn[U[R5(aURS:XdU5eU"XS9$)Nz Should be numpy array of type i8i8r)r\rndarrayrH)clsrrH assertion_msgs rO _simple_newPeriodArray._simple_news;; &"**--&,,$2FU UF6''rRrcUb [U5nU(a"[U[5(a URnOSn[X5(a/[ UR U5 U(aUR 5nU$[R"U[S9nU=(d [R"U5n[R"XT5n[U5nU"XbS9$)Nr) r*r\r,rjvalidate_dtype_freqrHrrrobject libperiod extract_freqextract_ordinals)rscalarsrHrrjperiodsordinalss rO_from_sequencePeriodArray._from_sequence s   'E Z{33::DD g # #  t 4!,,.N**WF36y--g6--g<D!8))rRrc"URXUS9$)Nr)r)rstringsrHrs rO_from_sequence_of_strings%PeriodArray._from_sequence_of_strings's!!'T!BBrRc[U[5(a[U5Rn[ XU5up[U5nU"XS9$)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)r\rr,_freqstrr)rdatarjtzrHs rO_from_datetime64PeriodArray._from_datetime64-sD dJ ' 't$--D)$b9 D!4%%rRc[R"U5nUb[R"U5nUcUb[ XX45upTXT4$[ S5e)Nz/Not enough parameters to construct Period range)dtlvalidate_periodsr#_maybe_convert_freq_get_ordinal_ranger)rstartendrrjsubarrs rO_generate_rangePeriodArray._generate_rangeBsX&&w/  --d3D  -e'HLF|NO OrRcT[SSU0UD6up2[U5nURX4S9$)Nrjr)_range_from_fieldsr,r)rfieldsrjrrHs rO _from_fieldsPeriodArray._from_fieldsPs1)>t>v> D!v33rRcU[La [R"UR5$[ XR 5(a1UR U5 [R"UR5$[SUS35e)Nz!'value' should be a Period. Got 'z ' instead.) rrr_valuer\rc_check_compatible_withordinalrrKvalues rO _unbox_scalarPeriodArray._unbox_scalar\se C<88ELL) ) 00 1 1  ' ' .88EMM* *@zRS SrRc([XRS9$)N)rj)r#rjrs rO_scalar_from_stringPeriodArray._scalar_from_stringise)),,rRcNU[LagURUR5 grG)r_require_matching_freqrjrKothers rOr"PeriodArray._check_compatible_withos C<  ##EJJ/rRcUR$rG)rrbs rOrHPeriodArray.dtypeys {{rRc.URR$)z3 Return the frequency object for this PeriodArray. rHrjrbs rOrjPeriodArray.freq~s zzrRc@[UR5R$rG)r,rjrrbs rOfreqstrPeriodArray.freqstrs499%...rRcUS:XayU(dS[R"URUS9nUR(a!UR 5nSUR lU$[R"URUS9$USLa [S5eU[:Xa UR)$[R"[U5[S9$)NrrFz:Unable to avoid copy while creating an array as requested.) rrrJ _readonlyviewflags writeablerrbool_isnanlistr)rKrHrrMs rO __array__PeriodArray.__array__s D=DIIU;>>#[[]F-2FLL* xx 77 5=L  D=KK< xxT &11rRcSSKnSSKJn UbURR U5(a)UR UR UR5US9$[X5(aAURUR:wa&[SURSURS35eO[SUS 35eU"UR5nUR UR UR5S S9nURRXE5$) z& Convert myself into a pyarrow Array. rN)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_integerrrr1r\rrjrr@ from_storage)rKrrr period_type storage_arrays rO__arrow_array__PeriodArray.__arrow_array__s L  }}''--}}T]]4}PPD22<<499,###'<<.TYYKqB-  ?vVL&dll3  dmm$))+G T %%22;NNrRrlaN 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') rma 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') rna 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') roa 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') rpa 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') rqa 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') rtav 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') rva( 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') rxa 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') ryah 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') rza 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 r{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') cT[[R"UR55$)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]) )rrrrlrbs rOrfPeriodArray.is_leap_years"bjj344rRcSSKJn [R"U5nURR S:XdUS:XaSnOSnUS:HnU(aeUS:XdURS:Xa'[ SSS 9[ SUS 9- nURS S 9U-$[ SUS 9nXR-RS S 9U- $Uc5URR5n[US5nURnUn O"[R"U5nURn URXS 9n [R "U R"U 5n UR$"XR&S 9n U R(U:XdeURR*S:Xa[,R."UR"5n [1U 5S:XaRU SnXR&R2:XaURU lU $US:XaURR U lU $U R7S 5n Ubo[9U5n[;U R[<5(aE[;U[<5(d0[ U5[ U RR>S9:XaXlU $)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)r>nsusEBD)unitr)howrinferdays) pandas.core.arraysr>rvalidate_end_aliasrjrLrrr_get_to_timestamp_baserrr#r_period_dtype_coderperiodarr_to_dt64arrrJrrHrrNlibalgos unique_deltaslen_n_freq _with_freqrr\rn)rKrjrr>rradjust freq_coderHrLnew_parrnew_datadtadiffsdiffs rOrPeriodArray.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 $IJrRc>[R"XRS9$)N)rrj)r# _from_ordinalrj)rKr]s rO _box_funcPeriodArray._box_funcgs##AII>>rR PeriodIndex)r other_namec[R"U5n[U[5(a&[ US5(a[ U5R n[R"U5nURRnURnURnUS:HnU(aXPRR-S- nOUn[XsXF5nUR (a["XR$'[ U5n ['U5"XS9$)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]') rrrr)rrr\rhasattrr,rr#rrrIrrJrHrr%_hasnarrr) rKrjrbase1base2rJrrrrHs rOrPeriodArray.asfreqjs\**3/ dJ ' 'GD:N,O,Ot$--D))$/ ''''yySj ZZ]]*Q.GG$WU@ ;;$(H[[ !D!Dz(00rRc4U(a[$SR$)Nz'{}')strformat)rKboxeds rO _formatterPeriodArray._formatters J}}rRr)na_rep date_formatc n[R"URURRX5$)z# actually format my specific types )rperiod_array_strftimerJrHrI)rKr%r&kwargss rO_format_native_types PeriodArray._format_native_typess, .. IItzz--v  rRTc>[U5nXR:XaU(dU$UR5$[U[5(aUR UR 5$[R"US5(d[U[5(aQ[USS5n[R"U5nUR5RU5RU5$[ TU]EXS9$)NMrr)r*rrr\r,rrjr is_np_dtyper+getattrr dtype_to_unitr tz_localizeas_unitsuperastype)rKrHrrr __class__s rOr4PeriodArray.astypesU# KK  yy{" e[ ) );;uzz* * ??5# & &*UO*L*Ld+B$$U+D$$&2226>>tD Dw~e~//rRcURU5RS5nURRS5nURXBUS9$)NM8[ns])sidesorter)_validate_setitem_valuerr searchsorted)rKrr9r:npvaluem8arrs rOr<PeriodArray.searchsortedsK ..u5::8D ""8,!!'V!DDrR)limit limit_arearcURS5nURXX4S9nU(a%[SURUR55$U$)Nr8)methodr@rArr)r_pad_or_backfillr rH)rKrCr@rArrrMs rOrDPeriodArray._pad_or_backfillsPii!%%:&   DJJ 78 8KrRcU[R[R4;deU[RLaU*n[UR[ R "USS95n[U5"X0RS9$)z Add or subtract array of integers. Parameters ---------- other : np.ndarray[int64] or int op : {operator.add, operator.sub} Returns ------- result : PeriodArray rr) operatoraddsubrrJrrrrH)rKrop res_valuess rO_addsub_int_array_or_scalar'PeriodArray._addsub_int_array_or_scalars`hllHLL1111  FE%diiE1NO Dz*JJ77rRc[U[5(ae[U[5(a$U[R"UR S5-$UR USS9 URUR [R5$)NrT)rL) r\rrr timedelta64r rrLrGrHrs rO _add_offsetPeriodArray._add_offsetsjeT**** eS ! !"..#66 6 ##E#5//FFrRc>[UR[[45(d [ X5e[ U5(a[ TU]U5$[U[5(a2[R"[URS9R5nO)[R"[U5R5nURU5$)z\ Parameters ---------- other : timedelta, Tick, np.timedelta64 Returns ------- PeriodArray r)r\rjrrrr1r3_add_timedeltalike_scalarrrrr asm8_add_timedelta_arraylike)rKrtdr5s rOrS%PeriodArray._add_timedeltalike_scalars$))dC[11'4 4 ;;74U; ; eS ! !I5773889BIe,112B,,R00rRcURR5(d[SUR35e[R"SURRS35n[ [R "U5USSS9n[UR[R "URS555n[U5"XPRS 9$![an[S5UeSnAff=f) zc Parameters ---------- other : TimedeltaArray or ndarray[timedelta64] Returns ------- PeriodArray z2Cannot add or subtract timedelta64[ns] dtype from m8[]FrHrround_okznCannot add/subtract timedelta-like from PeriodArray that is not an integer multiple of the PeriodArray's freq.Nrr) rH _is_tick_likerr _td64_unitrrrr"rrJrr)rKrrHdeltaerrrKs rOrU$PeriodArray._add_timedelta_arraylike4szz''))DTZZLQ 3tzz445Q78 ' 5!UUE&diiEJJt ? ?Ie,112BE"B >'eeTE 4 $$U++  >'4# = >s; C-- D7 DDskipnakeepdimsc >[TU]"U4X#S.UD6nU(a8[U[R5(aUR XPR S9$U$)Nrfr)r3_reducer\rrrrH)rKrNrgrhr)rMr5s rOrjPeriodArray._reducesMRfR6R  62::66&&vZZ&@ @ rRr)returnz type[Period]NF)rH Dtype | NonerrrlNone)rznpt.NDArray[np.int64]rHr,rlr)rHrnrrrlr)rHr=rrrlrrG)rlr)rdictrlr)rPeriod | NaTTyperlznp.int64)rr rlr#)rzPeriod | NaTType | PeriodArrayrlro)rlr,)rlr)rlr )NN)rHzNpDtype | Nonerz bool | Nonerlz np.ndarray)rlznpt.NDArray[np.bool_])Nr)rr rlr>)rlrq)Nr)rr rlr)F)r"rrlzCallable[[object], str])r%z str | floatrlznpt.NDArray[np.object_])T)rr)leftN)rz$NumpyValueArrayLike | ExtensionArrayr9zLiteral['left', 'right']r:zNumpySorter | Nonerlznpt.NDArray[np.intp] | np.intp) rCr8r@z int | NonerAz#Literal['inside', 'outside'] | Nonerrrlr)rznp.ndarray | intrJzCallable[[Any, Any], Any]rlr)rr)rz,TimedeltaArray | npt.NDArray[np.timedelta64]rlr)rNr rgrrhr)NrS __module__ __qualname____firstlineno__rT__array_priority___typrrr_internal_fill_valuer#_recognized_scalarsr`__annotations___infer_matchesrUrcrergrkr}r~rr classmethodrrrrrrrrrr&rHrjrrrrWrlrmrnrorprqrrrtrvrursrwrxryrzr{r|rfrrr'_shared_doc_kwargsrr#r*r4r<rDrLrPrSrUrdrj__static_attributes__ __classcell__)r5s@rOrDrD|s~4n D88D>!)84!N J *+Iy+?K?J &$. #;i#GyG'M9M  4:(%((  (( # * *  *  **6=BC .C6:C CC &&(  44 T T  T- 0 //AE2#22=2 24O<   D*   E"    C,   D$ F& F&! J( D! K.IG- I : G" ' * EX$ #MH K 55$mb? M M]}MC1NC1P (-$ $  002*0%) E3 E' E# E ( E"!:>   8    ,8%8+D8 8*G10#8A#8 #8J#,R,0%$(;?rRc|[U[R[45(dUcSnO[U[5(aN[ R "5 [ R"SS[S9 [U5RnSSS5 OK[U[[[45(a URnO[[!U55Rn[UR"5Rn[$R&"[)U5R*UWS9n[-U5$!,(df  Na=f)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)r\rrr0rwarningscatch_warningsfilterwarnings FutureWarningr,rr.rDr#rr rrjr!r!rrSr")rrrightrrmsgs rOrrs %"**&7899U] E: & &  $ $ &  # #;m %U+44J ' & ENK@ A A]] "9U#34<< 499%..H    J  (z C ! %%' &s 0D-- D;cp[USS5n[R"US5(a[R X5$[ U[ 5(a2[U5nUb"XR:XaU$URU5$U$[ U[R[[[45(d [U5n[R"U5nU(a [ U5nOSnURR S:Xa[#U5S:a [%S5eURR S;a=UR'[R(SS 9n[*R,"Xq5n[XS 9$[/U5nUc[*R0"U5n[ U5n[R3XS 9$) 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] rHNr-rPrz9PeriodIndex does not allow floating point in constructioniuFrr)r/r r.rDrr\r,rjrrrrtupler/rrHkindrrr4rr from_ordinalsr)rr) rrjr data_dtypeoutarrdatarHarrrs rO period_arrayrsgnw-J z3''++D77*k**$  & ::d# #  dRZZui@ A ADzjjG D!}}S S\A%5STT}}T!nnRXXEn2**35811  !D |%%d+  E  % %d % 88rRcgrGrrs rOrrsBErRcgrGrrs rOrrsLOrRcUb [USS9nUbV[U5n[U[5(d [ S5eUcUR nU$XR :wa [ S5eU$)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*r\r,rrjr"rs rOrrss* . U#%--89 9 <::D K ZZ '(PQ Q KrRcz[UR[R5(aURRS:wa[ SUR35eUcd[U[ 5(aUR URpO^[U[5(a!UR URRpO'[U[ [45(a UR n[UR5n[R"U5nURn[URS5XBUS9U4$)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)r\rHrrrr-rrjr/dtrr#rrc_dt64arr_to_periodarrr)rrjrrrLs rOrr?s, djj"(( + +tzz#/E= 566 | dH % %tyy$ i ( (tww||$ D8Y/ 0 0|| tzz *D  % %d +D  " "D !$))D/4$ G MMrRc[R"XU5S:wa [S5eUb[USS9nURnUb [ X5nUb [ X5n[ U[ 5n[ U[ 5nU(a,U(a%URUR:wa [S5eU[Ld U[La [S5eUc?U(a URnOU(a URnO [S5eURnUbX$-nUcE[R"URU- U-URS-U[RS 9nXs4$[R"URURU-U[RS 9nXs4$[R"URURS-U[RS 9nXs4$) NzOOf 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/endrr) comcount_not_nonerrr r#r\rjrrarangerr)rrrrjmult is_start_per is_end_perrs rOrrgs %g.!3 ,   .vv u# SeV,LC(J uzzSXX'=<== |scz899 | ::D 88DBC Cvv. =99 g%,ckkAot288D : 99 u}}w6BHHD :yy aRXXN :rRchUcSnUcSnUcSnUcSn/nUGbUc3[SSS9n[[[RR 5n OW[USS9n[ R"U5n U [[[RR 5:wa [S5eURn [X5up[XSS9HLup[R"XU 5up[ R"XSSSSSSU 5 nURU5 MN Os[USS9n[ R"U5n [XX4XV5n[USS06H7un nnnnnUR[ R"U UUUUUSSU 5 5 M9 [ R""U[ R$S 9U4$) NrrQTrzbase must equal FR_QTR)strictrr)rr intrFR_QTRrrfreq_to_dtype_codeAssertionErrorr_make_field_arraysziprquarter_to_myearperiod_ordinalappendrrr)rlrmryrnrorprqrjrrLryq calendar_yearcalendar_monthvalarraysmthdhmnss rOrrs | ~ ~ {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@rAr}rW DatelikeOps PeriodMixinrDrrrrrrrrRrOrs".6  ,2    97m:6  ]  OH#//9#8#8HHV !&T,0]9 6]9 (]9 ]9 ]9@ E E O O"B""L%N-%NP.d      .4#.4brR