【Python・Pandas】DateTimeIndexを秒の頻度で丸める方法

DateTimeIndexを秒の頻度で丸める方法

PandasのDateTimeIndexを秒（seconds）の頻度で丸めるには、DateTimeIndex.round()メソッドを使用します。秒単位で丸めたい場合は、freqパラメータに'S'を指定します。round()メソッドは、ナノ秒などの細かい端数を指定した頻度のもっとも近い値へ四捨五入する際に便利です。

まず、必要なライブラリをインポートします。

import pandas as pd

次に、期間5つ分・頻度が「28s」（28秒間隔）のDatetimeIndexを作成します。タイムゾーンはオーストラリア／アデレード（Australia/Adelaide）を設定しています。

datetimeindex = pd.date_range('2021-09-29 07:20:32.261811624', periods=5,
tz='Australia/Adelaide', freq='28s')

作成したDateTimeIndexに対して、秒の頻度（'S'）で丸め処理を実行します。

print("\nPerforming round operation with seconds frequency...\n",
datetimeindex.round(freq='S'))

サンプルコード全体

以下が完全なコード例です。

import pandas as pd

# 期間5つ分・頻度28秒（'s'）のDatetimeIndexを作成
# タイムゾーンは Australia/Adelaide を指定
datetimeindex = pd.date_range('2021-09-29 07:20:32.261811624', periods=5,
tz='Australia/Adelaide', freq='28s')

# DateTimeIndexを表示
print("DateTimeIndex...\n", datetimeindex)

# DateTimeIndexの頻度を表示
print("DateTimeIndex frequency...\n", datetimeindex.freq)

# 秒（second）の値を取得
res = datetimeindex.second

# 秒のみを表示
print("\nThe second from DateTimeIndex...\n", res)

# 秒の頻度で丸め処理を実行
# 秒の頻度には 'S' を指定
print("\nPerforming round operation with seconds frequency...\n",
datetimeindex.round(freq='S'))

実行結果

上記のコードを実行すると、次のような出力が得られます。

DateTimeIndex...
DatetimeIndex(['2021-09-29 07:20:32.261811624+09:30',
'2021-09-29 07:21:00.261811624+09:30',
'2021-09-29 07:21:28.261811624+09:30',
'2021-09-29 07:21:56.261811624+09:30',
'2021-09-29 07:22:24.261811624+09:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq='28S')
DateTimeIndex frequency...
<28 * Seconds>

The second from DateTimeIndex...
Int64Index([32, 0, 28, 56, 24], dtype='int64')

Performing round operation with seconds frequency...
DatetimeIndex(['2021-09-29 07:20:32+09:30', '2021-09-29 07:21:00+09:30',
'2021-09-29 07:21:28+09:30', '2021-09-29 07:21:56+09:30',
'2021-09-29 07:22:24+09:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq=None)

出力を見ると、元のDateTimeIndexには「.261811624」というナノ秒単位の端数が含まれていましたが、round(freq='S')を実行することで、各タイムスタンプがもっとも近い秒に丸められていることが確認できます。このように、freqパラメータに'S'を指定するだけで、簡単に秒単位の丸め処理が行えます。