Класс Period

Класс Period используется для представления фиксированного временного интервала. Он принимает строковое представление даты и частоту, определяющую длину интервала. Объект Period можно создавать вручную или извлекать из DatetimeIndex. Класс предоставляет доступ к атрибутам, содержащим информацию о дате, а также методы для преобразования частоты и форматирования.

Синтаксис

pd.Period(value, freq=None)

Параметры

Параметр value задаёт временную метку в виде строки или объекта datetime. Параметр freq определяет частоту интервала, например 'D' для дня, 'M' для месяца или 'Y' для года.

Пример

Создадим объект Period, представляющий январь 2026 года:

import pandas as pd

per = pd.Period('2026-01', freq='M')
print(per)

Результат выполнения кода:

2026-01

Пример

Получим атрибуты периода, такие как год, месяц и квартал:

import pandas as pd

per = pd.Period('2026-01', freq='M')
print(per.year)
print(per.month)
print(per.quarter)

Результат выполнения кода:

2026
1
1

Пример

Создадим период с частотой в день и получим время начала и конца интервала:

import pandas as pd

per = pd.Period('2026-01-01', freq='D')
print(per.start_time)
print(per.end_time)

Результат выполнения кода:

2026-01-01 00:00:00
2026-01-01 23:59:59.999999999

Пример

Изменим частоту периода с месяца на день с помощью метода asfreq:

import pandas as pd

per = pd.Period('2026-01', freq='M')
print(per.asfreq('D', how='start'))
print(per.asfreq('D', how='end'))

Результат выполнения кода:

2026-01-01
2026-01-31

Пример

Преобразуем период в timestamp с помощью метода to_timestamp:

import pandas as pd

per = pd.Period('2026-01', freq='M')
print(per.to_timestamp(how='start'))
print(per.to_timestamp(how='end'))

Результат выполнения кода:

2026-01-01 00:00:00
2026-01-31 23:59:59.999999999

Пример

Отформатируем период с помощью метода strftime:

import pandas as pd

per = pd.Period('2026-01-01', freq='D')
print(per.strftime('%Y-%m-%d'))
print(per.strftime('%B %d, %Y'))

Результат выполнения кода:

2026-01-01
January 01, 2026

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

атрибут year,
который возвращает год периода
атрибут month,
который возвращает месяц периода
метод asfreq,
который изменяет частоту периода
метод to_timestamp,
который преобразует период в timestamp