Python Pandas – TimeDeltaIndexオブジェクトからDataFrameを作成し、列名を上書きする方法

TimeDeltaIndexオブジェクトからDataFrameを作成するには、to_frame()メソッドを使用します。生成される列の名前を上書きしたい場合は、nameパラメータに任意の列名を指定するだけでOKです。

この記事では、実際のコード例とともに、TimeDeltaIndexからDataFrameへの変換方法と列名の変更手順をわかりやすく解説します。

1. 必要なライブラリのインポート

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

import pandas as pd

2. TimeDeltaIndexオブジェクトの作成

次に、TimeDeltaIndexオブジェクトを作成します。「data」パラメータを使って、timedelta形式のデータを設定しています。

tdIndex = pd.TimedeltaIndex(data =['4 day 8h 20min 35us 45ns', '+17:42:19.999999',
'9 day 3h 08:16:02.000055', '+22:35:25.000075'])

作成したTimedeltaIndexを表示して確認しましょう。

print("TimedeltaIndex...\n", tdIndex)

3. TimeDeltaIndexからDataFrameへ変換する

TimeDeltaIndexオブジェクトからDataFrameを作成します。

・index=False を指定すると、元のインデックスは返されるDataFrameに引き継がれません（新しい連番インデックスが割り当てられます）。
・name='DateTimeData' のように「name」パラメータを指定すると、生成される列の名前を自由に上書きできます。

print("\nTimeDeltaIndex to DataFrame...\n", tdIndex.to_frame(index=False, name = 'DateTimeData'))

完全なコード例

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

import pandas as pd

# TimeDeltaIndexオブジェクトを作成
# 「data」パラメータでtimedelta形式のデータを設定
tdIndex = pd.TimedeltaIndex(data =['4 day 8h 20min 35us 45ns', '+17:42:19.999999',
'9 day 3h 08:16:02.000055', '+22:35:25.000075'])

# TimedeltaIndexを表示
print("TimedeltaIndex...\n", tdIndex)

# TimeDeltaの各構成要素（日・時・分・秒など）をDataFrameとして返す
print("\nThe Dataframe of the components of TimeDeltas...\n", tdIndex.components)

# TimeDeltaIndexオブジェクトからDataFrameを作成
# index=False により元のインデックスは引き継がない
# name パラメータで生成される列名を上書き
print("\nTimeDeltaIndex to DataFrame...\n", tdIndex.to_frame(index=False, name = 'DateTimeData'))

出力結果

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

TimedeltaIndex...
TimedeltaIndex(['4 days 08:20:00.000035045', '0 days 17:42:19.999999',
'9 days 11:16:02.000055', '0 days 22:35:25.000075'],
dtype='timedelta64[ns]', freq=None)

The Dataframe of the components of TimeDeltas...
   days hours minutes seconds milliseconds microseconds nanoseconds
0     4     8      20       0            0           35          45
1     0    17      42      19          999          999           0
2     9    11      16       2            0           55           0
3     0    22      35      25            0           75           0

TimeDeltaIndex to DataFrame...
               DateTimeData
0  4 days 08:20:00.000035045
1     0 days 17:42:19.999999
2     9 days 11:16:02.000055
3     0 days 22:35:25.000075

まとめ

TimeDeltaIndexオブジェクトをDataFrameに変換する際は、to_frame()メソッドを使います。デフォルトでは元のインデックス名がそのまま列名になりますが、nameパラメータを指定することで、任意の列名に簡単に上書きできます。また、index=Falseを組み合わせれば、元のインデックスを引き継がないクリーンなDataFrameを取得できるので、時系列データや時間差データの前処理にとても便利です。