Python Pandas – PeriodIndex의 주기(Frequency) 객체를 문자열로 반환하는 방법

PeriodIndex.freqstr 속성 소개

Python의 Pandas 라이브러리에서 PeriodIndex 객체가 가진 주기(frequency) 정보를 문자열 형태로 반환하려면 PeriodIndex.freqstr 속성을 사용하면 됩니다. 이 속성은 빈도 객체 자체가 아닌, 사람이 읽기 쉬운 문자열 형태로 빈도를 출력해 줍니다.

먼저 필요한 라이브러리를 임포트합니다.

import pandas as pd

이제 PeriodIndex 객체를 생성해 보겠습니다. PeriodIndex는 시간상의 규칙적인 기간을 나타내는 서수(ordinal) 값을 담고 있는 불변(immutable) ndarray입니다. 여기서는 freq 매개변수를 사용하여 빈도를 "T"(분 단위)로 설정했습니다.

periodIndex = pd.PeriodIndex(['2021-09-25 07:50:35', '2019-10-30 04:35:45',
'2021-07-15 02:25:15', '2022-06-25 07:20:55'], freq="T")

생성된 PeriodIndex 객체를 화면에 출력합니다.

print("PeriodIndex...\n", periodIndex)

마지막으로, PeriodIndex의 빈도를 문자열 형태로 출력합니다.

print("\nPeriodIndex frequency object as a string...\n", periodIndex.freqstr)

전체 예제 코드

다음은 지금까지 설명한 내용을 모두 포함한 전체 코드입니다.

import pandas as pd

# PeriodIndex 객체 생성
# PeriodIndex는 시간상의 규칙적인 기간을 나타내는 서수 값을 담는 불변 ndarray입니다.
# "freq" 매개변수를 사용하여 빈도를 설정했습니다.
periodIndex = pd.PeriodIndex(['2021-09-25 07:50:35', '2019-10-30 04:35:45',
'2021-07-15 02:25:15', '2022-06-25 07:20:55'], freq="T")

# PeriodIndex 객체 출력
print("PeriodIndex...\n", periodIndex)

# PeriodIndex의 빈도 객체 출력
print("\nPeriodIndex frequency object...\n", periodIndex.freq)

# PeriodIndex의 빈도를 문자열로 출력
print("\nPeriodIndex frequency object as a string...\n", periodIndex.freqstr)

실행 결과

위 코드를 실행하면 다음과 같은 결과가 출력됩니다.

PeriodIndex...
PeriodIndex(['2021-09-25 07:50', '2019-10-30 04:35', '2021-07-15 02:25', '2022-06-25 07:20'],
dtype='period[T]')

PeriodIndex frequency object...
<Minute>

PeriodIndex frequency object as a string...
T

정리

freq 속성은 <Minute>와 같은 빈도 객체 자체를 반환하는 반면, freqstr 속성은 동일한 빈도를 "T"처럼 간결한 문자열로 반환한다는 점이 핵심 차이입니다. 두 속성을 적절히 활용하면 시계열 데이터의 빈도 정보를 상황에 맞게 확인할 수 있습니다.