Python Pandas入門：Periodオブジェクトの終了時刻を取得する方法

Python PandasでPeriodオブジェクトの終了時刻を取得する

指定されたPeriodオブジェクトの終了時刻を取得するには、period.end_timeプロパティを使用します。このプロパティは、その期間が終了する瞬間の日時を返します。

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

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

import pandas as pd

Periodオブジェクトの作成

pandas.Periodは一定の時間区間（期間）を表すオブジェクトです。ここでは、2つのPeriodオブジェクトを作成します。

period1 = pd.Period("2020-09-23 03:55:20")
period2 = pd.Period(freq="T", year = 2021, month = 2, day = 14, hour = 2, minute = 35)

1つ目は日時文字列から直接Periodを作成しており、2つ目は頻度（freq="T"：分単位）と年・月・日・時・分を個別に指定して作成しています。

Periodオブジェクトの表示

作成したPeriodオブジェクトを表示して確認します。

print("Period1...\n", period1)
print("Period2...\n", period2)

終了時刻の取得

end_timeプロパティを使って、2つのPeriodオブジェクトそれぞれの終了時刻を取得します。

res1 = period1.end_time
res2 = period2.end_time

サンプルコード全体

以下に完全なコードを示します。

import pandas as pd

# pandas.Periodは時間区間（期間）を表す
# 2つのPeriodオブジェクトを作成
period1 = pd.Period("2020-09-23 03:55:20")
period2 = pd.Period(freq="T", year = 2021, month = 2, day = 14, hour = 2, minute = 35)

# Periodオブジェクトを表示
print("Period1...\n", period1)
print("Period2...\n", period2)

# 2つのPeriodオブジェクトから終了時刻を取得
res1 = period1.end_time
res2 = period2.end_time

# 結果を表示
print("\n1つ目のPeriodオブジェクトの終了時刻 ...\n", res1)
print("\n2つ目のPeriodオブジェクトの終了時刻 ...\n", res2)

実行結果

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

Period1...
2020-09-23 03:55:20

Period2...
2021-02-14 02:35

1つ目のPeriodオブジェクトの終了時刻 ...
2020-09-23 03:55:20.999999999

2つ目のPeriodオブジェクトの終了時刻 ...
2021-02-14 02:35:59.999999999

解説

出力結果を見ると、end_timeプロパティが返す終了時刻には「999999999」というナノ秒が含まれています。これは、Periodオブジェクトが示す期間の「最後の瞬間」を表すためです。

• 1つ目のPeriod（デフォルトの頻度）の場合：2020-09-23 03:55:20.999999999
• 2つ目のPeriod（分単位＝freq="T"）の場合：その分の最後の瞬間である2021-02-14 02:35:59.999999999

つまり、頻度が分単位に設定されたPeriodオブジェクトでは、開始時刻が02:35であっても、その1分間の区間の末尾である02:35:59.999999999が終了時刻として返される点に注意してください。期間の始まりの時刻が必要な場合は、start_timeプロパティを使用すると取得できます。