Python Pandas入門：Periodオブジェクトの開始時刻（start_time）を取得する方法

Pandasのperiod.start_timeプロパティを使うと、指定したPeriodオブジェクトの開始時刻を簡単に取得できます。この記事では、実際のコード例を通じてその使い方を解説します。

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

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

import pandas as pd

Periodオブジェクトとは

pandas.Periodは、特定の期間（日、月、年など）を表すオブジェクトです。タイムスタンプが「ある一点の時刻」を指すのに対し、Periodは「時間の区間」を扱うのに適しています。

ここでは、2つのPeriodオブジェクトを作成してみましょう。1つ目は文字列から、2つ目は頻度（freq）と各日時要素を個別に指定して作成します。

period1 = pd.Period("2020-09-22")
period2 = pd.Period(freq="D", year=2021, month=2, day=14, hour=2, minute=35)

Periodオブジェクトの表示

作成したPeriodオブジェクトの中身を確認します。

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

開始時刻の取得

start_timeプロパティにアクセスすることで、それぞれのPeriodオブジェクトの開始時刻を取得できます。

res1 = period1.start_time
res2 = period2.start_time

完全なコード例

以下に、ここまでの処理をまとめたサンプルコードを示します。

import pandas as pd

# pandas.Periodは期間を表すオブジェクト
# 2つのPeriodオブジェクトを作成
period1 = pd.Period("2020-09-22")
period2 = pd.Period(freq="D", year=2021, month=2, day=14, hour=2, minute=35)

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

# 各Periodオブジェクトから開始時刻を取得
res1 = period1.start_time
res2 = period2.start_time

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

実行結果

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

Period1...
2020-09-22
Period2...
2021-02-14

1つ目のPeriodオブジェクトの開始時刻 ...
2020-09-22 00:00:00

2つ目のPeriodオブジェクトの開始時刻 ...
2021-02-14 00:00:00

補足ポイント

• start_timeは、Periodの開始時点をTimestamp型で返します。日単位のPeriodの場合、その日の0時0分0秒が返されます。
• 対になるend_timeプロパティを使えば、期間の終了時刻も取得できます。
• freq="D"（日単位）の場合、hourやminuteを指定しても表示されるPeriod自体は日単位になりますが、start_timeはその日の開始時刻を正確に返します。