U
|
¬ý°dÏ ã @ s d dl mZ d dlmZ d dlZd dlmZmZmZm Z m
|
Z
|
m Z m Z d dl Zd dlmZmZ d dlmZ d dlmZmZmZmZmZmZ m Z m Z m Z m Z!m"Z" d dl#m$Z$ d d l%m&Z& d d
|
l'm(Z(m)Z) d d l*m+Z+m,Z,m-Z-m.Z.m/Z/ d d l0m1Z1m2Z2m3Z3m4Z4 d d l5m6Z6m7Z7 d dl8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?m@Z@ d dlAmBZB d dlCmDZDmEZEmFZFmGZG d dlHmIZI d dlJmK mLZ d dlMmNZO d dlPmK mQZR erÂd dl0mSZSmTZT d dlMmUZUmVZV d dlWmXZX e dedZYddiZZd?ddd d Z[G d d deOj\e!j]Z^d d Z_d@d"d#d$dd%d&d'Z`e ddd(d)d*Zae d+d,d(d-d*Zad.dd(d/d*ZadAd0d1d2d3ZdBd5d6d7d8ZbdCd9d1d:d;Zcd<d1d=d>ZddS )Dé )Ú annotations)Ú timedeltaN)Ú TYPE_CHECKINGÚAnyÚCallableÚLiteralÚSequenceÚTypeVarÚoverload)ÚalgosÚlib)Ú NDArrayBacked) Ú
|
BaseOffsetÚNaTÚNaTTypeÚ TimedeltaÚastype_overflowsafeÚdt64arr_to_periodarrÚget_unit_from_dtypeÚiNaTÚparsingÚperiodÚ to_offset)Ú FreqGroup)Úisleapyear_arr)ÚTickÚ delta_to_tick)ÚDIFFERENT_FREQÚIncompatibleFrequencyÚPeriodÚget_period_field_arrÚperiod_asfreq_arr)Ú AnyArrayLikeÚDtypeÚNpDtypeÚnpt)Úcache_readonlyÚdoc)Ú ensure_objectÚis_datetime64_any_dtypeÚis_datetime64_dtypeÚis_dtype_equalÚis_float_dtypeÚis_integer_dtypeÚis_period_dtypeÚ pandas_dtype)Ú PeriodDtype)ÚABCIndexÚABCPeriodIndexÚ ABCSeriesÚABCTimedeltaArray)Úisna)Ú datetimelike)Ú NumpySorterÚNumpyValueArrayLike)Ú DatetimeArrayÚTimedeltaArray)ÚExtensionArrayÚ BaseOffsetT)ÚboundÚklassÚ PeriodArrayÚstr©Únamec s fdd} |_ ||_t|S )Nc s | j j}t | j|}|S ©N)ÚfreqÚ_period_dtype_coder Úasi8)ÚselfÚbaseÚresultrA © úPd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/core/arrays/period.pyÚfh s z_field_accessor.<locals>.f)Ú__name__Ú__doc__Úproperty)rB Z docstringrL rJ rA rK Ú_field_accessorg s rP c s^ e Zd ZU dZdZdZe e¡Z e
|
fZ e Z dZeddddZg Zd ed
|
< d gZd ed < d ddgZd ed< dddddddddddd d d d d d!gZd ed"< ee e Zd ed#< d$d%d&gZd ed'< d(ed)< dd,d-d.d/d0d1Zedd2d3d,d d4d5d6Zed*d+d7d8d9d,d-d d:d;d<Zed*d+d7d,d-d d/d=d>Z edd dd?d@Z edAdB Z dCdDdEdFdGZ dHdIdEdJdKZ d.ddLdMZ!e"d(ddNdOZ#edPddQdRZ$ddSd2dTdUdVZ%ddWdXZ&e'ddYZ(e'ddZZ)e'dd[Z*e'dd\Z+e'dd]Z,e'dd^Z-e'dd_Z.e.Z/e'dd`Z0e0Z1e1Z2e'd da Z3Z4e'd dbZ5e'd Z6e'd dcZ7e7Z8ed2ddddeZ9ddHdgdhdidjZ:dCddkdlZ;e<f e=dmdmdnd dHd dhdpdqZ>d¡d-drdsdtZ?e@jAdud*dvdwdxdydzd{ZBd¢d-d} fd~d ZCd£ddddd
ddZDd¤d d fdd ZEddd dddZFdPdddZG fddZHdd dddZIdd ZJ ZKS )¥r? a)
|
Pandas ExtensionArray for storing Period data.
|
|
Users should use :func:`~pandas.period_array` to create new instances.
|
Alternatively, :func:`~pandas.array` can be used to create new instances
|
from a sequence of Period scalars.
|
|
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`.
|
iè Z periodarray)r z type[Period]©Úreturnc C s t S rC )r ©rG rJ rJ rK Ú _scalar_type± s zPeriodArray._scalar_typez list[str]Ú
|
_other_opsÚ is_leap_yearÚ _bool_opsÚ
|
start_timeZend_timerD Ú _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_methodsr0 Ú_dtypeNFz Dtype | NoneÚboolÚNone)ÚdtypeÚcopyrR c C s t ||}|d k r t |¡}t|trD|j}t|t| sTtdnt|trT|j}t|t| r|d k r~||j kr~t
|
|||j |j }}t j |d|d}|d kr¬tdt | |t|¡ d S )NzIncorrect dtypeÚint64©rt ru z,freq is not specified and cannot be inferred)Úvalidate_dtype_freqr Ú_maybe_convert_freqÚ
|
isinstancer3 Ú_valuesÚtypeÚ TypeErrorr2 rD Úraise_on_incompatibleÚ_ndarrayÚnpÚarrayÚ
|
ValueErrorr Ú__init__r0 )rG Úvaluesrt rD ru rJ rJ rK r Ô s"
|
|
|
|
|
|
zPeriodArray.__init__z
|
np.ndarrayzBaseOffset | None)r rD rt rR c C s0 d}t |tjr|jdks"t|| |||dS )Nz Should be numpy array of type i8Úi8)rD rt )rz r Úndarrayrt ÚAssertionError)Úclsr rD rt Z assertion_msgrJ rJ rK Ú _simple_newï s zPeriodArray._simple_newrw ztype[PeriodArray]z&Sequence[Period | None] | AnyArrayLike)r Úscalarsrt ru rR c C st |rt |tr|j}nd }t || r@t|j| |r<| ¡ }|S tj|td}|pZt
|
|¡}t ||¡}| ||dS )N©rt ©rD ) rz r0 rD rx rt ru r ÚasarrayÚobjectÚ libperiodZ extract_freqZextract_ordinals)r r rt ru rD ÚperiodsÚordinalsrJ rJ rK Ú_from_sequenceû s
|
zPeriodArray._from_sequencec C s | j |||dS )Nrw )r )r Ústringsrt ru rJ rJ rK Ú_from_sequence_of_strings s z%PeriodArray._from_sequence_of_stringsc C s t |||\}}| ||dS )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 )r )r ÚdatarD ÚtzrJ rJ rK Ú_from_datetime64 s z PeriodArray._from_datetime64c C s t |¡}|d k r t |¡}t|}|d k s4|d k rX|dkrDtdt||||\}}n(|dkrxtf d|i|\}}ntd||fS )Nr z=Can either instantiate from fields or endpoints, but not bothrD z/Not enough parameters to construct Period range)ÚdtlZvalidate_periodsr ry Úlenr Ú_get_ordinal_rangeÚ_range_from_fields)r ÚstartÚendr rD ÚfieldsZ field_countZsubarrrJ rJ rK Ú_generate_range, s
|
|
ÿzPeriodArray._generate_rangezPeriod | NaTTypeznp.int64)ÚvaluerR c C sJ |t krt |j¡S t|| jr6| |¡ t |j¡S td| dd S )Nz!'value' should be a Period. Got 'z
|
' instead.) r r rv Ú_valuerz rT Ú_check_compatible_withÚordinalr ©rG r rJ rJ rK Ú _unbox_scalarG s
|
zPeriodArray._unbox_scalarr@ r c C s t || jdS )Nr )r rD r¤ rJ rJ rK Ú_scalar_from_stringT s z PeriodArray._scalar_from_stringc C s |t kr d S | |¡ d S rC )r Ú_require_matching_freq©rG ÚotherrJ rJ rK r¢ W s z"PeriodArray._check_compatible_withc C s | j S rC )rq rS rJ rJ rK rt _ s zPeriodArray.dtyper c C s | j jS )zC
|
Return the frequency object for this PeriodArray.
|
©rt rD rS rJ rJ rK rD d s zPeriodArray.freqzNpDtype | None)rt rR c C s0 |dkr| j S |tkr | j S tjt| tdS )Nr
r )rF rr Ú_isnanr r Úlistr )rG rt rJ rJ rK Ú __array__k s
|
zPeriodArray.__array__c C s® ddl }ddlm} |dk r|j |¡r>|j| j| ¡ |dS t||rp| j |j
|
krt d| j d|j
|
dnt d| d || j }|j| j| ¡ d
|
d}|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' typerv )ÚpyarrowZ(pandas.core.arrays.arrow.extension_typesr® ÚtypesÚ
|
is_integerr r r5 rz ÚfreqstrrD r} r; Z from_storage)rG r| r± r® Z period_typeZ storage_arrayrJ rJ rK Ú__arrow_array__t s
|
ÿ
|
ÿ
|
zPeriodArray.__arrow_array__z)
|
The year of the period.
|
z6
|
The month as January=1, December=12.
|
z)
|
The days of the period.
|
z)
|
The hour of the period.
|
z+
|
The minute of the period.
|
z+
|
The second of the period.
|
z/
|
The week ordinal of the year.
|
z>
|
The day of the week with Monday=0, Sunday=6.
|
z.
|
The ordinal day of the year.
|
z*
|
The quarter of the date.
|
z2
|
The number of days in the month.
|
c C s t t | j¡S )zH
|
Logical indicating if the date belongs to a leap year.
|
)r r r rZ rS rJ rJ rK rV Ú s zPeriodArray.is_leap_yearr r9 )ÚhowrR c C s2 ddl m} t |¡}|dk}|rx|dks4| jdkrXtddtdd }| jdd | S tdd}| | j jdd | S |d
|
kr| j ¡ }|}nt
|
|¡}|j }| j ||d }t |j|¡}||} | jjdkr$t | j¡}
|
t|
|
dkr |
|
d } | | jjkr | j| _n| dkr | jj| _| S | d ¡S 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
|
r )r9 ÚEÚBé ÚDÚnsr )r¶ NZinfer)Úpandas.core.arraysr9 r Úvalidate_end_aliasrD r rn rq Z_get_to_timestamp_baser ry rE ro Zperiodarr_to_dt64arrrF rB ÚlibalgosZ unique_deltasr ÚnZ_freqrH Z
|
_with_freq) rG rD r¶ r9 r ÚadjustrH Znew_parrÚnew_dataÚdtaZdiffsZdiffrJ rJ rK rn á s6
|
|
|
|
|
|
|
zPeriodArray.to_timestampc C s t j|| jdS )N)r£ rD )r Z _from_ordinalrD )rG ÚxrJ rJ rK Ú _box_func s zPeriodArray._box_funcZ PeriodIndex)r© Z
|
other_namer· c C sx t |¡}t |¡}| jj}|j}| j}|dk}|rF|| jj d }n|}t
|
||||}| j rht || j < t| ||dS )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='A')
|
>>> pidx
|
PeriodIndex(['2010', '2011', '2012', '2013', '2014', '2015'],
|
dtype='period[A-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 ry rq Z _dtype_coderE rF rD r¿ r! Ú_hasnar r« r| ) rG rD r¶ Zbase1Zbase2rF r r£ rÁ rJ rJ rK ro s .
|
|
|
zPeriodArray.asfreq)Úboxedc C s |rt S djS )Nz'{}')r@ Úformat)rG rÆ rJ rJ rK Ú
|
_formatterf s zPeriodArray._formatterr )Úna_repÚ date_formatz str | floatznpt.NDArray[np.object_])rÉ rR c s| | t¡} r fddndd | jr`| j}|||< | }t fdd|| D ¡||< nt fdd|D ¡}|S )z3
|
actually format my specific types
|
c s
|
| ¡S rC )rm ©Úper)rÊ rJ rK Ú<lambda>v ó z2PeriodArray._format_native_types.<locals>.<lambda>c S s t | S rC )r@ rË rJ rJ rK rÍ y rÎ c s g | ] } |qS rJ rJ ©Ú.0rÌ ©Ú formatterrJ rK Ú
|
<listcomp> s z4PeriodArray._format_native_types.<locals>.<listcomp>c s g | ] } |qS rJ rJ rÏ rÑ rJ rK rÓ s )Úastyper rÅ r« r r )rG rÉ rÊ Úkwargsr r¯ ZimaskrJ )rÊ rÒ rK Ú_format_native_typesk s
|
"z PeriodArray._format_native_typesT©ru c sj t |}t|| jr$|s | S | ¡ S t|r8| |j¡S t|rZt|dd }| ¡
|
|¡S t j ||dS )Nr r× ) r/ r+ rq ru r. ro rD r) Úgetattrrn Z tz_localizeÚsuperrÔ )rG rt ru r ©Ú __class__rJ rK rÔ s zPeriodArray.astypeÚleftz$NumpyValueArrayLike | ExtensionArrayzLiteral[('left', 'right')]r7 z npt.NDArray[np.intp] | np.intp)r ÚsideÚsorterrR c C s, | |¡ d¡}| j d¡}|j|||dS )NúM8[ns])rÝ rÞ )Z_validate_setitem_valueÚviewr Ú searchsorted)rG r rÝ rÞ ZnpvalueZm8arrrJ rJ rK rá s zPeriodArray.searchsortedc s@ |d k r.| d¡}|j|||d}| | j¡S t j|||dS )Nrß )r ÚmethodÚlimit)rà Úfillnart rÙ )rG r râ rã r rI rÚ rJ rK rä § s
|
|
zPeriodArray.fillnaznp.ndarray | intzCallable[[Any, Any], Any])r© ÚoprR c C sJ |t jt jfkst|t jkr$| }tj| j|| jd}t| || j dS )zì
|
Add or subtract array of integers.
|
|
Parameters
|
----------
|
other : np.ndarray[int64] or int
|
op : {operator.add, operator.sub}
|
|
Returns
|
-------
|
result : PeriodArray
|
)Úarr_maskr )
|
ÚoperatorÚaddÚsubr r Úchecked_add_with_arrrF r« r| rD )rG r© rå Ú
|
res_valuesrJ rJ rK Ú_addsub_int_array_or_scalarµ s
|
|
z'PeriodArray._addsub_int_array_or_scalar)r© c C s, t |trt| j|dd | |jtj¡S )NT)rH )rz r r r§ rì r¿ rç rè r¨ rJ rJ rK Ú _add_offsetÊ s zPeriodArray._add_offsetc sD t | jtst| |t|r*t |¡S t t |j
|
¡}| |¡S )z
|
Parameters
|
----------
|
other : timedelta, Tick, np.timedelta64
|
|
Returns
|
-------
|
PeriodArray
|
) rz rD r r~ r5 rÙ Ú_add_timedeltalike_scalarr r r Úasm8Ú_add_timedelta_arraylike)rG r© ÚtdrÚ rJ rK rî Ñ s
|
|
z%PeriodArray._add_timedeltalike_scalarz,TimedeltaArray | npt.NDArray[np.timedelta64])r© rR c
|
C sÈ | j }t|ts td| j t d|j d¡}ztt |¡|ddd}W n, t k
|
rz } zt
|
d|W 5 d}~X Y nX t |¡}t j | j| d¡| j|d }t || j|B t¡ t| || j d
|
S ) z
|
Parameters
|
----------
|
other : TimedeltaArray or ndarray[timedelta64]
|
|
Returns
|
-------
|
PeriodArray
|
z2Cannot add or subtract timedelta64[ns] dtype from úm8[ú]F©rt ru Zround_okznCannot add/subtract timedelta-like from PeriodArray that is not an integer multiple of the PeriodArray's freq.Nr
)ræ Úb_maskr )rD rz r r} rt r Ú
|
_td64_unitr r r r Zisnatr rê rF rà r« Zputmaskr r| )rG r© rD rt ÚdeltaÚerrrõ rë rJ rJ rK rð æ s8
|
|
ÿ ÿ
|
ÿý
|
ÿz$PeriodArray._add_timedelta_arraylikec
|
C s¬ t | jtstt d| jj d¡}t |ttjtfrJt t
|
|j ¡}n
|
t |¡}zt ||ddd}W n. t k
|
r } zt| ||W 5 d}~X Y nX | d¡}t |¡S )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
|
rò ró Frô Nr
)rz rD r r r rt rö r Z timedelta64r r rï r r r~ rà r Zitem_from_zerodim)rG r© rt rñ r÷ rø rJ rJ rK Ú _check_timedeltalike_freq_compat s
|
|
z,PeriodArray._check_timedeltalike_freq_compat)NNF)NN)N)N)N)Nr )Nr· )F)T)rÜ N)NNN)LrM Ú
|
__module__Ú __qualname__rN Z__array_priority__Z_typr rv r Z_internal_fill_valuer Z_recognized_scalarsr. Z_is_recognized_dtypeZ_infer_matchesrO rT rU Ú__annotations__rW rY rk rl rp r Ú classmethodr r r r r r¥ r¦ r¢ r& rt rD r rµ rP rZ r[ r\ r] r^ r_ r` rb rd rc ra re rf rg rh ri rj rV rn rÄ r' Ú_shared_doc_kwargsro rÈ r Z ravel_compatrÖ rÔ rá rä rì rí rî rð rù Ú __classcell__rJ rJ rÚ rK r? r s
|
7
|
ï ÿ ü û ÿ
|
|
þþþþþþþþþþþ;F ÿ ü )c C sf t |tjtfs|dkr d}n(t |ttttfr8|j}nt t
|
|j}t j t | j| j|d}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 Zown_freqÚ
|
other_freq)rz r r r4 r2 r? r r r´ r r r rÇ r| rM r )rÜ Úrightr ÚmsgrJ rJ rK r~ 5 s ÿr~ Fz,Sequence[Period | str | None] | AnyArrayLikezstr | Tick | Nonerr )r rD ru rR c C sÐ t | dd}t|r t | |¡S t|r4t| |dS t| tjtt t
|
fsPt| } t | ¡}|rht |}nd}t |rt|dkrtdt|jrº|jtjdd}t ||¡}t||dS t|} tj| |dS ) 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='A'),
|
... pd.Period('2018', freq='A')])
|
<PeriodArray>
|
['2017', '2018']
|
Length: 2, dtype: period[A-DEC]
|
|
>>> period_array([pd.Period('2017', freq='A'),
|
... pd.Period('2018', freq='A'),
|
... pd.NaT])
|
<PeriodArray>
|
['2017', '2018', 'NaT']
|
Length: 3, dtype: period[A-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]
|
rt Nr r z9PeriodIndex does not allow floating point in constructionFr× r )rØ r* r? r r. rz r r r¬ Útupler3 r r0 r, r r} r- rt rÔ rv r Z from_ordinalsr( r )r rD ru Z
|
data_dtypeZarrdatart Zarrr rJ rJ rK Ú period_arrayV s& :
|
|
|
r )rD rR c C s d S rC rJ rª rJ rJ rK rx ² s rx ztimedelta | str | Noner c C s d S rC rJ rª rJ rJ rK rx · s z$BaseOffsetT | timedelta | str | Nonec C sV |dk rt |}| dk rRt| } t| s0td|dkr@| j}n|| jkrRtd|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
|
Nzdtype must be PeriodDtypez&specified freq and dtype are different)r r/ r. r rD r rª rJ rJ rK rx ¼ s
|
z(tuple[npt.NDArray[np.int64], BaseOffset]rQ c C s° t | jtjr| jjdkr*td| j |dkrht | trL| j| j } }q|t | tr|| j| j j } }nt | ttfr|| j} t
|
| j}t |¡}|j }t| d¡|||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.
|
|
ÚMz Wrong dtype: Nr
)Úreso)rz rt r Úkindr r1 r{ rD r3 Údtr r ry rE Úc_dt64arr_to_periodarrrà )r rD r r rH rJ rJ rK r ä s
|
|
|
|
r r¹ Úint)Úmultc C sH t | ||¡dkrtd|d k r0t|}|j}| d k rBt| |} |d k rTt||}t| t}t|t}|r|r| j|jkrtd| tks|tkrtd|d krÄ|r°| j}n|r¼|j}ntd|d k r$|| }| d krt j
|
|j | | |j d |t j d}n t j
|
| j | j | |t j d}n t j
|
| j |j d |t j d}||fS )Né zOOf the three parameters: start, end, and periods, exactly two must be specifiedz!start and end must have same freqz start and end must not be NaTz#Could not infer freq from start/endr¹ r ) ÚcomZcount_not_noner r r¿ r rz rD r r Zaranger£ rv )r r r rD r Z is_start_perZ
|
is_end_perr rJ rJ rK r sP ÿ
|
|
|
|
|
|
ÿ ÿ r z tuple[np.ndarray, BaseOffset]c C sP |d kr d}|d krd}|d kr$d}|d kr0d}g }|d k rÜ|d krVt d}tjj} n&t |}t |¡} | tjjkr|td|j}
|
t| |\} }t | |D ]>\} } t
|
| | |
|
¡\} } t | | dddddd| ¡ }| |¡ qn`t |}t |¡} t| |||||}t | D ]2\} }}}}}| t | |||||dd| ¡ ¡ qtj|tjd|fS )Nr r¹ ÚQzbase must equal FR_QTRr )r r ZFR_QTRr r Zfreq_to_dtype_coder r´ Ú_make_field_arraysÚzipr Zquarter_to_myearZperiod_ordinalÚappendr r rv )rZ r[ rg r\ r] r^ r_ rD r rH r´ ÚyÚqÚmÚvalZarraysZmthÚdÚhÚmnÚsrJ rJ rK r < s:
|
|
|
|
$r zlist[np.ndarray]c s^ d | D ]B}t |ttjtfr d k r:t| kr:td d krt| q fdd| D S )Nz Mismatched Period array lengthsc s4 g | ],}t |tjttfr$t |¡n
|
t | ¡qS rJ )rz r r r¬ r3 r Úrepeat)rÐ rà ©ÚlengthrJ rK rÓ w s þÿ z&_make_field_arrays.<locals>.<listcomp>)rz r¬ r r r3 r r )r rà rJ r rK r k s
|
|
ür )N)NF)N)r¹ )NNNNNNNN)eÚ
|
__future__r Údatetimer rç Útypingr r r r r r r
|
Únumpyr Z pandas._libsr r¾ r Zpandas._libs.arraysr Zpandas._libs.tslibsr r r r r r r r r r r r r Zpandas._libs.tslibs.dtypesr Zpandas._libs.tslibs.fieldsr Zpandas._libs.tslibs.offsetsr r Zpandas._libs.tslibs.periodr r r r r! Zpandas._typingr" r# r$ r% Zpandas.util._decoratorsr& r' Zpandas.core.dtypes.commonr( r) r* r+ r, r- r. r/ Zpandas.core.dtypes.dtypesr0 Zpandas.core.dtypes.genericr1 r2 r3 r4 Zpandas.core.dtypes.missingr5 Zpandas.core.algorithmsÚcoreZ
|
algorithmsr¼ r6 r Zpandas.core.commonÚcommonr r7 r8 r9 r: Zpandas.core.arrays.baser; r< rþ rP Z DatelikeOpsZ PeriodMixinr? r~ r rx r r r rJ rJ rJ rK Ú<module> sr $
|
4 (
|
ÿ H# ý\) ÿ(1 ø/
|
