pandas.arrays.TimedeltaArray#

class pandas.arrays.TimedeltaArray(data, dtype=None, freq=None, copy=False)[source]#

Pandas ExtensionArray for timedelta data.

Warning

TimedeltaArray is currently experimental, and its API may change without warning. In particular, TimedeltaArray.dtype is expected to change to be an instance of an ExtensionDtype subclass.

Parameters:
dataarray-like

The timedelta data.

dtypenumpy.dtype

Currently, only numpy.dtype("timedelta64[ns]") is accepted.

freqOffset, optional

Frequency of the data.

copybool, default False

Whether to copy the underlying array of data.

Attributes

None

Methods

None

See also

Timedelta

Represents a duration, the difference between two dates or times.

TimedeltaIndex

Immutable Index of timedelta64 data.

to_timedelta

Convert argument to timedelta.

Examples

>>> pd.arrays.TimedeltaArray._from_sequence(pd.TimedeltaIndex(["1h", "2h"]))
<TimedeltaArray>
['0 days 01:00:00', '0 days 02:00:00']
Length: 2, dtype: timedelta64[ns]