Ë
|
nñúh¢ ã óÄ d dl mZ d dlmZ d dlZd dlmZmZmZm Z m
|
Z
|
m Z m Z d dl Z d dlZd dlmZmZ d dlmZ d dlmZmZmZmZmZm Z m Z m Z m Z m!Z!m"Z#m$Z$ d dl%m&Z&m'Z'm(Z( d d l)m*Z* d d
|
l+m,Z,m-Z- d d l.m/Z/m0Z0m1Z1m2Z2m3Z3 d d l4m5Z5m6Z6 d d l7m8Z8 d dl9m:Z:m;Z; d dl<m=Z=m>Z> d dl?m@Z@mAZAmBZBmCZC d dlDmEZE d dlFmGZH d dlImJc mKZL er(d dlMmNZN d dlOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZW d dlFmXZXmYZY d dlZm[Z[ e
|
de¬« Z\ddiZ]d&d'dZ^ G d deHj¾ e#jÀ « Zad(d Zb d) d*d Zce d+d « Zde d,d « Zd d-d!Zd d& d.d"Z d/d0d#Ze d1 d2d$Zfd3d%Zgy)4é )Ú annotations)Ú timedeltaN)Ú TYPE_CHECKINGÚAnyÚCallableÚLiteralÚTypeVarÚcastÚoverload)ÚalgosÚlib)Ú NDArrayBacked) Ú
|
BaseOffsetÚNaTÚNaTTypeÚ TimedeltaÚadd_overflowsafeÚastype_overflowsafeÚdt64arr_to_periodarrÚget_unit_from_dtypeÚiNaTÚparsingÚperiodÚ to_offset)Ú FreqGroupÚPeriodDtypeBaseÚfreq_to_period_freqstr)Úisleapyear_arr)ÚTickÚ delta_to_tick)ÚDIFFERENT_FREQÚIncompatibleFrequencyÚPeriodÚget_period_field_arrÚperiod_asfreq_arr)Úcache_readonlyÚdoc)Úfind_stack_level)Ú ensure_objectÚ pandas_dtype)ÚDatetimeTZDtypeÚ PeriodDtype)ÚABCIndexÚABCPeriodIndexÚ ABCSeriesÚABCTimedeltaArray)Úisna)Ú datetimelike)ÚSequence)Ú AnyArrayLikeÚDtypeÚ FillnaOptionsÚNpDtypeÚ NumpySorterÚNumpyValueArrayLikeÚSelfÚnpt)Ú DatetimeArrayÚTimedeltaArray)ÚExtensionArrayÚ BaseOffsetT)ÚboundÚklassÚ PeriodArrayc ó@ fd} |_ ||_ t |« S )Nc ób | j j }t | j |« }|S ©N)ÚdtypeÚ _dtype_coder$ Úasi8)ÚselfÚbaseÚresultÚnames úLH:\Change_password\venv_build\Lib\site-packages\pandas/core/arrays/period.pyÚfz_field_accessor.<locals>.fm s) ø Øzz×%Ñ%Ü% d¨D¯I©I°tÓ<Ø ó )Ú__name__Ú__doc__Úproperty)rL Ú docstringrN s ` rM Ú_field_accessorrT l s" ø ôð
|
AJØAIÜ A;ÐrO c ó e Zd ZU dZdZdZ ej e« Z e
|
fZ d Z dZ edRd« Zg Zded< d gZded
|
< g d ¢Zded < g d ¢Zded< eez ez Zded< g d¢Zded< ded< dS dTdZe dUd« Zeddd dVd« Zeddd dVd« ZedWdXd« Z ed « Z edYd « Z dZd Z d[d Z d\d Z!e"d]d!« Z#ed^d"« Z$ed_d#« Z% d` dad$Z&dWd%Z' e(d&d'« Z) e(d(d)« Z* e(d*d+« Z+ e(d,d-« Z, e(d.d/« Z- e(d0d1« Z. e(d2d3« Z/e/Z0 e(d4d5« Z1e1Z2e2Z3 e(d6d7« xZ4Z5 e(d8d9« Z6 e(d:« Z7 e(d;d<« Z8e8Z9edbd=« Z:dcddd>Z;ded?Z< e=dfi e>¤d@d@dA¤dgdhdB« Z?didjdCZ@dDddE dkdFZAdldm fdH ZB dn dodIZCdddGdJ dpdKZD dq dr fdL ZE dsdMZFdtdNZG fdOZH dudPZIdQ ZJ xZKS )vrB 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.
|
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'))
|
<PeriodArray>
|
['2023-01-01', '2023-01-02']
|
Length: 2, dtype: period[D]
|
iè Ú periodarrayc ó" t | t « S rE )Ú
|
isinstancer, )Úxs rM ú<lambda>zPeriodArray.<lambda>» s ¤ZØ ;ó& rO )r c ó t S rE )r# ©rI s rM Ú _scalar_typezPeriodArray._scalar_typeÀ s ä rO z list[str]Ú
|
_other_opsÚ is_leap_yearÚ _bool_ops)Ú
|
start_timeÚend_timeÚfreqÚ _object_ops)ÚyearÚmonthÚdayÚhourÚminuteÚsecondÚ
|
weekofyearÚweekdayÚweekÚ dayofweekÚ day_of_weekÚ dayofyearÚ day_of_yearÚquarterÚqyearÚ days_in_monthÚ daysinmonthÚ
|
_field_opsÚ_datetimelike_ops)ÚstrftimeÚ to_timestampÚasfreqÚ_datetimelike_methodsr, Ú_dtypeNFc óú |;t j dt t « ¬« t ||« }t |« }|*t |« }t |t
|
« st d| d« t |t « r,|j }t |t | « « s't d« t |t « r |j }t |t | « « r?|%||j k7 rt ||j « |j" |j }}|st% j& |d¬« }nt% j( |d|¬« }| t d « t+ t
|
|« }t- j. | ||« y )
|
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 dtypeÚint64©rF ©rF Úcopyz-dtype is not specified and cannot be inferred)ÚwarningsÚwarnÚ FutureWarningr( Úvalidate_dtype_freqr, r* rX Ú
|
ValueErrorr/ Ú_valuesÚtypeÚ TypeErrorr. rF Úraise_on_incompatiblerc Ú_ndarrayÚnpÚasarrayÚarrayr
|
r Ú__init__)rI ÚvaluesrF rc r s rM r zPeriodArray.__init__ã sA ð Ð ä MMðPä Ü+Ó-õ ô ' u¨dÓ3DÜ Ó%Eà Ð Ü Ó'EÜ e¤[Ô1Ü >°%°Ð8HÐ!IÓJÐJä fiÔ (Ø^^FÜ f¤d¨4£jÔ1Ü Ð 1Ó2Ð2ä ¤Ô /Ø^^Fä fd 4jÔ )ØÐ U¨f¯l©lÒ%:Ü+¨F°E·J±JÓ?Ð?Ø "OO¨V¯\©\EFáÜZZ ¨gÔ6FäXXf¨G¸$Ô?FØ =Ü Ð LÓMÐ MÜ[ %Ó(Ü× Ñ t V¨UÕ3rO c óz d}t |t j « r|j dk( sJ |« | ||¬« S )Nz Should be numpy array of type i8Úi8r )rX r ÚndarrayrF )Úclsr rF Ú assertion_msgs rM Ú _simple_newzPeriodArray._simple_new s: ð ; Ü&¤"§*¡*Ô-°&·,±,À$Ò2FÐUÈ ÓUÐFÙ6 Ô'Ð'rO r c ó | t |« }|r t |t « r |j }nd }t || « r*t |j
|
|« |r|j « }|S t j |t ¬« }|xs t j |« }t j ||« }t |« } | ||¬« S )Nr ) r* rX r, rc r rF r r r ÚobjectÚ libperiodÚ extract_freqÚextract_ordinals)r ÚscalarsrF r rc ÚperiodsÚordinalss rM Ú_from_sequencezPeriodArray._from_sequence s§ ð Ð Ü Ó'EÙ Z ¤{Ô3Ø::DàDä gsÔ #Ü § ¡ ¨tÔ 4ÙØ!,,.ØNä**W¬FÔ3àÒ6y×-Ñ-¨gÓ6Ü ×-Ñ-¨g°tÓ<ÜDÓ!Ù8 5Ô)Ð)rO c ó* | j |||¬« S )Nr )r¡ )r ÚstringsrF r s rM Ú_from_sequence_of_stringsz%PeriodArray._from_sequence_of_strings4 s ð ×!Ñ! '°¸TÐ!ÓBÐBrO c ó¬ t |t « r t |j |j « }t |||« \ }}t |« } | ||¬« S )a
|
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 )rX r r ÚnrL r r, )r Údatarc ÚtzrF s rM Ú_from_datetime64z PeriodArray._from_datetime64: sK ô dJÔ 'Ü)¨$¯&©&°$·)±)Ó<DÜ)¨$°°bÓ9
|
dÜDÓ!Ù4uÔ%Ð%rO c ó¢ t j |« }|t j |« }||t ||||« \ }}||fS t d« )Nz/Not enough parameters to construct Period range)ÚdtlÚvalidate_periodsr# Ú_maybe_convert_freqÚ_get_ordinal_ranger )r ÚstartÚendr rc Úsubarrs rM Ú_generate_rangezPeriodArray._generate_rangeO s` ä×&Ñ& wÓ/à Ð Ü×-Ñ-¨dÓ3Dà Ð Ü-¨e°S¸'À4ÓHLFDð t|Ðô Ð NÓOÐ OrO c ó^ t dd|i|¤\ }}t |« }| j ||¬« S )Nrc r © )Ú_range_from_fieldsr, r )r Úfieldsrc r± rF s rM Ú _from_fieldszPeriodArray._from_fields] s5 ä)Ñ>¨tÐ>°vÑ> ÜDÓ!Øv¨UÓ3Ð3rO c óú |t u r t j |j « S t || j
|
« r0| j |« t j |j « S t d| d« )Nz!'value' should be a Period. Got 'z
|
' instead.) r r r Ú_valuerX r] Ú_check_compatible_withÚordinalr ©rI Úvalues rM Ú _unbox_scalarzPeriodArray._unbox_scalari sd ð C<ä88ELLÓ)Ð )Ü t× 0Ñ 0Ô 1Ø × 'Ñ '¨Ô .Ü88EMMÓ*Ð *ä Ð @ÀÀÀzÐ RÓSÐ SrO c ó0 t || j ¬« S )N)rc )r# rc r¼ s rM Ú_scalar_from_stringz PeriodArray._scalar_from_stringv s Üe $§)¡)Ô,Ð,rO c óL |t u ry | j |j « y rE )r Ú_require_matching_freqrc ©rI Úothers rM rº z"PeriodArray._check_compatible_with| s Ø C<Ø ð ×#Ñ# E§J¡JÕ/rO c ó | j S rE )r| r\ s rM rF zPeriodArray.dtype s à{{ÐrO c ó. | j j S )zC
|
Return the frequency object for this PeriodArray.
|
©rF rc r\ s rM rc zPeriodArray.freq s ð
|
zzÐ rO c ój t | j j | j j « S rE )r rc r¦ rL r\ s rM ÚfreqstrzPeriodArray.freqstr s ä% d§i¡i§k¡k°4·9±9·>±>ÓBÐBrO c óX |dk( rD|s!t j | j |¬« S t j | j |¬« S |du r$t j
|
dt t « ¬« |t k( r | j S t j t | « t ¬« S )Nr r FaS Starting with NumPy 2.0, the behavior of the 'copy' keyword has changed and passing 'copy=False' raises an error when returning a zero-copy NumPy array is not possible. pandas will follow this behavior starting with pandas 3.0.
|
This conversion to NumPy requires a copy, but 'copy=False' was passed. Consider using 'np.asarray(..)' instead.r~ ) r r rH r r r
r r( ÚboolÚ_isnanÚlistr )rI rF r s rM Ú __array__zPeriodArray.__array__ s ð D=ñ Üzz $§)¡)°5Ô9Ð9äxx § ¡ °Ô7Ð7à 5=Ü MMð2ô Ü+Ó-õ ð D=ØKK<Ð ô xxT
|
¬&Ô1Ð1rO c ó ddl }ddlm} |¡|j j |« r,|j | j | j « |¬« S t ||« r?| j |j k7 r5t d| j d|j d« t d| d « || j « }|j | j | j « d
|
¬« }|j j ||« S ) z6
|
Convert myself into a pyarrow Array.
|
r N)ÚArrowPeriodType)Úmaskr zENot 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_typesrÐ ÚtypesÚ
|
is_integerr r r1 rX rÉ rc r r> Ú from_storage)rI r rÓ rÐ Ú period_typeÚ storage_arrays rM Ú__arrow_array__zPeriodArray.__arrow_array__³ sê ó åLà Ð Ø}}×'Ñ'¨Ô-Ø }} T§]¡]¸¿¹»È4}ÓPÐPÜD /Ô2à<< 4§9¡9Ò,Ü#ð#Ø#'§<¡< .°°T·Y±Y°K¸qðBóð ô
|
Ø?À¸vÀVÐLóð ñ & d§l¡lÓ3 Ø d§m¡m¸$¿)¹)»+ÈG ÓT Ø×%Ñ%×2Ñ2°;À ÓNÐNrO re z×
|
The year of the period.
|
|
Examples
|
--------
|
>>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y")
|
>>> idx.year
|
Index([2023, 2024, 2025], dtype='int64')
|
rf zå
|
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')
|
rg zÐ
|
The days of the period.
|
|
Examples
|
--------
|
>>> idx = pd.PeriodIndex(['2020-01-31', '2020-02-28'], freq='D')
|
>>> idx.day
|
Index([31, 28], dtype='int64')
|
rh zÝ
|
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')
|
ri a
|
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')
|
rj a
|
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')
|
rm a
|
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')
|
ro zø
|
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')
|
rq aÐ
|
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')
|
rr zÛ
|
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')
|
rs rt a
|
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')
|
c óR t t j | j « « S )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])
|
)r r r re r\ s rM r_ zPeriodArray.is_leap_yeart s ô bjj¨¯©Ó 3Ó4Ð4rO c ó´ ddl m} t j |« }|dk( }|rp|dk( s| j dk( r.t dd« t dd« z
|
}| j d¬ « |z S t dd« }| | j z j d¬ « |z
|
S |5| j j « }t |d« }|j }|}n!t j |« }|j }| j ||¬ « } t j | j |« }
|
|j" |
|
« } | j j$ dk( rt' j( | j « } t+ | « dk( rQ| d } | | j, j. k( r| j | _ | S | dk( r| j j2 | _ | S | j5 d
|
« S ) 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< ÚEÚBé ÚDÚnsr¯ )ÚhowÚinfer)Úpandas.core.arraysr< r Úvalidate_end_aliasrc r ry r| Ú_get_to_timestamp_baser Ú_freqstrr# r Ú_period_dtype_coderz Úperiodarr_to_dt64arrrH r¡ rL ÚlibalgosÚ unique_deltasÚlenrF Ú_nÚ_freqrJ Ú
|
_with_freq)rI rc râ r< r° ÚadjustÚ freq_coderF rJ Únew_parrÚnew_dataÚdtaÚdiffsÚdiffs rM ry zPeriodArray.to_timestamp s¢ õ. 5ä×*Ñ*¨3Ó/àSjÙ Øs{dii¨3Ò .ä" 1 cÓ*¬Y°q¸$Ó-?Ñ?Ø×(Ñ(¨WÐ(Ó5¸Ñ>Ð>ä" 1 dÓ+Ø tyyÑ(×6Ñ6¸7Ð6ÓCÀfÑLÐLà <Ø ×:Ñ:Ó<IÜ# I¨qÓ1EØ>>DØ Dä×-Ñ-¨dÓ3DØ×*Ñ*Dà;;t¨;Ó-ä ×1Ñ1°(·-±-ÀÓFØ*m×*Ñ*¨8Ó4à 99>>SÒ ô ×*Ñ*¨4¯9©9Ó5EÜ5zQØ QxØ4::==Ò(Ø $§ ¡ CIð Jð QYØ $§ ¡ §¡CIàJà>> 'Ó*Ð *rO c óD t j || j ¬« S )N)r» rc )r# Ú _from_ordinalrc )rI rY s rM Ú _box_funczPeriodArray._box_funcÅ s Ü×#Ñ#¨A°D·I±IÔ>Ð>rO Ú PeriodIndex)rÄ Ú
|
other_namec óö t j |« }t |t « r!t |d« rt |« j }t j |« }| j j }|j }| j }|dk( }|r || j j z dz
|
}n|}t ||||« }| j rt" || j$ < t |« } t' | « || ¬« S )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]')
|
rè rÝ rß r )r rå rX r Úhasattrr, rç r# r r| rG rè rH rF rí r% Ú_hasnar rÌ r )
|
rI rc râ Úbase1Úbase2rH r° r» ró rF s
|
rM rz zPeriodArray.asfreqÈ sÖ ô\ ×*Ñ*¨3Ó/Ü dJÔ '¬G°DÐ:NÔ,OÜ tÓ$×-Ñ-DÜ×)Ñ)¨$Ó/à ×'Ñ'Ø×'Ñ'àyyàSjÙ ØTZZ]]Ñ*¨QÑ.GàGä$ W¨e°U¸CÓ@à ;;Ü$(HT[[Ñ !äDÓ!ØtDz(¨%Ô0Ð0rO c ó* |rt S dj S )Nz'{}')ÚstrÚformat)rI Úboxeds rM Ú
|
_formatterzPeriodArray._formatter s Ù ÜJØ}}Ð rO r )Úna_repÚ date_formatc ón t j | j | j j ||« S )z3
|
actually format my specific types
|
)r Úperiod_array_strftimerH rF rG )rI r r Úkwargss rM Ú_format_native_typesz PeriodArray._format_native_types s. ô ×.Ñ.Ø IItzz×-Ñ-¨v°{ó
|
ð
|
rO Tc óÄ t |« }|| j k( r|s| S | j « S t |t « r| j |j « S t j |d« st |t « rPt |dd « }t j |« }| j « j |« j |« S t | E ||¬« S )NÚMr¨ ©r )r* r| r rX r, rz rc r Ú is_np_dtyper+ Úgetattrr« Ú dtype_to_unitry Ú tz_localizeÚas_unitÚsuperÚastype)rI rF r r¨ ÚunitÚ __class__s rM r zPeriodArray.astype" s¹ ø ô UÓ#Ø DKKÒ ÙØ àyy{Ð"Ü e[Ô )Ø;;uzzÓ*Ð *ä ??5 #Ô &¬*°U¼OÔ*Lä dÓ+BÜ×$Ñ$ UÓ+DØ×$Ñ$Ó&×2Ñ2°2Ó6×>Ñ>¸tÓDÐ Däw~e¨$~Ó/Ð/rO c ó | j |« j d« }| j j d« }|j |||¬« S )NúM8[ns])ÚsideÚsorter)Ú_validate_setitem_valueÚviewr Ú searchsorted)rI r½ r r ÚnpvalueÚm8arrs rM r zPeriodArray.searchsorted6 sM ð ×.Ñ.¨uÓ5×:Ñ:¸8ÓDð ×"Ñ" 8Ó,Ø×!Ñ! '°¸VÐ!ÓDÐDrO )ÚlimitÚ
|
limit_arear c ó | j d« }|j ||||¬« }|r%t d|j | j « « S | S )Nr )Úmethodr! r" r r: )r Ú_pad_or_backfillr
|
rF )rI r$ r! r" r rô rK s rM r% z PeriodArray._pad_or_backfillC sT ð iiÓ!Ø×%Ñ%Ø °:ÀDð &ó
|
ñ Ü § ¡ ¨D¯J©JÓ 7Ó8Ð 8àKrO c ó° |A| j d« }|j ||||¬« }|j | j « S t | ||||¬« S )Nr )r½ r$ r! r )r ÚfillnarF r )rI r½ r$ r! r rô rK r s rM r' zPeriodArray.fillnaV s] ø ð Ð ð ))HÓ%CØZZ e°FÀ%ÈdZÓSFð ;;tzzÓ*Ð *Üw~ E°&ÀÈD~ÓQÐQrO c ó |t j t j fv sJ |t j u r| }t | j t j |d¬« « } t | « || j ¬« S )zì
|
Add or subtract array of integers.
|
|
Parameters
|
----------
|
other : np.ndarray[int64] or int
|
op : {operator.add, operator.sub}
|
|
Returns
|
-------
|
result : PeriodArray
|
r r ) ÚoperatorÚaddÚsubr rH r r r rF )rI rÄ ÚopÚ
|
res_valuess rM Ú_addsub_int_array_or_scalarz'PeriodArray._addsub_int_array_or_scalarf sd ð hll¤H§L¡LÐ1Ñ1Ð1Ð1Ø Ñ ØFEÜ% d§i¡i´·±¸EÈÔ1NÓO
|
ØtDz*¨D¯J©JÔ7Ð7rO c ó t |t « rJ | j |d¬« | j |j t
|
j « S )NT)rJ )rX r r r. r¦ r) r* rà s rM Ú _add_offsetzPeriodArray._add_offset{ s@ Ü e¤TÔ*Ð*Ð*à ×#Ñ# E°Ð#Ô5Ø×/Ñ/°·±¼¿ ¹ ÓFÐFrO c óö t | j t « s t | |« t |« rt
|
| |« S t j t |« j « }| j |« S )z
|
Parameters
|
----------
|
other : timedelta, Tick, np.timedelta64
|
|
Returns
|
-------
|
PeriodArray
|
) rX rc r r r1 r Ú_add_timedeltalike_scalarr r r Úasm8Ú_add_timedelta_arraylike)rI rÄ Útdr s rM r2 z%PeriodArray._add_timedeltalike_scalar sa ø ô $))¤TÔ*ä'¨¨eÓ4Ð 4ä ;ä7Ñ4°UÓ;Ð ;ä ZZ %Ó(×-Ñ-Ó .Ø×,Ñ,¨RÓ0Ð0rO c óê | j j « st d| j « t j d| j j d« } t t j |« |dd¬« }t | j t j |j d« « « } t | « || j ¬ « S # t $ r}t d« |d}~ww xY w)
|
z
|
Parameters
|
----------
|
other : TimedeltaArray or ndarray[timedelta64]
|
|
Returns
|
-------
|
PeriodArray
|
z2Cannot add or subtract timedelta64[ns] dtype from úm8[ú]F©rF r Úround_okznCannot add/subtract timedelta-like from PeriodArray that is not an integer multiple of the PeriodArray's freq.Nr r ) rF Ú _is_tick_liker r Ú
|
_td64_unitr r r r" r rH r r )rI rÄ rF ÚdeltaÚerrr- s rM r4 z$PeriodArray._add_timedelta_arraylike sÛ ð zz×'Ñ'Ô)äØDÀTÇZÁZÀLÐQóð ô 3tzz× 4Ñ 4Ð 5°QÐ7Ó8ð
|
Ü'Ü
|
|
5Ó!¨°UÀUôEô & d§i¡i´·±¸E¿J¹JÀtÓ<LÓ1MÓN
|
ØtDz*¨D¯J©JÔ7Ð7øô ò ô (ðEóð ð ûð ús Á!"C Ã C2Ã! C-Ã-C2c ó | j j « sJ t j d| j j d« }t |t
|
t j t f« r)t j t |« j « }nt j |« } t ||dd¬« }|j d« }t j |« S # t $ r}t | |« |d}~ww xY w)a<
|
Arithmetic operations with timedelta-like scalars or array `other`
|
are only valid if `other` is an integer multiple of `self.freq`.
|
If the operation is valid, find that integer multiple. Otherwise,
|
raise because the operation is invalid.
|
|
Parameters
|
----------
|
other : timedelta, np.timedelta64, Tick,
|
ndarray[timedelta64], TimedeltaArray, TimedeltaIndex
|
|
Returns
|
-------
|
multiple : int or ndarray[int64]
|
|
Raises
|
------
|
IncompatibleFrequency
|
r7 r8 Fr9 Nr )rF r; r r< rX r Ú timedelta64r r r r3 r r r r r Úitem_from_zerodim)rI rÄ rF r5 r= r> s rM Ú _check_timedeltalike_freq_compatz,PeriodArray._check_timedeltalike_freq_compat¼ sÏ ð( zz×'Ñ'Ô)Ð)Ð)ä3tzz× 4Ñ 4Ð 5°QÐ7Ó8ä ei¬¯ © ¼Ð >Ô ?ÜI eÓ ,× 1Ñ 1Ó2BäEÓ"Bð >Ü'¨°%¸eÈeÔTEð
|
|
4Ó Ü×$Ñ$ UÓ+Ð+øô ò >Ü'¨¨eÓ4¸#Ð =ûð >ús Â.C# Ã# C>Ã, C9Ã9C>)Úreturnz type[Period])NNF)rF ú Dtype | Noner rË rC ÚNone)r znpt.NDArray[np.int64]rF r, rC r: )rF rD r rË rC r: rE )rC r: )r¶ ÚdictrC r: )r½ úPeriod | NaTTyperC znp.int64)r½ r rC r# )rÄ z Period | NaTType | PeriodArrayrC rE )rC r, )rC r )rC r )NN)rF zNpDtype | Noner z bool | NonerC z
|
np.ndarray)rC znpt.NDArray[np.bool_])Nr¯ )râ r rC r< )rC rG r´ )NrÝ )râ r rC r: )F)r rË )r z str | floatrC znpt.NDArray[np.object_])T)r rË )ÚleftN)r½ z$NumpyValueArrayLike | ExtensionArrayr zLiteral['left', 'right']r zNumpySorter | NonerC z npt.NDArray[np.intp] | np.intp)
|
r$ r6 r! ú
|
int | Noner" z#Literal['inside', 'outside'] | Noner rË rC r: )NNNT)r! rI r rË rC r: )rÄ znp.ndarray | intr, zCallable[[Any, Any], Any]rC r: )rÄ r )rÄ z,TimedeltaArray | npt.NDArray[np.timedelta64]rC r: )LrP Ú
|
__module__Ú __qualname__rQ Ú__array_priority__Ú_typr r r Ú_internal_fill_valuer# Ú_recognized_scalarsÚ_is_recognized_dtypeÚ_infer_matchesrR r] r^ Ú__annotations__r` rd rv rw r{ r Ú classmethodr r¡ r¤ r© r² r· r¾ rÀ rº r& rF rc rÉ rÎ rÚ rT re rf rg rh ri rj rk rm ro rn rl rp rq rr rs rt ru r_ ry rù r' Ú_shared_doc_kwargsrz r r r r r% r' r. r0 r2 r4 rB Ú __classcell__)r s @rM rB rB y s ø
ñ:ðz ÐØ DØ#288 D>ÐØ!)Ðñ Ðð !Nà òó ðð J Ó Ø *Ð+IyÓ+Ú ?KÓ?ò J ó ð& $.° Ñ#;¸iÑ#GÐyÓGÚ'MÐ9ÓMà Óð KPð'4Ø )ð'4ØCGð'4à ó'4ðT ð(à%ð(ð ð(ð
|
ò (ó ð(ð ð
|
#Øñ *ð ð *ð
|
ð *ð
|
ò *ó ð*ð6 à/3À%ñCØ ,ðCØ;?ðCà òCó ðCð
|
ó&ó ð&ð( ñ ó ð ð ò4ó ð4ð Tà ð Tð
|
ó Tó-ó 0ð òó ðð ò ó ð ð òCó ðCð AEð2Ø#ð2Ø2=ð2à ó2ó:Oñ< Øð ó Dñ Øð ó Eñ Ø ð ó Cñ Øð ó Dñ Øð ó Fñ Øð ó Fñ !Øð ó Jð DÙ!Øð ó Kð IØGÙ -Øð ó ð I ñ$ Øð ó Gñ GÓ $EÙ#Øð ó Mð: Kà ò
|
5ó ð
|
5ô@+óH?ñ ÑMÐ ÐM ]¸}ÓMóC1ó NðC1ôP ð (-¸$ñ
|
Ø$ð
|
à ó
|
ö0ð. *0Ø%)ð Eà3ð Eð 'ð Eð #ð Eð
|
|
(ó Eð" !Ø:>Øñ ð ðð ð ð
|
8ð ð ð ð
|
óð( OSð RØ.8ð RØGKð Rà õ Rð 8Ø%ð8Ø+Dð8à ó8ó*Gô1ð*#8ØAð#8à ó#8öJ#,rO c ó t |t j t f« s|d}nwt |t « r!t |j |j « }nFt |t t t f« r |j }n t t |« « j }t | j j | j j « }t j t# | « j$ ||¬« }t' |« S )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)r Úown_freqÚ
|
other_freq)rX r r r0 r r r¦ rL r. rB r# rÉ r r rc r! r r rP r" )rH ÚrightrX rW Úmsgs rM r r â s¸ ô %"**Ô&7Ð8Ô9¸U¸]Ø
|
Ü E:Ô &Ü+¨E¯G©G°U·Z±ZÓ@
|
Ü EN¬K¼Ð@Ô AØ]]
|
ä"¤9¨UÓ#3Ó4×<Ñ<
|
ä% d§i¡i§k¡k°4·9±9·>±>ÓBHÜ
|
×
|
Ñ
|
Ü J× Ñ ¨(¸zô Cô ! Ó %Ð%rO c óN t | dd« }t j |d« rt j | |« S t |t « r1t | « }|"||j k( r|S |j |« S |S t | t j t t t f« s t | « } t j | « }|r t |« }nd}|j j dk( rt# |« dkD r t% d« |j j dv rD|j' t j( d¬ « }t+ j, ||« }t ||¬
|
« S t/ |« } |t+ j0 | « }t |« }t j3 | |¬
|
« S ) 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')])
|
<PeriodArray>
|
['2017', '2018']
|
Length: 2, dtype: period[Y-DEC]
|
|
>>> period_array([pd.Period('2017', freq='Y'),
|
... pd.Period('2018', freq='Y'),
|
... pd.NaT])
|
<PeriodArray>
|
['2017', '2018', 'NaT']
|
Length: 3, dtype: period[Y-DEC]
|
|
Integers that look like years are handled
|
|
>>> period_array([2000, 2001, 2002], freq='D')
|
<PeriodArray>
|
['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')
|
<PeriodArray>
|
['2000Q1', '2000Q2', '2000Q3', '2000Q4']
|
Length: 4, dtype: period[Q-DEC]
|
rF Nr rN r z9PeriodIndex does not allow floating point in constructionÚiuFr r )r r r rB r© rX r, rc rz r r rÍ Útupler/ r rF Úkindrì r r r r Ú from_ordinalsr) r r¡ ) r§ rc r Ú
|
data_dtypeÚoutÚarrdatarF Úarrr s rM Ú period_arrayrd sh ôt w¨Ó-Jä
|
z 3Ô'Ü×+Ñ+¨D°$Ó7Ð7Ü*kÔ*Ü$Ó Ø Ð ØzÒ&Ø
|
Ø::dÓ#Ð #Ø
|
ô dRZZ¬¬u´iÐ @Ô AÜDzäjjÓ Gñ ÜDÓ!àà}}×ÑSÒ ¤S¨£\°AÒ%5ÜÐSÓTÐTà}}×ÑTÑ!ØnnRXX¨EnÓ2ô ×*Ñ*¨3°Ó5Ü8¨5Ô1Ð1ä Ó !DØ |Ü×%Ñ% dÓ+Ü Ó EÜ × %Ñ % d°%Ð %Ó 8Ð8rO c ó y rE r´ rÇ s rM r r i ó àrO c ó y rE r´ rÇ s rM r r n rf rO c óÈ | t |d¬« }| Pt | « } t | t « s t d« || j
|
}|S || j
|
k7 r t d« |S )at
|
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)r r* rX r, r rc r" rÇ s rM r r s sr ð* ÐܨÔ.à ÐÜ UÓ#Ü%¤Ô-Ü Ð 8Ó9Ð 9Ø <Ø::Dð
|
Kð UZZÒ Ü'Ð(PÓQÐ Qð KrO c óX t | j t j « r| j j dk7 rt d| j « |\t | t
|
« r| j | j }} nUt | t « rE| j | j j }} n"t | t
|
t f« r | j } t | j « }t j |« }|j }t | j d« |||¬« |fS )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)rX rF r r^ r r- r rc r/ Údtr r# r rè Úc_dt64arr_to_periodarrr )r§ rc r¨ rl rJ s rM r r sÙ ô, djj¤"§(¡(Ô +¨t¯z©z¯©À#Ò/EÜ=¨¯©¨ Ð5Ó6Ð6à |Ü dHÔ %Ø t§y¡y$DÜ iÔ (Ø t§w¡w§|¡|$Dä D8¤YÐ/Ô 0Ø||ä tzzÓ *DÜ × %Ñ % dÓ +DØ × "Ñ "DÜ ! $§)¡)¨D£/°4¸À$Ô GÈÐ MÐMrO c ó t j | ||« dk7 r t d« |t |d¬« }|j }| t | |« } | t ||« }t | t
|
« }t |t
|
« }|r&|r$| j |j k7 r t d« | t u s|t u r t d« |5|r | j }n|r |j }n t d« |j }|||z }| Ht j |j |z
|
|z |j dz |t j ¬ « }||fS t j | j | j |z |t j ¬ « }||fS t j | j |j dz |t j ¬ « }||fS )
|
Né zOOf the three parameters: start, end, and periods, exactly two must be specifiedTri z!start and end must have same freqz start and end must not be NaTz#Could not infer freq from start/endrß r ) ÚcomÚcount_not_noner r r¦ r# rX rc r r Úaranger» r )r¯ r° r rc ÚmultÚ is_start_perÚ
|
is_end_perr§ s rM r® r® À s¥ Ü
|
×Ñ% gÓ.°!Ò3Üð ,ó
|
ð
|
ð
|
ÐܨÔ.Øvvà ÐÜudÓ#Ø
|
ÜS$Ó ä e¤VÓ,LÜC¤Ó(Já
|
u§z¡z°S·X±XÒ'=ÜÐ<Ó=Ð=Ø |sczÜÐ8Ó9Ð9à |Ù Ø::DÙ Ø88Dä Ð BÓCÐ CØvvàÐØD.Ø =Ü99Ø gÑ%¨Ñ,¨c¯k©k¸A©o¸tÌ2Ï8É8ôDð :Ðô 99Ø u}}¨wÑ 6¸ÄBÇHÁHôDð :Ðô yy ¨¯ © °a©¸ÄRÇXÁXÔNà :ÐrO c ó4 |d}|d}|d}|d}g }|ì|(t dd¬« }t j j } nJt |d¬« }t j
|
|« } | t j j k7 r t d« |j }
|
t | |« \ } }t | |« D ]M \ } } t j | | |
|
« \ } }t j | |dddddd| « }|j |« O nrt |d¬« }t j
|
|« } t | |||||« }t | D ]5 \ } }}}}}|j t j | |||||dd| « « 7 t j |t j ¬« |fS )Nr rß ÚQTri zbase must equal FR_QTRr )r r ÚFR_QTRr½ r Úfreq_to_dtype_codeÚAssertionErrorrÉ Ú_make_field_arraysÚzipr Úquarter_to_myearÚperiod_ordinalÚappendr r r )re rf rr rg rh ri rj rc r rJ rÉ ÚyÚqÚ calendar_yearÚcalendar_monthÚvalÚarraysÚmthÚdÚhÚmnÚss rM rµ rµ ñ sª ð |ØØ ~ØØ ~ØØ
|
{ØàHàÐØ <Ü S¨DÔ1DÜ ×#Ñ#×)Ñ)Dä T¨TÔ2DÜ ×/Ñ/°Ó5DØy×'Ñ'×-Ñ-Ò-Ü$Ð%=Ó>Ð>à,,Ü*¨4°Ó9 gÜgÓ&ò !DAqÜ,3×,DÑ,DÀQÈÈ7Ó,SÑ )M>Ü×*Ñ*Ø ~¨q°!°Q¸¸1¸aÀóCð OOCÕ ñ !ô ¨Ô.Ü×+Ñ+¨DÓ1Ü# D¨%°°d¸FÀFÓKÜ#&¨ <ò WÑ AsAq"aØ OOI× 4Ñ 4°Q¸¸QÀÀ2ÀqÈ!ÈQÐPTÓ UÕ Vð Wô 88H¤B§H¡HÔ -¨tÐ 3Ð3rO c óx d }| D ]Q }t |t t j t f« s)|t |« |k7 r t d« |Gt |« }S | D cg c]R }t |t j t t f« rt j |« nt j ||« T c}S c c}w )Nz Mismatched Period array lengths) rX rÍ r r r/ rì r r Úrepeat)r¶ ÚlengthrY s rM r| r| " s¬ Ø FØ ò Ü a$¤§
|
¡
|
¬IÐ6Õ 7ØÐ!¤c¨!£f°Ò&6Ü Ð!BÓCÐCØ~Ü Qð ð ö ð ô a"**¤d¬IÐ6Ô 7ô
|
|
1 ä YYq&Ó !ñ "ò ð ùò s Á AB7rE )rL r rS z
|
str | None)rC r" )NF)r§ z,Sequence[Period | str | None] | AnyArrayLikerc z str | Tick | BaseOffset | Noner rË rC rB )rc r? rC r? )rc ztimedelta | str | NonerC r )rc z1BaseOffsetT | BaseOffset | timedelta | str | NonerC r? )rC z(tuple[npt.NDArray[np.int64], BaseOffset])rß )rt Úint)NNNNNNNN)rC z tuple[np.ndarray, BaseOffset])rC zlist[np.ndarray])hÚ
|
__future__r Údatetimer r) Útypingr r r r r r
|
r r Únumpyr Ú pandas._libsr rê r Úpandas._libs.arraysr Úpandas._libs.tslibsr r r r r r r rn r r r r r r Úpandas._libs.tslibs.dtypesr r r Úpandas._libs.tslibs.fieldsr Úpandas._libs.tslibs.offsetsr r Ú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/ r0 Úpandas.core.dtypes.missingr1 rä r2 r« Úpandas.core.commonÚcoreÚcommonrq Úcollections.abcr3 Úpandas._typingr4 r5 r6 r7 r8 r9 r: r; r< r= Úpandas.core.arrays.baser> r? rT rT Ú DatelikeOpsÚ PeriodMixinrB r rd r r® rµ r| r´ rO rM ú<module>r© s® ðÝ "å Û ÷÷ ñ ó ã ÷õ .÷ ÷ ÷ ó ÷ ñ õ
|
6÷÷õ ÷õ 5÷÷÷ó õ ,å 2ß Ð áÝ(÷ ÷ ó ÷õ 7ñ m¨:Ô6 ð ]ðÐ ô
|
ôf ,#// 9×#8Ñ#8ô f ,óR &ðL ,0Øð`9Ø
|
6ð`9à
|
(ð`9ð ð`9ð ó `9ðF
|
òó
|
ðð
|
òó
|
ðð"ØBð"àó"ðL ð%Nà-ó%NôP.ðd
|
Ø
|
Ø Ø Ø Ø Ø Ø ð.4ð #ó.4ôbrO
|
