pandas.arrays.PeriodArray#

класс pandas.arrays.PeriodArray(values, dtype=None, freq=None, copy=False)[источник]#

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

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

Параметры:

valuesUnion[PeriodArray, Series[period], ndarray[int], PeriodIndex]: Данные для хранения. Это должны быть массивы, которые можно напрямую преобразовать в ординалы без вывода или копирования (PeriodArray, ndarray[int64]), или обертка вокруг такого массива (Series[period], PeriodIndex).
dtypePeriodDtype, опционально: Экземпляр PeriodDtype, из которого извлекается freq. Если оба freq и dtype указаны, то частоты должны совпадать.
freqstr или DateOffset: The freq для использования в массиве. В основном применимо, когда values является ndarray целых чисел, когда freq требуется. Когда values является PeriodArray (или оберткой), проверяется, что values.freq соответствует freq.
copybool, по умолчанию False: Копировать ли ординалы перед сохранением.

Атрибуты

None

Методы

None

Смотрите также

Period: Представляет период времени.
PeriodIndex: Неизменяемый индекс для периодических данных.
period_range: Создать PeriodArray с фиксированной частотой.
array: Создать pandas массив.

Примечания

У PeriodArray есть два компонента

ordinals : целочисленный ndarray
freq : pd.tseries.offsets.Offset

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

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

Примеры

>>> pd.arrays.PeriodArray(pd.PeriodIndex(['2023-01-01',
...                                       '2023-01-02'], freq='D'))

['2023-01-01', '2023-01-02']
Length: 2, dtype: period[D]