pandas.Series.dt.round

Series.dt.round(self, *args, **kwargs) [source]

Выполнить операцию округления данных до указанного freq.

Параметры:	freq : str or Offset Уровень частоты для округления индекса. Должен быть фиксированной частотой, например, ‘S’ (секунда), а не ‘ME’ (конец месяца). См. псевдонимы частот для списка возможных freq значений. ambiguous : ‘infer’, bool-ndarray, ‘NaT’, default ‘raise’ Актуально только для DatetimeIndex: ‘infer’ попытается определить часы перехода DST на основе порядка булев массив, где True означает время DST, False — время вне DST (обратите внимание, что этот флаг применим только к неоднозначным временам) ‘NaT’ вернёт NaT, если есть неоднозначные времена ‘raise’ поднимет исключение AmbiguousTimeError, если есть неоднозначные времена Новое в версии 0.24.0. nonexistent : ‘shift_forward’, ‘shift_backward’, ‘NaT’, timedelta, default ‘raise’ Временной момент не существует в определенном часовом поясе, где часы перевели вперёд из-за DST. ‘shift_forward’ сдвинет несуществующее время вперёд до ближайшего существующего ‘shift_backward’ сдвинет несуществующее время назад до ближайшего существующего ‘NaT’ вернёт NaT, если существуют несуществующие времена объекты timedelta сдвинут несуществующие времена на указанное значение timedelta ‘raise’ поднимет исключение NonExistentTimeError, если существуют несуществующие времена Новое в версии 0.24.0.
Возвращает:	DatetimeIndex, TimedeltaIndex или Series Индекс того же типа для DatetimeIndex или TimedeltaIndex, или Series с тем же индексом для Series.
Возбуждает:	ValueError if the freq cannot be converted.

Примеры

DatetimeIndex

>>> rng = pd.date_range('1/1/2018 11:59:00', periods=3, freq='min')
>>> rng
DatetimeIndex(['2018-01-01 11:59:00', '2018-01-01 12:00:00',
               '2018-01-01 12:01:00'],
              dtype='datetime64[ns]', freq='T')
>>> rng.round('H')
DatetimeIndex(['2018-01-01 12:00:00', '2018-01-01 12:00:00',
               '2018-01-01 12:00:00'],
              dtype='datetime64[ns]', freq=None)

Series

>>> pd.Series(rng).dt.round("H")
0   2018-01-01 12:00:00
1   2018-01-01 12:00:00
2   2018-01-01 12:00:00
dtype: datetime64[ns]