Python Pandas入門：Periodオブジェクトを年頻度のタイムスタンプに変換する方法

PandasのPeriodオブジェクトを年頻度のタイムスタンプとして取得するには、period.to_timestamp()メソッドを使用し、freqパラメータに'Y'（年次）を指定します。

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

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

import pandas as pd

Periodオブジェクトの作成

pandas.Periodは、一定期間の時刻を表すオブジェクトです。以下のようにPeriodオブジェクトを作成できます。

period = pd.Period(freq="S", year = 2021, month = 9, day = 18, hour = 17, minute = 20, second = 45)

この例では、2021年9月18日17時20分45秒を秒単位（freq="S"）の期間として定義しています。

Periodオブジェクトの表示

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

print("Period...\n", period)

年頻度のタイムスタンプへの変換

PeriodオブジェクトのTimestamp表現を返します。to_timestamp()メソッドの「freq」パラメータで頻度を指定でき、ここでは'Y'（年次・年末基準）を設定しています。

print("\nPeriod to Timestamp with yearly (year-end) frequency...\n", period.to_timestamp(freq='Y'))

サンプルコード全体

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

import pandas as pd

# pandas.Periodは一定期間の時刻を表します
# Periodオブジェクトを作成
period = pd.Period(freq="S", year = 2021, month = 9, day = 18, hour = 17, minute = 20, second = 45)

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

# PeriodオブジェクトのTimestamp表現を返す
# 「freq」パラメータで頻度を設定
# 頻度は 'Y'、つまり年次（年末）に設定
print("\nPeriod to Timestamp with yearly (year-end) frequency...\n", period.to_timestamp(freq='Y'))

実行結果

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

Period...
2021-09-18 17:20:45

Period to Timestamp with yearly (year-end) frequency...
2021-12-31 00:00:00

ご覧のとおり、元のPeriodオブジェクト（2021-09-18 17:20:45）が、freq='Y'を指定することで、その年の年末である「2021-12-31 00:00:00」というタイムスタンプに変換されました。これは、年頻度の場合、期間の終了時点（年末）がタイムスタンプとして返されるためです。