Ë
|
nñúh"J ã ó: d dl mZ d dlmZmZ d dlmZ d dlZd dlZd dl m
|
Z d dl m Z mZmZmZmZ d dlmZ d dlmZmZ d d lmZ d d
|
lmZ d d lm Z d d l m Z d d l m Z d dl!m"Z"m#Z#m$Z$m%Z% d dl&m'c m(Z) d dl*m'c m+c m,Z- d dl*m.Z. d dl/m0Z0 d dl1m2Z2m3Z3 d dl4m5Z5 erd dl6m7Z7 d dl8m9Z9m:Z:m;Z;m<Z< e=e-j| « Z>e>j ddi« ddiZ@d ZA e5g d¢e"j z e"d¬ « e5d ge"« G d d e0« « « ZC d! d"d ZDy)#é )Ú annotations)ÚdatetimeÚ timedelta)Ú TYPE_CHECKINGN)Úindex)Ú
|
BaseOffsetÚNaTÚPeriodÚ
|
ResolutionÚTick)ÚOFFSET_TO_PERIOD_FREQSTR)Úcache_readonlyÚdoc)Úfind_stack_level)Ú
|
is_integer)Ú PeriodDtype)Ú ABCSeries)Úis_valid_na_for_dtype)Ú PeriodArrayÚ period_arrayÚraise_on_incompatibleÚvalidate_dtype_freq)Úmaybe_extract_name)ÚDatetimeIndexOpsMixin)Ú DatetimeIndexÚIndex)Ú inherit_names)ÚHashable)ÚDtypeÚDtypeObjÚSelfÚnptÚ target_klassz PeriodIndex or list of PeriodsÚklassr c óÎ |j d« }|j dk( r=|j dd « }t |« }t ||¬« } | j |fi |¤S | |fi |¤S )NÚdataÚint64Úfreq©Údtype)Úpopr* r r Ú _simple_new)ÚclsÚdÚvaluesr( r* s úMH:\Change_password\venv_build\Lib\site-packages\pandas/core/indexes/period.pyÚ_new_PeriodIndexr1 D sg à UU6]FØ ||wÒ ØuuVTÓ"ÜDÓ!Ü V¨5Ô1Ø svÑ+¨Ñ+Ð+á6Ñ QÑ Ð ó )ÚstrftimeÚ
|
start_timeÚend_timeT)ÚwrapÚ is_leap_yearc
|
ó e Zd ZU dZdZded< ded< ded< eZd Ze d&d
|
« Z
|
e d'd « Z e ej fd dd e¤d(d)d« Z e ej « d*d+d« Ze e ej" j$ « d,d« « Ze e ej& j$ « d,d« « Ze e ej( j$ « d,d« « Z d- d.dZeddddddddd d/d« Zeddd/d« Ze d0d« Zd1dZd2dZd3 fd Z e d4d « Z e d5d « Z fd Z d Z d6d!Z!d7d"Z" e e#jH « d8 fd# « Z$d9d$Z% e e#jL « d:d;d%« Z& xZ'S )<Ú PeriodIndexaí
|
Immutable ndarray holding ordinal values indicating regular periods in time.
|
|
Index keys are boxed to Period objects which carries the metadata (eg,
|
frequency information).
|
|
Parameters
|
----------
|
data : array-like (1d int np.ndarray or PeriodArray), optional
|
Optional period-like data to construct index with.
|
copy : bool
|
Make a copy of input ndarray.
|
freq : str or period object, optional
|
One of pandas period strings or corresponding objects.
|
year : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
month : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
quarter : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
day : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
hour : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
minute : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
second : int, array, or Series, default None
|
|
.. deprecated:: 2.2.0
|
Use PeriodIndex.from_fields instead.
|
dtype : str or PeriodDtype, default None
|
|
Attributes
|
----------
|
day
|
dayofweek
|
day_of_week
|
dayofyear
|
day_of_year
|
days_in_month
|
daysinmonth
|
end_time
|
freq
|
freqstr
|
hour
|
is_leap_year
|
minute
|
month
|
quarter
|
qyear
|
second
|
start_time
|
week
|
weekday
|
weekofyear
|
year
|
|
Methods
|
-------
|
asfreq
|
strftime
|
to_timestamp
|
from_fields
|
from_ordinals
|
|
See Also
|
--------
|
Index : The base pandas Index type.
|
Period : Represents a period of time.
|
DatetimeIndex : Index with datetime64 data.
|
TimedeltaIndex : Index of timedelta64 data.
|
period_range : Create a fixed-frequency PeriodIndex.
|
|
Examples
|
--------
|
>>> idx = pd.PeriodIndex.from_fields(year=[2000, 2002], quarter=[1, 3])
|
>>> idx
|
PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]')
|
Ú periodindexr Ú_datar r( r r* Tc ó" t j S ©N)ÚlibindexÚ PeriodEngine©Úselfs r0 Ú _engine_typezPeriodIndex._engine_type¼ s ä×$Ñ$Ð$r2 c ó. | j j S r= )r* Ú_resolution_objr@ s r0 rD zPeriodIndex._resolution_objÀ s ð zz×)Ñ)Ð)r2 zpandas.arrays.PeriodArray)ÚotherÚ
|
other_nameNc ó | j j ||« }t | « j || j ¬« S ©N©Úname)r; ÚasfreqÚtyper, rJ ©rA r( ÚhowÚarrs r0 rK zPeriodIndex.asfreqÉ s8 ð jj× Ñ cÓ*ÜDz×%Ñ% c°· ± Ð%Ó:Ð:r2 c ó| | j j ||« }t j || j ¬« S rH )r; Ú to_timestampr r, rJ rM s r0 rQ zPeriodIndex.to_timestampÓ s/ àjj×%Ñ% d¨CÓ0Ü ×(Ñ(¨°4·9±9Ô=Ð=r2 c óX t | j j | j ¬« S rH )r r; ÚhourrJ r@ s r0 rS zPeriodIndex.hourØ s ô TZZ__¨4¯9©9Ô5Ð5r2 c óX t | j j | j ¬« S rH )r r; ÚminuterJ r@ s r0 rU zPeriodIndex.minuteÝ ó ô TZZ×&Ñ&¨T¯Y©YÔ7Ð7r2 c óX t | j j | j ¬« S rH )r r; ÚsecondrJ r@ s r0 rX zPeriodIndex.secondâ rV r2 c óÎ h d£}d } |s"t |t t f« r |j } t |« j |« s.t t t |« |z
|
« « }
|
t d|
|
« t |« r$t j dt t « ¬« |$t j dt t « ¬« t ||| « }|8|6|s| j d « | j di |¤d|i¤j" }d}n²|r| t% d« t% d « t' ||« }|r,t || « r |j( |k7 r|j+ |« }|@|>t- j. |t, j0 ¬
|
« }t3 |« }t5 ||¬
|
« }n | | t% d « t7 ||¬ « }|r|j9 « }| j; ||| ¬ « S )N> ÚdayrS ÚyearÚmonthrU rX Úquarterz-__new__() got an unexpected keyword argument zXConstructing PeriodIndex from fields is deprecated. Use PeriodIndex.from_fields instead.)Ú
|
stacklevelzThe 'ordinal' keyword in PeriodIndex is deprecated and will be removed in a future version. Use PeriodIndex.from_ordinals instead.r( Fz Cannot pass both data and fieldsz#Cannot pass both ordinal and fieldsr) z!Cannot pass both data and ordinal)r& r( )rJ Úrefs© ) Ú
|
isinstancer r Ú _referencesÚsetÚissubsetÚnextÚiterÚ TypeErrorÚlenÚwarningsÚwarnÚ FutureWarningr r Ú_raise_scalar_data_errorÚ from_fieldsr; Ú
|
ValueErrorr r( rK ÚnpÚasarrayr' r r r Úcopyr, ) r- r& Úordinalr( r* rq rJ ÚfieldsÚvalid_field_setr_ Úarguments r0 Ú__new__zPeriodIndex.__new__ê sÏ ò
|
ð Ù
|
4¬%´Ð);Ô<Ø×#Ñ#Dä6{×#Ñ# OÔ4ÜD¤ V£¨Ñ!>Ó ?Ó@HÜÐ KÈHÈ:Ð VÓWÐ WÜ [ä MMð3ä Ü+Ó-õ ð Ð ä MMðô Ü+Ó-õ ô " $¨¨cÓ2à <GOáà×,Ñ,¨TÔ2Ø"3??Ñ7 VÑ7°$Ò7×=Ñ=DØDá ØÐ Ü Ð!CÓDÐDÜ Ð BÓCÐ Cô ' u¨dÓ3Dñ
|
|
4¨Ô-°$·)±)¸tÒ2Cð {{ 4Ó(à| Ð 3Ü ** W´B·H±HÔ=Ü# DÓ)Ü" 7°%Ô8ØÐ! gÐ&9Ü Ð!DÓEÐEô $¨°DÔ9á Ø99;Dàt¨$°TÓ:Ð:r2 )r[ r] r\ rZ rS rU rX r( c ó¾ |||||||d} | j « D
|
ci c] \ }
|
} | |
|
| } }
|
} t j | |¬« } | j | « S c c} }
|
w )N)r[ r] r\ rZ rS rU rX )rs r( )Úitemsr Ú _from_fieldsr, ) r- r[ r] r\ rZ rS rU rX r( rs ÚkeyÚvaluerO s r0 rm zPeriodIndex.from_fieldsA so ð Ø ØØØØ Ø ñ
|
ð 06¯|©|«~×S¡ eÀÑAR#u*ÐSÑSÜ×&Ñ&¨f¸4Ô@ØsÓ#Ð#ùó Ts
|
|
A©ArI c ó¶ t j |t j ¬« }t |« }t j
|
||¬« }| j ||¬« S )Nr) rI )ro rp r' r r r, )r- Úordinalsr( rJ r* r& s r0 Ú from_ordinalszPeriodIndex.from_ordinals[ sE ä::h¬b¯h©hÔ7ÜDÓ!Ü×&Ñ& x°uÔ=Øt¨$Ó/Ð/r2 c ó8 t j | t ¬« S )Nr) )ro rp Úobjectr@ s r0 r/ zPeriodIndex.valuese s äzz$¤fÔ-Ð-r2 c óÄ t |t t j t t j
|
f« r7t | j t « r| j j |« }|S t |t « r;|j | j j k( r |j S t | |« t |« rt |t « sJ |S t | d« )aÅ
|
Convert timedelta-like input to an integer multiple of self.freq
|
|
Parameters
|
----------
|
other : timedelta, np.timedelta64, DateOffset, int, np.ndarray
|
|
Returns
|
-------
|
converted : int, np.ndarray[int64]
|
|
Raises
|
------
|
IncompatibleFrequency : if the input cannot be written as a multiple
|
of self.freq. Note IncompatibleFrequency subclasses ValueError.
|
N)ra r ro Ú timedelta64r Úndarrayr( r; Ú _check_timedeltalike_freq_compatr ÚbaseÚnr r Úint)rA rE Údeltas r0 Ú_maybe_convert_timedeltaz$PeriodIndex._maybe_convert_timedeltai s¦ ô" ei¬¯ © ¼¼r¿z¹zÐ JÔ KÜ$))¤TÔ*à
|
|
×CÑCÀEÓJØ Ü zÔ *ØzzTYY^^Ò+Ø wwä'¨¨eÓ4Ð 4Ü Ô Ü e¤SÔ)Ð )Ð)ØLô $ D¨$Ó/Ð/r2 c ó | j |k( S )zF
|
Can we compare values of the given dtype to our own?
|
r) )rA r* s r0 Ú_is_comparable_dtypez PeriodIndex._is_comparable_dtype s ð zzUÑ"Ð"r2 c ó¾ t |t « r"t |j | j ¬« }nt |t « s t d« t | ||« S )z
|
where : array of timestamps
|
mask : np.ndarray[bool]
|
Array of booleans where data is not NA.
|
©r( z6asof_locs `where` must be DatetimeIndex or PeriodIndex)ra r r9 Ú_valuesr( rg ÚsuperÚ asof_locs)rA ÚwhereÚmaskÚ __class__s r0 r zPeriodIndex.asof_locs sK ø ô e]Ô +Ü § ¡ °D·I±IÔ>EÜE¤;Ô/ÜÐ TÓUÐ UäwÑ ¨Ó-Ð-r2 c ó° t | « dk( ry| j s t d« | j }t |dd |dd z
|
dk j « « S )z
|
Returns True if this PeriodIndex is range-like in that all Periods
|
between start and end are present, in order.
|
r TzIndex is not monotonicé Néÿÿÿÿé )rh Úis_monotonic_increasingrn Úasi8ÚboolÚall)rA r/ s r0 Úis_fullzPeriodIndex.is_full¡ sZ ô t9>ØØ×+Ò+Ü Ð 5Ó6Ð 6ØÜfQRj 6¨#¨2 ;Ñ.°!Ñ3×8Ñ8Ó:Ó;Ð;r2 c ó y)NÚperiodr` r@ s r0 Ú inferred_typezPeriodIndex.inferred_type® s ð r2 c ó| t | ||« }| j |j k( r| j |« }|S r= )r Ú_convert_tolerancer* r )rA Ú toleranceÚtargetr s r0 r¡ z PeriodIndex._convert_tolerance· s< ø ô
|
GÑ.¨y¸&ÓA à :: Ò %à ×5Ñ5°iÓ@IàÐr2 c óÎ |}| j |« t || j « rt }nÄt |t
|
« re | j |« \ }}| j |« r | j ||« S || j k( r| j |« }nZt |« t |t « r| j |« n-t |t « r| j |« }n t |« t! j" | |« S # t $ r}t d| d« |d}~ww xY w# t $ r}t |« |d}~ww xY w# t $ r}t |« |d}~ww xY w)a»
|
Get integer location for requested label.
|
|
Parameters
|
----------
|
key : Period, NaT, str, or datetime
|
String or datetime key must be parsable as Period.
|
|
Returns
|
-------
|
loc : int or ndarray[int64]
|
|
Raises
|
------
|
KeyError
|
Key is not present in the index.
|
TypeError
|
If key is listlike or otherwise not hashable.
|
zCannot interpret 'z ' as periodN)Ú_check_indexing_errorr r* r ra ÚstrÚ_parse_with_resorn ÚKeyErrorÚ_can_partial_date_sliceÚ_partial_date_slicerD Ú _cast_partial_indexing_scalarr
|
Ú _disallow_mismatched_indexingr r Úget_loc)rA rz Úorig_keyÚparsedÚresoÚerrs r0 r zPeriodIndex.get_locÄ s\ ð( à ×"Ñ" 3Ô'ä d§j¡jÔ 1ÜCä SÔ !ð OØ #× 4Ñ 4°SÓ 9 ð
|
×+Ñ+¨DÔ1ð1Ø ×3Ñ3°D¸&ÓAÐAð t×+Ñ+Ò+ð ×8Ñ8¸Ó@ä smÐ#ä VÔ $Ø × .Ñ .¨sÕ 3ä XÔ &Ø×4Ñ4°SÓ9Cô 3-Ð ð .Ü== sÓ+Ð +øô9 ò Oä Ð!3°C°5¸ Ð DÓEÈ3ÐNûð Oûô ò 1Ü" 3-¨SÐ0ûð1ûô, ò .Ü8Ó$¨#Ð -ûð .úsH ÁD Á(D- Ã6E
|
Ä D*ÄD%Ä%D*Ä- EÄ6 EÅEÅ
|
E$Å E Å E$c óL |j | j k7 r t |« y r= )Ú_dtyper* r¨ )rA rz s r0 r¬ z)PeriodIndex._disallow_mismatched_indexing s! Ø ::Ò #Ü3-Ð ð $r2 c óp t || j ¬« }|S # t $ r}t |« |d }~ww xY w)Nr )r
|
r( rn r¨ )rA Úlabelr r± s r0 r« z)PeriodIndex._cast_partial_indexing_scalar s< ð +ÜE¨¯ © Ô2Fð øô ò +ä5/ sÐ *ûð +ús 5¤ 0°5c óf t |t « r| j |« }t | ||« S r= )ra r r« r Ú_maybe_cast_slice_bound)rA rµ Úsider s r0 r· z#PeriodIndex._maybe_cast_slice_bound s/ ø ä eXÔ &Ø×6Ñ6°uÓ=EäwÑ.¨u°dÓ;Ð;r2 c óä t j |j |j « }t ||¬« }|j | j
|
d¬« |j | j
|
d¬« fS )Nr Ústart)rN Úend)r ÚgetÚ attr_abbrevr
|
rK r( )rA r° r¯ r( Úivs r0 Ú_parsed_string_to_boundsz$PeriodIndex._parsed_string_to_bounds sY Ü'×+Ñ+¨D×,<Ñ,<¸d×>NÑ>NÓOÜ F Ô &Ø $))¨ Ó1°2·9±9¸T¿Y¹YÈE°9Ó3RÐSÐSr2 c óT |"t dt | « j d« | |z S )Nz%`freq` argument is not supported for z.shift)rg rL Ú__name__)rA Úperiodsr( s r0 ÚshiftzPeriodIndex.shift s8 à Ð ÜØ7¼¸T»
|
×8KÑ8KÐ7LÈFÐSóð ð g~Ð r2 )Úreturnztype[libindex.PeriodEngine])rÄ r )NÚE)rN r¦ rÄ r! )Nrº )rN r¦ rÄ r )rÄ r )NNNNFN)r* z Dtype | Nonerq r rJ úHashable | NonerÄ r! )rÄ r! )rÄ znpt.NDArray[np.object_])rÄ zint | npt.NDArray[np.int64])r* r rÄ r )r r r znpt.NDArray[np.bool_]rÄ z
|
np.ndarray)rÄ r )rÄ r¦ )rz r
|
rÄ ÚNone)rµ r rÄ r
|
)r¸ r¦ )r° r r¯ r )r N)r r rÄ r! )(rÁ Ú
|
__module__Ú __qualname__Ú__doc__Ú_typÚ__annotations__r Ú _data_clsÚ!_supports_partial_string_indexingÚpropertyrB r rD r rK Ú_shared_doc_kwargsrQ rS ÚfgetrU rX rv Ú classmethodrm r~ r/ r r r r r r¡ r r¬ r« r r· r¿ rÃ Ú __classcell__)r s @r0 r9 r9 P sn ø
ñZðx Dà ÓØ
|
ÓØ ÓàIØ(,Ð%à ò%ó ð%ð ò*ó ð*ñ Ø×Ñðà)Ø ñð ñ ó ;ó ð ;ñ × !Ñ !Ó"ó>ó #ð>ð Ù× Ñ × Ñ Ó ò6ó ó ð6ð Ù× Ñ × Ñ Ó!ò8ó "ó ð8ð Ù× Ñ × Ñ Ó!ò8ó "ó ð8ð ØØ Ø "ØØ $ðU;ð
|
ð U;ð ð U;ð ðU;ð
|
óU;ðn ð ØØØ Ø ØØØ ñ$ð
|
ò$ó ð$ð2 Ø37ô 0ó ð0ð ò.ó ð.ó 0óD#õ .ð ò
|
<ó ð
|
<ð òó ðô ò<.ó| óñ Ð × 6Ñ 6Ó7ô<ó 8ð<ó Tñ
|
Ð × $Ñ $Ó%ó ó &ô r2 r9 c ó t j | ||« dk7 r t d« |"t | t « st |t « sd}t j | |||« \ }}t |« }t ||¬« }t ||¬« S )a
|
Return a fixed frequency PeriodIndex.
|
|
The day (calendar) is the default frequency.
|
|
Parameters
|
----------
|
start : str, datetime, date, pandas.Timestamp, or period-like, default None
|
Left bound for generating periods.
|
end : str, datetime, date, pandas.Timestamp, or period-like, default None
|
Right bound for generating periods.
|
periods : int, default None
|
Number of periods to generate.
|
freq : str or DateOffset, optional
|
Frequency alias. By default the freq is taken from `start` or `end`
|
if those are Period objects. Otherwise, the default is ``"D"`` for
|
daily frequency.
|
name : str, default None
|
Name of the resulting PeriodIndex.
|
|
Returns
|
-------
|
PeriodIndex
|
|
Notes
|
-----
|
Of the three parameters: ``start``, ``end``, and ``periods``, exactly two
|
must be specified.
|
|
To learn more about the frequency strings, please see `this link
|
<https://pandas.pydata.org/pandas-docs/stable/user_guide/timeseries.html#offset-aliases>`__.
|
|
Examples
|
--------
|
>>> pd.period_range(start='2017-01-01', end='2018-01-01', freq='M')
|
PeriodIndex(['2017-01', '2017-02', '2017-03', '2017-04', '2017-05', '2017-06',
|
'2017-07', '2017-08', '2017-09', '2017-10', '2017-11', '2017-12',
|
'2018-01'],
|
dtype='period[M]')
|
|
If ``start`` or ``end`` are ``Period`` objects, they will be used as anchor
|
endpoints for a ``PeriodIndex`` with frequency matching that of the
|
``period_range`` constructor.
|
|
>>> pd.period_range(start=pd.Period('2017Q1', freq='Q'),
|
... end=pd.Period('2017Q2', freq='Q'), freq='M')
|
PeriodIndex(['2017-03', '2017-04', '2017-05', '2017-06'],
|
dtype='period[M]')
|
r zOOf the three parameters: start, end, and periods, exactly two must be specifiedÚDr) rI ) ÚcomÚcount_not_nonern ra r
|
r Ú_generate_ranger r9 )rº r» r r( rJ r& r* s r0 Ú period_rangerÙ # s ôp ×Ñ% gÓ.°!Ò3Üð ,ó
|
ð
|
ð |Z¨¬vÔ 6¼zÈ#ÌvÔ?VØä ×,Ñ,¨U°C¸À$ÓGJD$Ü Ó EÜ t 5Ô )DÜ t $Ô 'Ð'r2 )NNNNN)r z
|
int | NonerJ rÆ rÄ r9 )EÚ
|
__future__r r r Útypingr ri Únumpyro Ú pandas._libsr r> Úpandas._libs.tslibsr r r
|
r r Úpandas._libs.tslibs.dtypesr Úpandas.util._decoratorsr r Úpandas.util._exceptionsr Úpandas.core.dtypes.commonr Úpandas.core.dtypes.dtypesr Úpandas.core.dtypes.genericr Úpandas.core.dtypes.missingr Úpandas.core.arrays.periodr r r r Úpandas.core.commonÚcoreÚcommonrÖ Úpandas.core.indexes.baseÚindexesr
Úibaser Ú pandas.core.indexes.datetimeliker Ú pandas.core.indexes.datetimesr r Ú pandas.core.indexes.extensionr Úcollections.abcr Úpandas._typingr r r! r" ÚdictÚ_index_doc_kwargsÚupdaterÐ r1 Ú
|
_field_opsr9 rÙ r` r2 r0 ú<module>rö s7 ðÝ "÷õ !Û ã å *÷õ õ @÷õ 5å 0Ý 1Ý 0Ý <÷ó ÷ !Ð ß (Ó (Ý 7Ý B÷õ 8áÝ(÷ó ñ ×0Ñ0Ó1Ð Ø × Ñ .Ð*JÐKÔ Là ]ðÐ ò ñ Ú*¨[×-CÑ-CÑCØØ ôñ
|
Ð Ó-ôJ Ð'ó J ó .ó ð J ð\ Ø Ø Ø Ø ð C(ð ðC(ð
|
ð C(ð ô C(r2
|
