U
|
¬ý°d¦& ã @ s d Z ddlmZ ddlmZmZ ddlmZm Z m
|
Z
|
ddl m Z ddl mZmZmZ ddlmZ ddlmZ dd lmZ dd
|
lm mZ dd l m Z m Z dd l m Z dd l!m"Z" e"dddddddgej# edde"dddddd geG d d d e Z$d%d
|
d d d!d d"d#d$Z%d
|
S )&z implement the TimedeltaIndex é )Ú annotations)ÚindexÚlib)Ú
|
ResolutionÚ TimedeltaÚ to_offset)ÚDtypeObj)Úis_dtype_equalÚ is_scalarÚis_timedelta64_dtype)Ú ABCSeries)Ú datetimelike)ÚTimedeltaArrayN)ÚIndexÚmaybe_extract_name)ÚDatetimeTimedeltaMixin)Ú inherit_namesÚ__neg__Ú__pos__Ú__abs__Ú total_secondsÚroundÚfloorÚceilT)ÚwrapÚ
|
componentsZto_pytimedeltaÚsumZstdZmedianZ_format_native_typesc @ s² e Zd ZU dZdZeZeddddZde d< e
|
j Z ed dd
|
d Z d d e jd d d d fddddZdddddZdd ZddddZd d d d Zeddd d!Zd S )"ÚTimedeltaIndexa
|
Immutable Index of timedelta64 data.
|
|
Represented internally as int64, and scalars returned Timedelta objects.
|
|
Parameters
|
----------
|
data : array-like (1-dimensional), optional
|
Optional timedelta-like data to construct index with.
|
unit : unit of the arg (D,h,m,s,ms,us,ns) denote the unit, optional
|
Which is an integer/float number.
|
freq : str or pandas offset object, optional
|
One of pandas date offset strings or corresponding objects. The string
|
'infer' can be passed in order to set the frequency of the index as the
|
inferred frequency upon creation.
|
copy : bool
|
Make a copy of input ndarray.
|
name : object
|
Name to be stored in the index.
|
|
Attributes
|
----------
|
days
|
seconds
|
microseconds
|
nanoseconds
|
components
|
inferred_freq
|
|
Methods
|
-------
|
to_pytimedelta
|
to_series
|
round
|
floor
|
ceil
|
to_frame
|
mean
|
|
See Also
|
--------
|
Index : The base pandas Index type.
|
Timedelta : Represents a duration between two dates or times.
|
DatetimeIndex : Index of datetime64 data.
|
PeriodIndex : Index of Period data.
|
timedelta_range : Create a fixed-frequency TimedeltaIndex.
|
|
Notes
|
-----
|
To learn more about the frequency strings, please see `this link
|
<https://pandas.pydata.org/pandas-docs/stable/user_guide/timeseries.html#offset-aliases>`__.
|
Ztimedeltaindexz type[libindex.TimedeltaEngine])Úreturnc C s t jS ©N)ÚlibindexZTimedeltaEngine©Úself© r# úUd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\pandas/core/indexes/timedeltas.pyÚ _engine_typel s zTimedeltaIndex._engine_typer Ú_datazResolution | Nonec C s | j jS r )r& Ú_resolution_objr! r# r# r$ r' w s z TimedeltaIndex._resolution_objNFÚbool)Úcopyc
|
C sô t ||| }t|r | |¡ |dkr.tdt|trp|tjkrp|d ksVt||j rp|rb|
|
¡ }| j ||dS t|t r´|tjkr´|d kr´|d ks t||j r´|r¬|
|
¡ S | ¡ S tj|||||d}d } |sät|ttfrä|j} | j ||| dS )N> ÚMÚYÚyzqUnits 'M', 'Y', and 'y' are no longer supported, as they do not represent unambiguous timedelta values durations.©Úname)ÚfreqÚunitÚdtyper) )r. Úrefs)r r
|
Z_raise_scalar_data_errorÚ
|
ValueErrorÚ
|
isinstancer r Ú
|
no_defaultr r1 r) Ú _simple_newr Z_viewZ_from_sequence_not_strictr r Z _references)
|
ÚclsÚdatar0 r/ Úclosedr1 r) r. Útdarrr2 r# r# r$ Ú__new__~ sT
|
|
ÿÿþý
|
ýÿþýü
|
ü ÿzTimedeltaIndex.__new__r )r1 r c C s t |S )zF
|
Can we compare values of the given dtype to our own?
|
)r )r" r1 r# r# r$ Ú_is_comparable_dtype´ s z#TimedeltaIndex._is_comparable_dtypec
|
C sX | |¡ z| jj|dd}W n, tk
|
rJ } zt||W 5 d}~X Y nX t | |¡S )z
|
Get integer location for requested label
|
|
Returns
|
-------
|
loc : int, slice, or ndarray[int]
|
F)ZunboxN)Z_check_indexing_errorr& Z_validate_scalarÚ TypeErrorÚKeyErrorr Úget_loc)r" ÚkeyÚerrr# r# r$ r? ½ s
|
zTimedeltaIndex.get_locÚstr)Úlabelc C s t |}|d fS r )r )r" rC Úparsedr# r# r$ Ú_parse_with_resoÎ s z TimedeltaIndex._parse_with_resor )rD c C s, | |j¡}|t|j tdd }||fS )Né Úns)r Zresolution_stringr r )r" ZresorD ZlboundZrboundr# r# r$ Ú_parsed_string_to_boundsÓ s z'TimedeltaIndex._parsed_string_to_boundsc C s dS )NZ timedelta64r# r! r# r# r$ Ú inferred_typeÛ s z TimedeltaIndex.inferred_type)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Z_typr Z _data_clsÚpropertyr% Ú__annotations__r Z_get_string_slicer' r r5 r; r< r? rE rH rI r# r# r# r$ r ! s.
|
5ø6 r )r0 z
|
int | Nonez
|
str | None)Úperiodsr0 r c C sL |dkrt || |¡rd}t |¡\}}tj| |||||d}tj||dS )a3
|
Return a fixed frequency TimedeltaIndex with day as the default.
|
|
Parameters
|
----------
|
start : str or timedelta-like, default None
|
Left bound for generating timedeltas.
|
end : str or timedelta-like, default None
|
Right bound for generating timedeltas.
|
periods : int, default None
|
Number of periods to generate.
|
freq : str or DateOffset, default 'D'
|
Frequency strings can have multiples, e.g. '5H'.
|
name : str, default None
|
Name of the resulting TimedeltaIndex.
|
closed : str, default None
|
Make the interval closed with respect to the given frequency to
|
the 'left', 'right', or both sides (None).
|
unit : str, default None
|
Specify the desired resolution of the result.
|
|
.. versionadded:: 2.0.0
|
|
Returns
|
-------
|
TimedeltaIndex
|
|
Notes
|
-----
|
Of the four parameters ``start``, ``end``, ``periods``, and ``freq``,
|
exactly three must be specified. If ``freq`` is omitted, the resulting
|
``TimedeltaIndex`` will have ``periods`` linearly spaced elements between
|
``start`` and ``end`` (closed on both sides).
|
|
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.timedelta_range(start='1 day', periods=4)
|
TimedeltaIndex(['1 days', '2 days', '3 days', '4 days'],
|
dtype='timedelta64[ns]', freq='D')
|
|
The ``closed`` parameter specifies which endpoint is included. The default
|
behavior is to include both endpoints.
|
|
>>> pd.timedelta_range(start='1 day', periods=4, closed='right')
|
TimedeltaIndex(['2 days', '3 days', '4 days'],
|
dtype='timedelta64[ns]', freq='D')
|
|
The ``freq`` parameter specifies the frequency of the TimedeltaIndex.
|
Only fixed frequencies can be passed, non-fixed frequencies such as
|
'M' (month end) will raise.
|
|
>>> pd.timedelta_range(start='1 day', end='2 days', freq='6H')
|
TimedeltaIndex(['1 days 00:00:00', '1 days 06:00:00', '1 days 12:00:00',
|
'1 days 18:00:00', '2 days 00:00:00'],
|
dtype='timedelta64[ns]', freq='6H')
|
|
Specify ``start``, ``end``, and ``periods``; the frequency is generated
|
automatically (linearly spaced).
|
|
>>> pd.timedelta_range(start='1 day', end='5 days', periods=4)
|
TimedeltaIndex(['1 days 00:00:00', '2 days 08:00:00', '3 days 16:00:00',
|
'5 days 00:00:00'],
|
dtype='timedelta64[ns]', freq=None)
|
|
**Specify a unit**
|
|
>>> pd.timedelta_range("1 Day", periods=3, freq="100000D", unit="s")
|
TimedeltaIndex(['1 days 00:00:00', '100001 days 00:00:00',
|
'200001 days 00:00:00'],
|
dtype='timedelta64[s]', freq='100000D')
|
NÚD)r9 r0 r- )ÚcomZany_noneÚdtlZmaybe_infer_freqr Z_generate_ranger r6 ) ÚstartÚendrP r/ r. r9 r0 Ú_r: r# r# r$ Útimedelta_rangeà s T ÿrW )NNNNNN)&rM Ú
|
__future__r Z pandas._libsr r r Zpandas._libs.tslibsr r r Zpandas._typingr Zpandas.core.dtypes.commonr r
|
r Zpandas.core.dtypes.genericr Zpandas.core.arraysr rS Z pandas.core.arrays.timedeltasr Zpandas.core.commonÚcoreÚcommonrR Zpandas.core.indexes.baser r Z pandas.core.indexes.datetimeliker Z pandas.core.indexes.extensionr Z
|
_field_opsr rW r# r# r# r$ Ú<module> sP ÿüú÷ 0 úø
|
