Атрибут freq

Атрибут freq применяется к объекту DatetimeIndex и возвращает частоту временного ряда (например, 'D' для дней, 'H' для часов, 'T' для минут). Если частота не была задана явно при создании индекса или не может быть определена, атрибут вернет None.

Синтаксис

datetime_index.freq

Пример

Давайте создадим DatetimeIndex с явно заданной частотой и получим значение атрибута freq:

import pandas as pd

dt_index = pd.date_range(
	start='2026-01-01',
	periods=5,
	freq='D'
)
print(dt_index.freq)

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

<Day>

Пример

Теперь создадим индекс без указания частоты и проверим значение атрибута freq:

import pandas as pd

dt_index = pd.DatetimeIndex([
	'2026-01-01',
	'2026-01-02',
	'2026-01-03'
])
print(dt_index.freq)

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

None

Пример

Атрибут freq также доступен у индекса, созданного при чтении данных с временным столбцом, если указать параметр parse_dates и index_col. Рассмотрим это на примере:

date,value
2026-01-01,10
2026-01-02,20
2026-01-03,30
2026-01-04,40
2026-01-05,50

import pandas as pd

df = pd.read_csv(
	'data.csv',
	parse_dates=['date'],
	index_col='date'
)
print(df.index.freq)

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

None

В этом случае частота не определилась автоматически, поэтому атрибут вернул None. Для задания частоты можно использовать метод asfreq.

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

атрибут inferred_freq,
который пытается определить частоту автоматически
метод to_period,
который преобразует индекс в период с заданной частотой
метод floor,
который округляет даты вниз до указанной частоты
метод ceil,
который округляет даты вверх до указанной частоты