Python Pandas入門：PeriodIndexオブジェクトの各要素の期間終了時刻を取得・表示する方法

指定した PeriodIndex オブジェクトに含まれる各要素（期間）の終了時刻を表示したい場合は、PeriodIndex.end_time プロパティを使用します。このプロパティは、各期間が終わる瞬間のタイムスタンプを DatetimeIndex として返してくれます。

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

まず、pandas をインポートします。

import pandas as pd

PeriodIndexオブジェクトの作成

次に、PeriodIndex オブジェクトを作成します。PeriodIndex は、時間軸上の一定の期間を表す序数値を保持するイミュータブル（変更不可）な ndarray です。ここでは「freq」パラメータを使って頻度を「D」（日単位）に設定しています。

periodIndex = pd.PeriodIndex(['2018-07-25', '2019-10-30', '2020-11-20',
'2021-09-15', '2022-03-12', '2023-06-18'], freq="D")

作成した PeriodIndex オブジェクトを表示してみましょう。

print("PeriodIndex...\n", periodIndex)

続いて、end_time プロパティを使って各期間の終了時刻を表示します。

print("\nEnd Time...\n", periodIndex.end_time)

サンプルコード（完全版）

以下に、ここまでの手順をまとめた完全なコードを示します。

import pandas as pd

# PeriodIndexオブジェクトを作成
# PeriodIndexは、時間における一定の期間を示す序数値を保持する
# イミュータブルなndarrayです。
# 「freq」パラメータで頻度を設定しています。
periodIndex = pd.PeriodIndex(['2018-07-25', '2019-10-30', '2020-11-20',
'2021-09-15', '2022-03-12', '2023-06-18'], freq="D")

# PeriodIndexオブジェクトを表示
print("PeriodIndex...\n", periodIndex)

# PeriodIndexの頻度を表示
print("\nPeriodIndex frequency...\n", periodIndex.freq)

# 各期間の終了時刻を表示
print("\nEnd Time...\n", periodIndex.end_time)

実行結果

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

PeriodIndex...
PeriodIndex(['2018-07-25', '2019-10-30', '2020-11-20', '2021-09-15', '2022-03-12', '2023-06-18'],
dtype='period[D]')

PeriodIndex frequency...
<Day>

End Time...
DatetimeIndex(['2018-07-25 23:59:59.999999999',
               '2019-10-30 23:59:59.999999999',
               '2020-11-20 23:59:59.999999999',
               '2021-09-15 23:59:59.999999999',
               '2022-03-12 23:59:59.999999999',
               '2023-06-18 23:59:59.999999999'],
               dtype='datetime64[ns]', freq=None)

解説

出力結果から分かるように、頻度が「D」（日）に設定されているため、各期間の終了時刻はその日の最後の瞬間である「23:59:59.999999999」となっています。つまり、end_time プロパティは、期間の開始日付に対してナノ秒単位で可能な限り遅い時刻を返す仕組みになっています。

このように PeriodIndex.end_time を使えば、時系列データの分析において「各期間がいつ終わるのか」を簡単に把握でき、start_time プロパティと組み合わせることで、期間の範囲を明確に定義したデータ処理が可能になります。