Python Pandas：タイムスタンプを境界として時間間隔（Interval）を作成する方法

タイムスタンプ（Timestamp）を境界として時間間隔を作成するには、pandas.Interval を使用し、区間の端点に pandas.Timestamp を指定します。これにより、日付や時刻を扱う半開区間・閉区間を簡単に定義できます。

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

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

import pandas as pd

タイムスタンプを境界とした時間間隔の作成

pandas.Timestamp を左右の境界として pd.Interval を作成します。ここでは「closed」パラメータに「left」を指定し、左端を含み右端を含まない半開区間（左閉区間）を設定しています。

interval = pd.Interval(pd.Timestamp('2020-01-01 00:00:00'), pd.Timestamp('2021-01-01 00:00:00'), closed='left')

この設定では、左端の 2020-01-01 は区間に含まれ、右端の 2021-01-01 は含まれません。「closed」パラメータには「right」（右閉）、「both」（両端を含む）、「neither」（両端を含まない）も指定可能です。

作成した区間を表示してみましょう。

print("Interval...\n", interval)

サンプルコード

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

import pandas as pd

# タイムスタンプを境界として時間間隔を作成
# 「closed」パラメータに「left」を指定して左閉区間に設定
interval = pd.Interval(pd.Timestamp('2020-01-01 00:00:00'), pd.Timestamp('2021-01-01 00:00:00'), closed='left')

# 区間を表示
print("Interval...\n", interval)

# 区間の長さを表示
print("\nInterval length...\n", interval.length)

実行結果

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

Interval...
[2020-01-01, 2021-01-01)

Interval length...
366 days 00:00:00

出力から、区間が [2020-01-01, 2021-01-01) として表現されていることがわかります。また、「length」プロパティを使うことで、区間の長さを 366 日（2020年はうるう年）という Timedelta 形式で取得できます。