Python pandas.Series.dt.round用法及代碼示例

用法:
Series.dt.round(*args, **kwargs)

對指定的 freq 的數據進行四舍五入運算。

參數：

freq：str 或偏移量

要將索引舍入到的頻率級別。必須是固定頻率，例如“S”(秒)而不是“ME”(月末)。有關可能的 freq 值的列表，請參閱頻率別名。

ambiguous：‘infer’, bool-ndarray, ‘NaT’, 默認 ‘raise’

僅與 DatetimeIndex 相關：

‘infer’ 將嘗試根據訂單推斷秋季 dst-transition 小時
bool-ndarray 其中 True 表示 DST 時間，False 表示非 DST 時間(請注意，此標誌僅適用於模棱兩可的時間)
'NaT' 將在時間不明確的地方返回 NaT
如果時間不明確，‘raise’ 將引發 AmbiguousTimeError。

nonexistent：‘shift_forward’, ‘shift_backward’, ‘NaT’, timedelta, 默認 ‘raise’

由於 DST，時鍾向前移動的特定時區不存在不存在的時間。

‘shift_forward’ 將不存在的時間向前移動到最接近的存在時間
‘shift_backward’ 將不存在的時間向後移動到最接近的存在時間
‘NaT’ 將返回不存在時間的 NaT
timedelta 對象會將不存在的時間移動 timedelta
如果時間不存在，‘raise’ 將引發 NonExistentTimeError。

DatetimeIndex、TimedeltaIndex 或 Series: DatetimeIndex 或 TimedeltaIndex 具有相同類型的索引，或者 Series 具有相同索引的 Series。

拋出：

如果無法轉換 freq，則出現 ValueError。

注意：

如果時間戳具有時區，則將相對於本地 (“wall”) 時間進行舍入，並重新本地化到同一時區。在夏令時附近四舍五入時，使用nonexistent 和ambiguous 來控製重新定位行為。

例子：

日期時間索引

>>> 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]

在夏令時轉換附近四舍五入時，使用ambiguous 或nonexistent 來控製如何重新定位時間戳。

>>> rng_tz = pd.DatetimeIndex(["2021-10-31 03:30:00"], tz="Europe/Amsterdam")

>>> rng_tz.floor("2H", ambiguous=False)
DatetimeIndex(['2021-10-31 02:00:00+01:00'],
              dtype='datetime64[ns, Europe/Amsterdam]', freq=None)

>>> rng_tz.floor("2H", ambiguous=True)
DatetimeIndex(['2021-10-31 02:00:00+02:00'],
              dtype='datetime64[ns, Europe/Amsterdam]', freq=None)

相關用法

注：本文由純淨天空篩選整理自pandas.pydata.org大神的英文原創作品 pandas.Series.dt.round。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

拋出：

注意：

例子：