U
|
¬ý°dwF ã @ s d dl mZ d dlmZmZ d dlmZ d dlZd dlm Z
|
d dl m Z m Z mZmZmZ d dlmZmZmZ d dlmZmZ d d lmZ d d
|
lmZ d d l m Z d d l m Z d d l m!Z!m"Z"m#Z#m$Z$ d dl%m& m'Z( d dl)m& m* m+Z, d dl)m-Z- d dl.m/Z/ d dl0m1Z1m2Z2 d dl3m4Z4 e5e,j6Z6e6 7ddi¡ ddiZ8dd Z9e4dddge!j: e!dd e4d d ge!G d d d e/Z;d%d!d d"d#d$Z<dS )&é )Ú annotations)ÚdatetimeÚ timedelta)ÚHashableN)Úindex)Ú
|
BaseOffsetÚNaTÚPeriodÚ
|
ResolutionÚTick)ÚDtypeÚDtypeObjÚnpt)Úcache_readonlyÚdoc)Ú
|
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_namesZ target_klassz PeriodIndex or list of PeriodsÚklassr c K sJ | d¡}|jdkr:| dd ¡}t||d}| j|f|S | |f|S d S )NÚdataÚint64Úfreq©r! )ÚpopÚdtyper Ú _simple_new)ÚclsÚdÚvaluesr! © r) úQd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/core/indexes/period.pyÚ_new_PeriodIndex; s
|
|
r+ ÚstrftimeÚ
|
start_timeZend_timeT)ÚwrapZ is_leap_yearZ_format_native_typesc sø e Zd ZU dZdZded< ded< ded< eZd Ze d
|
d d d Z
|
e dd ddZ e ejfdddedUdd dddZe ejdVddddd Ze e ejjd d d d Ze e ejjd d d d!Ze e ejjd d d"d#ZdWd%d&d'd d(d)d*Ze d+d d,d-Zd.d d/d0Zd1d&d2d3d4Zd d5d+d6 fd7d8 Ze d&d d9d:Ze dd d;d<Z fd=d>Z d?d@ Z dAdBdCdDdEZ dFdAdGdHdIZ e e j!ddJ fdKdL Z!ddFdMdNdOZ"e e j#dXdQdRdSdTZ# Z$S )YÚ 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
|
month : int, array, or Series, default None
|
quarter : int, array, or Series, default None
|
day : int, array, or Series, default None
|
hour : int, array, or Series, default None
|
minute : int, array, or Series, default None
|
second : int, array, or Series, default None
|
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
|
|
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(year=[2000, 2002], quarter=[1, 3])
|
>>> idx
|
PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]')
|
Z periodindexr Ú_datar r! r r$ Tztype[libindex.PeriodEngine])Úreturnc C s t jS ©N)ÚlibindexZ PeriodEngine©Úselfr) r) r* Ú _engine_type s zPeriodIndex._engine_typer
|
c C s | j jS r2 )r$ Ú_resolution_objr4 r) r) r* r7 s zPeriodIndex._resolution_objzpandas.arrays.PeriodArray)ÚotherZ
|
other_nameNÚEÚstr)Úhowr1 c C s" | j ||¡}t| j|| jdS ©N©Úname)r0 ÚasfreqÚtyper% r> ©r5 r! r; Zarrr) r) r* r? ¨ s zPeriodIndex.asfreqÚstartr c C s | j ||¡}tj|| jdS r< )r0 Ú to_timestampr r% r> rA r) r) r* rC ² s zPeriodIndex.to_timestampr c C s t | jj| jdS r< )r r0 Úhourr> r4 r) r) r* rD · s zPeriodIndex.hourc C s t | jj| jdS r< )r r0 Úminuter> r4 r) r) r* rE ¼ s zPeriodIndex.minutec C s t | jj| jdS r< )r r0 Úsecondr> r4 r) r) r* rF Á s zPeriodIndex.secondFz Dtype | NoneÚboolr )r$ Úcopyr> r1 c K s8 dddddddh}d } |s.t |ttfr.|j} t| |¡s^tt|| d }
|
td |
|
t||| }|d kr°|d kr°|s| d ¡ t
|
d d d ||¡\}} | }t
|
||d
|
}njt ||}|rÜt || rÜ|j |krÜ| |¡}|d kr|d k rtj|tjd }t
|
||d
|
}n t||d }|r(| ¡ }| j||| d S )NÚyearÚmonthÚdayZquarterrD rE rF r z-__new__() got an unexpected keyword argument r" ©r$ )r r! )r> Úrefs)Ú
|
isinstancer r Z _referencesÚsetÚissubsetÚlistÚ TypeErrorr Z_raise_scalar_data_errorr Ú_generate_ranger r! r? ÚnpÚasarrayr r rH r% ) r& r Zordinalr! r$ rH r> ÚfieldsZvalid_field_setrM ZargumentZfreq2r) r) r* Ú__new__É s> ù
|
|
|
|
zPeriodIndex.__new__z
|
np.ndarrayc C s t j| tdS )NrL )rT rU Úobjectr4 r) r) r* r( s zPeriodIndex.valueszint | npt.NDArray[np.int64]c C sx t |ttjttjfr4t | jtrj| j |¡}|S n6t |t r^|j
|
| jj
|
krR|j S t | |n t |rj|S t | ddS )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)rN r rT Z timedelta64r Zndarrayr! r0 Z _check_timedeltalike_freq_compatr ÚbaseÚnr r )r5 r8 Údeltar) r) r* Ú_maybe_convert_timedelta s
|
z$PeriodIndex._maybe_convert_timedeltar )r$ r1 c C s2 t |tsdS |j}| j}|j|jko0|j|jkS )zF
|
Can we compare values of the given dtype to our own?
|
F)rN r r! Ú_period_dtype_coderZ )r5 r$ r! Zown_freqr) r) r* Ú_is_comparable_dtype6 s
|
þ
|
üz PeriodIndex._is_comparable_dtypeznpt.NDArray[np.bool_])ÚwhereÚmaskr1 c s< t |tr t|j| jd}nt |ts.tdt ||¡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)rN r r/ Z_valuesr! rR ÚsuperÚ asof_locs)r5 r_ r` ©Ú __class__r) r* rb L s
|
|
|
zPeriodIndex.asof_locsc C sH t | dkrdS | js td| j}t|dd
|dd
dk ¡ 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éÿÿÿÿé )ÚlenZis_monotonic_increasingÚ
|
ValueErrorZasi8rG Úall)r5 r( r) r) r* Úis_fullY s zPeriodIndex.is_fullc C s dS )NÚperiodr) r4 r) r) r* Ú inferred_typef s zPeriodIndex.inferred_typec s( t ||¡}| j|jkr$| |¡}|S r2 )ra Ú_convert_tolerancer$ r\ )r5 Z toleranceÚtargetrc r) r* rn o s
|
z PeriodIndex._convert_tolerancec
|
C sP |}| |¡ t|| jr t}nît|trØz| |¡\}}W n4 tk
|
rp } ztd| d|W 5 d}~X Y nX | |¡r¸z|
|
||¡W S tk
|
r¶ } zt||W 5 d}~X Y nX || j krÎ| |¡}nt|n6t|t rî| |¡ n t|tr| |¡}nt|zt | |¡W S tk
|
rJ } zt||W 5 d}~X Y nX dS )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)Z_check_indexing_errorr r$ r rN r: Z_parse_with_resori ÚKeyErrorZ_can_partial_date_sliceZ_partial_date_slicer7 Ú _cast_partial_indexing_scalarr Ú _disallow_mismatched_indexingr r Úget_loc)r5 ÚkeyZorig_keyÚparsedÚresoÚerrr) r) r* rs | s4
|
|
$
|
|
|
|
zPeriodIndex.get_locr ÚNone)rt r1 c C s0 | j }|j }|j|jkr$|j|jks,t|d S r2 )r! rZ r] rp )r5 rt ZsfreqZkfreqr) r) r* rr º s
|
ÿþý
|
z)PeriodIndex._disallow_mismatched_indexingr )Úlabelr1 c
|
C sD zt || jd}W n, tk
|
r> } zt||W 5 d }~X Y nX |S )Nr" )r r! ri rp )r5 ry rl rw r) r) r* rq É s
|
z)PeriodIndex._cast_partial_indexing_scalar)Úsidec s" t |tr| |¡}t ||¡S r2 )rN r rq ra Ú_maybe_cast_slice_bound)r5 ry rz rc r) r* r{ Ñ s
|
|
z#PeriodIndex._maybe_cast_slice_bound)rv ru c C s. t ||jd}|j| jdd|j| jddfS )Nr" rB )r; Úend)r Z attr_abbrevr? r! )r5 rv ru Zivr) r) r* Ú_parsed_string_to_boundsØ s z$PeriodIndex._parsed_string_to_boundsre Úint)Úperiodsc C s& |d k r t dt| j d| | S )Nz%`freq` argument is not supported for z.shift)rR r@ Ú__name__)r5 r r! r) r) r* ÚshiftÜ s
|
ÿzPeriodIndex.shift)Nr9 )NrB )NNNNFN)re N)%r Ú
|
__module__Ú __qualname__Ú__doc__Z_typÚ__annotations__r Z _data_clsZ!_supports_partial_string_indexingÚpropertyr6 r r7 r r? Ú_shared_doc_kwargsrC rD ÚfgetrE rF rW r( r\ r^ rb rk rm rn rs rr rq r r{ r} r Ú __classcell__r) r) rc r* r/ F sp
|
Eÿýü
|
|
|
ùE$ >r/ z
|
int | None)r r1 c C sj t | ||¡dkrtd|dkr:t| ts:t|ts:d}tj| |||i d\}}t||d}t||dS )a»
|
Return a fixed frequency PeriodIndex.
|
|
The day (calendar) is the default frequency.
|
|
Parameters
|
----------
|
start : str or period-like, default None
|
Left bound for generating periods.
|
end : str 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]')
|
rg zOOf the three parameters: start, end, and periods, exactly two must be specifiedNÚD)rV r" r= )ÚcomZcount_not_noneri rN r r rS r/ )rB r| r r! r> r r) r) r* Ú period_rangeå s 4ÿ r )NNNNN)=Ú
|
__future__r r r Útypingr ÚnumpyrT Z pandas._libsr r3 Zpandas._libs.tslibsr r r r
|
r Zpandas._typingr r r Zpandas.util._decoratorsr r Zpandas.core.dtypes.commonr Zpandas.core.dtypes.dtypesr Zpandas.core.dtypes.genericr Zpandas.core.dtypes.missingr Zpandas.core.arrays.periodr r r r Zpandas.core.commonÚcoreÚcommonr Zpandas.core.indexes.baseZindexesrY Zibaser Z pandas.core.indexes.datetimeliker Z pandas.core.indexes.datetimesr r Z pandas.core.indexes.extensionr ÚdictZ_index_doc_kwargsÚupdater r+ Z
|
_field_opsr/ r r) r) r) r* Ú<module> sP
|
ÿ ý ÿ
|
