pandas.arrays.PeriodArray

classpandas.arrays.PeriodArray(values, dtype=None, freq=None, copy=False)[source]

Pandas ExtensionArray для хранения данных Period.

Пользователи должны использовать array() для создания новых экземпляров.

Параметры:

values:Union[PeriodArray, Series[period], ndarray[int], PeriodIndex]

Данные для хранения. Это должны быть массивы, которые могут быть непосредственно преобразованы в порядковые значения без вывода или копирования (PeriodArray, ndarray[int64]), или контейнер вокруг такого массива (Series[period], PeriodIndex).

dtype:PeriodDtype, optional

Экземпляр PeriodDtype, из которого извлекается freq. Если указаны как freq, так и dtype, то частоты должны совпадать.

freq:str или DateOffset

Используемый freq для массива. В основном применимо, когда values является массивом целых чисел, когда freq требуется. Когда values — PeriodArray (или контейнер вокруг), проверяется, что values.freq соответствует freq.

copy:bool, по умолчанию False

Копировать ли порядковые значения перед хранением.

См. также

Period

Представляет период времени.

PeriodIndex

Неизменяемый индекс для данных периода.

period_range

Создать PeriodArray с фиксированной частотой.

array

Построить массив pandas.

Примечания

PeriodArray состоит из двух компонентов

• ordinals : целочисленный массив ndarray

• freq : pd.tseries.offsets.Offset

Значения физически хранятся как одномерный массив целых чисел ndarray. Они называются «порядковыми значениями» и представляют собой некоторое смещение от базового значения.

Значение freq указывает диапазон, охватываемый каждым элементом массива. Все элементы PeriodArray имеют одинаковый freq.

Примеры

>>> pd.arrays.PeriodArray(pd.PeriodIndex(['2023-01-01',
...                                       '2023-01-02'], freq='D'))
<PeriodArray>
['2023-01-01', '2023-01-02']
Length: 2, dtype: period[D]

Атрибуты

None

Методы

None