Mh4SSKJr SSKJr SSKrSSKJrJrJrJ r J r J r J r SSK r SSKrSSKJrJr SSKJr SSKJrJrJrJrJrJrJrJrJ r J!r!J"r#J$r$ SSK%J&r&J'r'J(r( SS K)J*r* SS K+J,r,J-r- SS K.J/r/J0r0J1r1J2r2J3r3 SS K4J5r5J6r6 SS K7J8r8 SSK9J:r:J;r; SSKr> SSK?J@r@JArAJBrBJCrC SSKDJErE SSKFJGrH SSKIJJs JKrL \(a(SSKMJNrN SSKOJPrPJQrQJRrRJSrSJTrTJUrUJVrVJWrW SSKFJXrXJYrY SSKZJ[r[ \ "S\S9r\SS0r]S&S'Sjjr^"SS\HR\#R5raS(SjrbS)S*Sjjrc\ S+Sj5rd\ S,S j5rdS-S!jrdS&S.S"jjrS/S0S#jjreS1S2S$jjrfS3S%jrgg)4) annotations) timedeltaN) TYPE_CHECKINGAnyCallableLiteralTypeVarcastoverload)algoslib) NDArrayBacked) BaseOffsetNaTNaTType Timedeltaadd_overflowsafeastype_overflowsafedt64arr_to_periodarrget_unit_from_dtypeiNaTparsingperiod to_offset) FreqGroupPeriodDtypeBasefreq_to_period_freqstr)isleapyear_arr)Tick delta_to_tick)DIFFERENT_FREQIncompatibleFrequencyPeriodget_period_field_arrperiod_asfreq_arr)cache_readonlydoc)find_stack_level) ensure_object pandas_dtype)DatetimeTZDtype PeriodDtype)ABCIndexABCPeriodIndex ABCSeriesABCTimedeltaArray)isna) datetimelike)Sequence) AnyArrayLikeDtype FillnaOptionsNpDtype NumpySorterNumpyValueArrayLikeSelfnpt) DatetimeArrayTimedeltaArray)ExtensionArray BaseOffsetT)boundklass PeriodArrayc@^U4SjnTUlXl[U5$)Ncb>URRn[TURU5nU$N)dtype _dtype_coder$asi8)selfbaseresultnames K/var/www/html/env/lib/python3.13/site-packages/pandas/core/arrays/period.pyf_field_accessor..fms)zz%%%dDIIt< )__name____doc__property)rL docstringrNs` rM_field_accessorrUls  AJI A;rPcb^\rSrSr%SrSrSr\R"\ 5r \ 4r Sr Sr\STSj5r/rS\S 'S /rS\S '/S QrS\S '/SQrS\S'\\-\-rS\S'/SQrS\S'S\S'SUSVSjjr\SWSj5r\SSS.SXSjj5r\SSS.SXSjj5r\SYSZSjj5r\S5r\S[Sj5rS\Sjr S]S jr!S^S!jr"\#S_S"j5r$\S`S#j5r%\SaS$j5r&SbScS%jjr'SYS&jr(\)"S'S(5r*\)"S)S*5r+\)"S+S,5r,\)"S-S.5r-\)"S/S05r.\)"S1S25r/\)"S3S45r0\0r1\)"S5S65r2\2r3\3r4\)"S7S85=r5r6\)"S9S:5r7\)"S;5r8\)"Sj5r;SeSfS?jjr"SS0\?DSASASB.D6ShSiSCjj5r@SjSkSDjjrASESSF.SlSGjjrBSmSnU4SIjjjrCSoSpSJjjrDSSSHSK.SqSLjjrESrSsU4SMjjjrFStSNjrGSuSOjrHU4SPjrISvSQjrJSRrKSSrLU=rM$)wrBya 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. freq : str or DateOffset The `freq` to use for the array. Mostly applicable when `values` is an ndarray of integers, when `freq` is required. When `values` is a PeriodArray (or box around), it's checked that ``values.freq`` matches `freq`. 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$rE) isinstancer,)xs rMPeriodArray.sZ ;&rP)rc[$rE)r#rIs rM _scalar_typePeriodArray._scalar_types rPz 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,_dtypeNFc.Ub8[R"S[[5S9 [ X#5n[ U5nUb/[ U5n[U[ 5(d[SUS35e[U[5(a2URn[U[U55(d [S5eO![U[5(a URn[U[U55(a>Ub$X!R:wa[XR 5eUR"URp!U(d[$R&"USS9nO[$R("USUS9nUc [S 5e[+[ U5n[,R."XU5 g) Nz}The 'freq' keyword in the PeriodArray constructor is deprecated and will be removed in a future version. Pass 'dtype' instead) stacklevelzInvalid dtype z for PeriodArrayzIncorrect dtypeint64rFrFcopyz-dtype is not specified and cannot be inferred)warningswarn FutureWarningr(validate_dtype_freqr,r*rZ ValueErrorr/_valuestype TypeErrorr.rFraise_on_incompatiblerg_ndarraynpasarrayarrayr r__init__)rIvaluesrFrgrs rMrPeriodArray.__init__sM   MMP+-   'u3D%E   'Ee[11 >%8H!IJJ fi ( (^^Ffd4j11 1222 / /^^F fd4j ) ) Ull%:+FJJ??"OOV\\EZZg6FXXfG$?F =LM M[%(tU3rPc~Sn[U[R5(aURS:XdU5eU"XS9$)Nz Should be numpy array of type i8i8r)rZrndarrayrF)clsrrF assertion_msgs rM _simple_newPeriodArray._simple_new s;; &"**--&,,$2FU UF6''rPrcUb [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*rZr,rgrrFrrrobject libperiod extract_freqextract_ordinals)rscalarsrFrrgperiodsordinalss rM_from_sequencePeriodArray._from_sequences   'E Z{33::DD g # #  t 4!,,.N**WF36y--g6--g<D!8))rPc"URXUS9$)Nr)r)rstringsrFrs rM_from_sequence_of_strings%PeriodArray._from_sequence_of_strings4s!!'T!BBrPc[U[5(a [URUR5n[ 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)rZrrnrLrr,)rdatargtzrFs rM_from_datetime64PeriodArray._from_datetime64:sH dJ ' ')$&&$))t>v> D!v33rPcU[La [R"UR5$[ XR 5(a1UR U5 [R"UR5$[SUS35e)Nz!'value' should be a Period. Got 'z ' instead.) rrr_valuerZr`_check_compatible_withordinalrrIvalues rM _unbox_scalarPeriodArray._unbox_scalarise C<88ELL) ) 00 1 1  ' ' .88EMM* *@zRS SrPc([XRS9$)N)rg)r#rgrs rM_scalar_from_stringPeriodArray._scalar_from_stringvse)),,rPcNU[LagURUR5 grE)r_require_matching_freqrgrIothers rMr"PeriodArray._check_compatible_with|s C<  ##EJJ/rPcUR$rE)rr_s rMrFPeriodArray.dtypes {{rPc.URR$)z3 Return the frequency object for this PeriodArray. rFrgr_s rMrgPeriodArray.freqs zzrPcj[URRURR5$rE)rrgrrLr_s rMfreqstrPeriodArray.freqstrs%diikk499>>BBrPcUS:Xa UR$U[:Xa UR)$[R"[ U5[ S9$)Nrr)rHbool_isnanrrlistr)rIrFrs rM __array__PeriodArray.__array__s? D=99  d]KK< xxT &11rPcSSKnSSKJn 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_integerrrr1rZrrgrr> from_storage)rIrrr period_type storage_arrays rM__arrow_array__PeriodArray.__arrow_array__s L  }}''--}}T]]4}PPD22<<499,###'<<.TYYKqB-  ?vVL&dll3  dmm$))+G T %%22;NNrPriz The year of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y") >>> idx.year Index([2023, 2024, 2025], dtype='int64') rjz The month as January=1, December=12. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.month Index([1, 2, 3], dtype='int64') rkz The days of the period. Examples -------- >>> idx = pd.PeriodIndex(['2020-01-31', '2020-02-28'], freq='D') >>> idx.day Index([31, 28], dtype='int64') rlz The hour of the period. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01 10:00", "2023-01-01 11:00"], freq='h') >>> idx.hour Index([10, 11], dtype='int64') rma  The minute of the period. 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') rna  The second of the period. 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') rqa The week ordinal of the year. 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') rsz The day of the week with Monday=0, Sunday=6. Examples -------- >>> idx = pd.PeriodIndex(["2023-01-01", "2023-01-02", "2023-01-03"], freq="D") >>> idx.weekday Index([6, 0, 1], dtype='int64') rua The ordinal day of the year. 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') rvz The quarter of the date. Examples -------- >>> idx = pd.PeriodIndex(["2023-01", "2023-02", "2023-03"], freq="M") >>> idx.quarter Index([1, 1, 1], dtype='int64') rwrxa The number of days in the month. 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$)z Logical indicating if the date belongs to a leap year. Examples -------- >>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y") >>> idx.is_leap_year array([False, True, False]) )rrrrir_s rMrcPeriodArray.is_leap_yearbsbjj344rPcSSKJn [R"U5nUS:HnU(akUS:XdURS:Xa+[ SS5[ SS5- nUR SS 9U-$[ SS5nXR-R SS 9U- $Uc5URR5n[US5nURnUnO"[R"U5nURnURXS 9n [R"U R U5n UR""U 5n URR$S:Xa[&R("UR 5n [+U 5S:XaRU Sn XR,R.:XaURU lU $U S:XaURR2U lU $U R5S 5$) a Cast to DatetimeArray/Index. 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 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[ns]', freq='MS') r)r<EBDnsr)howinfer)pandas.core.arraysr<rvalidate_end_aliasrgrr}r_get_to_timestamp_baser_freqstrr#r_period_dtype_coder~periodarr_to_dt64arrrHrrLlibalgos unique_deltaslenrF_n_freqrJ _with_freq)rIrgrr<radjust freq_coderFrJnew_parrnew_datadtadiffsdiffs rMr}PeriodArray.to_timestampos. 5**3/Sj s{dii3."1c*Yq$-??((W(5>>"1d+yy(6676CfLL < ::>DD--d3D**D;;t;-11(--F**84 99>>S **4995E5zQQx::==( $ CIJQY $ CIJ>>'* *rPc>[R"XRS9$)N)rrg)r# _from_ordinalrg)rIr[s rM _box_funcPeriodArray._box_funcs##AII>>rP 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)rrrZrhasattrr,rr#rrrGrrHrFrr%_hasnarrr) rIrgrbase1base2rHrrrrFs rMr~PeriodArray.asfreqs\**3/ dJ ' 'GD:N,O,Ot$--D))$/ ''''yySj ZZ]]*Q.GG$WU@ ;;$(H[[ !D!Dz(00rPc4U(a[$SR$)Nz'{}')strformat)rIboxeds rM _formatterPeriodArray._formatters J}}rPr)na_rep date_formatc n[R"URURRX5$)z# actually format my specific types )rperiod_array_strftimerHrFrG)rIrrkwargss rM_format_native_types PeriodArray._format_native_typess, .. IItzz--v  rPTc>[U5nXR:XaU(dU$UR5$[U[5(aUR UR 5$[R"US5(d[U[5(aQ[USS5n[R"U5nUR5RU5RU5$[ TU]EXS9$)NMrr)r*rrrZr,r~rgr is_np_dtyper+getattrr dtype_to_unitr} tz_localizeas_unitsuperastype)rIrFrrunit __class__s rMr-PeriodArray.astypesU# KK  yy{" e[ ) );;uzz* * ??5# & &*UO*L*Ld+B$$U+D$$&2226>>tD Dw~e~//rPcURU5RS5nURRS5nURXBUS9$)NM8[ns])sidesorter)_validate_setitem_valueviewr searchsorted)rIrr3r4npvaluem8arrs rMr7PeriodArray.searchsorted$sK ..u5::8D ""8,!!'V!DDrP)limit limit_arearcURS5nURXX4S9nU(a%[SURUR55$U$)Nr2)methodr;r<rr:)r6_pad_or_backfillr rF)rIr>r;r<rrrKs rMr?PeriodArray._pad_or_backfill1sPii!%%:&   DJJ 78 8KrPc>Ub<URS5nURXX4S9nURUR5$[TU]XX4S9$)Nr2)rr>r;r)r6fillnarFr,)rIrr>r;rrrKr/s rMrBPeriodArray.fillnaDsU  ))H%CZZe%ZSF;;tzz* *w~E~QQrPcU[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) operatoraddsubrrHrrrrF)rIrop res_valuess rM_addsub_int_array_or_scalar'PeriodArray._addsub_int_array_or_scalarTs`hllHLL1111  FE%diiE1NO Dz*JJ77rPc[U[5(aeURUSS9 URUR[ R 5$)NT)rJ)rZrrrJrrErFrs rM _add_offsetPeriodArray._add_offsetisCeT**** ##E#5//FFrPc >[UR[5(d [X5e[ U5(a[ TU]U5$[R"[U5R5nURU5$)z\ Parameters ---------- other : timedelta, Tick, np.timedelta64 Returns ------- PeriodArray ) rZrgrrr1r,_add_timedeltalike_scalarrrrasm8_add_timedelta_arraylike)rIrtdr/s rMrP%PeriodArray._add_timedeltalike_scalarpsd$))T**'4 4 ;;74U; ; ZZ %(-- .,,R00rPcURR5(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[]FrFrround_okznCannot add/subtract timedelta-like from PeriodArray that is not an integer multiple of the PeriodArray's freq.Nrr) rF _is_tick_likerr _td64_unitrrrr"rrHr6r)rIrrFdeltaerrrIs rMrR$PeriodArray._add_timedelta_arraylikeszz''))DTZZLQ 3tzz445Q78 ' 5!UUE&diiEJJt ? ?Ie,112BE"B >'eeTE 4 $$U++  >'4# = >s; C-- D7 DDr)returnz type[Period])NNF)rF Dtype | NonerrrdNone)rznpt.NDArray[np.int64]rFr,rdr:)rFrerrrdr:rE)rdr:)rdictrdr:)rPeriod | NaTTyperdznp.int64)rrrdr#)rzPeriod | NaTType | PeriodArrayrdrf)rdr,)rdr)rdr)NN)rFzNpDtype | Nonerz bool | Nonerdz np.ndarray)rdznpt.NDArray[np.bool_])Nr)rrrdr<)rdrh)Nr)rrrdr:)F)rr)rz str | floatrdznpt.NDArray[np.object_])T)rr)leftN)rz$NumpyValueArrayLike | ExtensionArrayr3zLiteral['left', 'right']r4zNumpySorter | Nonerdznpt.NDArray[np.intp] | np.intp) r>r6r; int | Noner<z#Literal['inside', 'outside'] | Nonerrrdr:)NNNT)r;rjrrrdr:)rznp.ndarray | intrHzCallable[[Any, Any], Any]rdr:)rr)rz,TimedeltaArray | npt.NDArray[np.timedelta64]rdr:)NrQ __module__ __qualname____firstlineno__rR__array_priority___typrrr_internal_fill_valuer#_recognized_scalars_is_recognized_dtype_infer_matchesrSr`rb__annotations__rdrhrzr{rr classmethodrrrrrrrrrr&rFrgrrrrUrirjrkrlrmrnrorqrsrrrprtrurvrwrxryrcr}r r'_shared_doc_kwargsr~rr"r-r7r?rBrJrMrPrRrb__static_attributes__ __classcell__)r/s@rMrBrBys:z D88D>!)!N J *+Iy+?K?J &$. #;i#GyG'M9M  KP'4)'4CG'4 '4T(%((  (( # * *  *  **6/3%C ,C;?C CC &&(  44 T T  T- 0 CCAE 2# 22= 2  2O<   D   E    C   D  F  F!  J D!  KIG- I $  G G $E# M: K  5 5@+H? M M]}MC1NC1P (-$ $  00.*0%) E3 E' E# E ( E"!:>   8    (OS R.8 RGK R  R R 8%8+D8 8*G1*#8A#8 #8J#,#,rPc([U[R[45(dUcSnO[U[5(a![ UR UR5nOK[U[[[45(a URnO[[U55Rn[ URR URR5n[R "[#U5R$X2S9n['U5$)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. N)rown_freq other_freq)rZrrr0rrrrLr.rBr#rr rrgr!rrrQr")rirightr{rzmsgs rMrrs %"**&7899U] E: & &+EGGUZZ@ ENK@ A A]] "9U#34<< %diikk499>>BH    J  ( C ! %%rPcp[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] rFNr%rNrz9PeriodIndex does not allow floating point in constructioniuFr&r)r(r r'rBrrZr,rgr~rrrtupler/rrFkindrrr-rr from_ordinalsr)rr) rrgr data_dtypeoutarrdatarFarrrs rM period_arrayrsgtw-J z3''++D77*k**$  & ::d# #  dRZZui@ A ADzjjG D!}}S S\A%5STT}}T!nnRXXEn2**35811  !D |%%d+  E  % %d % 88rPcgrErrs rMrrWrPcgrErrs rMrr\rrPcUb [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*rZr,rrgr"rs rMrrass* . U#%--89 9 <::D K ZZ '(PQ Q KrPcz[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 an 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)rZrFrrrr-rrgr/dtrr#rrc_dt64arr_to_periodarrr6)rrgrrrJs rMrrs, djj"(( + +tzz#/E= 566 | dH % %tyy$ i ( (tww||$ D8Y/ 0 0|| tzz *D  % %d +D  " "D !$))D/4$ G MMrPc[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_nonerrrr#rZrgrrarangerr)rrrrgmult is_start_per is_end_perrs rMrrs %g.!3 ,   .vv u# SeV,LC(J uzzSXX'=<== |scz899 | ::D 88DBC Cvv. =99 g%,ckkAot288D : 99 u}}w6BHHD :yy aRXXN :rPc*UcSnUcSnUcSnUcSn/nUbUc%[SSS9n[RRn OI[USS9n[R "U5n U [RR:wa [ S5eURn [X5up[X5HLup[R"XU 5up[R"XSSSSSSU 5 nURU5 MN Op[USS9n[R "U5n [XX4XV5n[U6H7un nnnnnUR[R"U UUUUUSSU 5 5 M9 [R"U[R S9U4$)NrrQTrzbase must equal FR_QTRr)rrFR_QTRrrfreq_to_dtype_codeAssertionErrorr_make_field_arraysziprquarter_to_myearperiod_ordinalappendrrr)rirjrvrkrlrmrnrgrrJryq calendar_yearcalendar_monthvalarraysmthdhmnss rMrrs | ~ ~ {H <SD1D##))DTT2D//5Dy''---$%=>>,,*49 &DA,3,D,DQ7,S )M**q!Q1aC OOC '.++D1#DFK#&< AsAq"a OOI44QQ2q!QPTU V$0 88HBHH -t 33rPc SnUH\n[U[[R[45(dM/Ub[ U5U:wa [ S5eUbMQ[ U5nM^ UVs/sHYn[U[R[[45(a[R"U5O[R"X!5PM[ sn$s snf)NzMismatched Period array lengths) rZrrrr/rrrrepeat)rlengthr[s rMrrs F  a$ I6 7 7!c!f&6 !BCC~Q   A a"**dI6 7 7 1 YYq ! "   s)A C rE)rLrrTz str | None)rdr")NF)rz,Sequence[Period | str | None] | AnyArrayLikergzstr | Tick | BaseOffset | NonerrrdrB)rgr?rdr?)rgztimedelta | str | Nonerdr)rgz1BaseOffsetT | BaseOffset | timedelta | str | Nonerdr?)rdz(tuple[npt.NDArray[np.int64], BaseOffset])r)rint)NNNNNNNN)rdztuple[np.ndarray, BaseOffset])rdzlist[np.ndarray])h __future__rdatetimerrEtypingrrrrr r r rnumpyr pandas._libsr rr pandas._libs.arraysrpandas._libs.tslibsrrrrrrrrrrrrrrpandas._libs.tslibs.dtypesrrrpandas._libs.tslibs.fieldsrpandas._libs.tslibs.offsetsrr pandas._libs.tslibs.periodr!r"r#r$r%pandas.util._decoratorsr&r'pandas.util._exceptionsr(pandas.core.dtypes.commonr)r*pandas.core.dtypes.dtypesr+r,pandas.core.dtypes.genericr-r.r/r0pandas.core.dtypes.missingr1rr2rpandas.core.commoncorecommonrcollections.abcr3pandas._typingr4r5r6r7r8r9r:r;r<r=pandas.core.arrays.baser>r?rvrU DatelikeOps PeriodMixinrBrrrrrrrrPrMrs".     65 ,2 (   7m:6  ] T ,#//9#8#8T ,n&L,0`9 6`9 (`9 `9 `9F    "B""L%N-%NP.d      .4#.4brP