Метод round
Метод round применяется к DatetimeIndex
и возвращает новый индекс с округлёнными значениями дат
и времени до указанной частоты. Первым параметром
передаётся строка с частотой округления, например,
'H' для округления до часов, 'D' для
округления до дней. Метод поддерживает параметры
freq и ambiguous, а также
nonexistent для обработки несуществующих
временных меток.
Синтаксис
datetime_index.round(freq, ambiguous='raise', nonexistent='raise')
Пример
Создадим индекс с датами и округлим его до ближайшего часа:
import pandas as pd
dt_index = pd.DatetimeIndex([
'2026-01-01 12:34:56',
'2026-01-02 08:15:30',
'2026-01-03 23:45:10'
])
res = dt_index.round('H')
print(res)
Результат выполнения кода:
DatetimeIndex(['2026-01-01 13:00:00', '2026-01-02 08:00:00',
'2026-01-03 23:00:00'],
dtype='datetime64[ns]', freq=None)
Пример
Округлим даты до ближайшего дня с использованием частоты 'D':
import pandas as pd
dt_index = pd.DatetimeIndex([
'2026-01-01 12:00:00',
'2026-01-02 23:59:59',
'2026-01-03 00:00:01'
])
res = dt_index.round('D')
print(res)
Результат выполнения кода:
DatetimeIndex(['2026-01-01', '2026-01-03', '2026-01-03'],
dtype='datetime64[ns]', freq=None)
Пример
Округлим даты до ближайшего месяца:
import pandas as pd
dt_index = pd.DatetimeIndex([
'2026-01-15 12:34:56',
'2026-02-14 08:15:30',
'2026-03-16 23:45:10'
])
res = dt_index.round('M')
print(res)
Результат выполнения кода:
DatetimeIndex(['2026-02-01', '2026-02-01', '2026-04-01'],
dtype='datetime64[ns]', freq=None)
