Метод ceil

Метод ceil применяется к DatetimeIndex и возвращает новый индекс, в котором все даты округлены вверх до указанной временной частоты. Округление происходит до ближайшей большей границы заданного периода, например, до начала следующей минуты, часа или дня.

Метод принимает обязательный параметр freq, который задаёт частоту округления. Можно указать необязательный параметр ambiguous для обработки неоднозначных времён и nonexistent для обработки несуществующих времён, возникающих при переходе на летнее время.

Синтаксис

datetime_index.ceil(freq, ambiguous='raise', nonexistent='raise')

Пример

Создадим дата-индекс с точностью до микросекунд и округлим его до секунд:

import pandas as pd

dt_index = pd.DatetimeIndex([
	'2026-09-09 12:34:56.123456',
	'2026-09-09 12:34:56.789012',
	'2026-09-09 12:34:57.000001'
])
res = dt_index.ceil('s')
print(res)

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

DatetimeIndex(
	['2026-09-09 12:34:57', 
	 '2026-09-09 12:34:57', 
	 '2026-09-09 12:34:58'], 
	dtype='datetime64[ns]', freq=None
)

Пример

Округлим даты до ближайшего часа:

import pandas as pd

dt_index = pd.DatetimeIndex([
	'2026-09-09 12:34:56',
	'2026-09-09 12:55:10',
	'2026-09-09 13:00:01'
])
res = dt_index.ceil('h')
print(res)

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

DatetimeIndex(
	['2026-09-09 13:00:00', 
	 '2026-09-09 13:00:00', 
	 '2026-09-09 14:00:00'], 
	dtype='datetime64[ns]', freq=None
)

Пример

Округлим даты до ближайшего дня:

import pandas as pd

dt_index = pd.DatetimeIndex([
	'2026-09-09 00:00:00',
	'2026-09-09 12:00:00',
	'2026-09-09 23:59:59'
])
res = dt_index.ceil('D')
print(res)

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

DatetimeIndex(
	['2026-09-09', '2026-09-10', '2026-09-10'], 
	dtype='datetime64[ns]', freq=None
)

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

класс DatetimeIndex,
который представляет индекс из временных меток
метод floor,
который округляет даты вниз
метод round,
который округляет даты к ближайшей границе
метод normalize,
который приводит даты к полуночи