Python Pandas入門：DateTimeIndexをミリ秒（ms）単位で丸める方法

PandasでDateTimeIndexの日時をミリ秒単位で丸めたい場合は、DateTimeIndex.round()メソッドを使用します。ミリ秒の頻度を指定するには、freqパラメータに「ms」を設定します。

DateTimeIndex.round()メソッドとは

round()メソッドは、DateTimeIndex内の各日時データを指定した頻度（freq）に最も近い値へ四捨五入する機能を持っています。ナノ秒やマイクロ秒など、細かい精度のタイムスタンプを扱う際に、特定の桁で揃えたい場合に非常に便利です。

実装手順

1. 必要なライブラリをインポートする

まずはPandasをインポートします。

import pandas as pd

2. DatetimeIndexを作成する

次に、期間5・頻度28秒（秒単位）のDatetimeIndexを作成します。タイムゾーンはオーストラリアのアデレード（Australia/Adelaide）を指定しています。

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

3. ミリ秒頻度で丸め処理を実行する

round()メソッドにfreq='ms'を渡して、ミリ秒単位での丸め処理を行います。

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

完全なサンプルコード

以下が全体のコード例です。

import pandas as pd

# 期間5・頻度28秒（秒単位）の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)

# ミリ秒頻度（'ms'）で丸め処理を実行
print("\nPerforming round operation with milliseconds frequency...\n",
datetimeindex.round(freq='ms'))

実行結果

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

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>

Performing round operation with milliseconds frequency...
DatetimeIndex(['2021-09-29 07:20:32.262000+09:30',
'2021-09-29 07:21:00.262000+09:30',
'2021-09-29 07:21:28.262000+09:30',
'2021-09-29 07:21:56.262000+09:30',
'2021-09-29 07:22:24.262000+09:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq=None)

出力結果のポイント

元のタイムスタンプはナノ秒レベルの精度（例：.261811624）を持っていますが、round(freq='ms')を実行することで、ミリ秒単位（例：.262000）に丸められていることがわかります。なお、丸め処理後のDateTimeIndexではfreq=Noneとなり、元の頻度情報は保持されない点に注意してください。