【Pandas入門】DateTimeIndexから頻度（freq）を抽出する方法

Pandasで日時インデックス（DateTimeIndex）から頻度を抽出するには、DateTimeIndex.freq プロパティを使用します。この記事では、実際のコード例を通じて、その使い方をわかりやすく解説します。

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

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

import pandas as pd

DateTimeIndexの作成

次に、期間6・頻度「D」（日単位）でDatetimeIndexを作成します。タイムゾーンはオーストラリアのアデレード（Australia/Adelaide）を指定します。

datetimeindex = pd.date_range('2021-10-20 02:30:50', periods=6, tz='Australia/Adelaide', freq='D')

pd.date_range() の主な引数は以下の通りです。

• start：開始日時
• periods：生成する日時の個数
• tz：タイムゾーンの指定
• freq：頻度（'D' は日ごと、'H' は時間ごとなどを指定可能）

DateTimeIndexと頻度の表示

作成したDateTimeIndexを表示します。

print("DateTimeIndex...\n", datetimeindex)

続いて、freq プロパティを使って頻度を表示します。

print("DateTimeIndex frequency...\n", datetimeindex.freq)

サンプルコード全体

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

import pandas as pd

# 期間6・頻度D（日単位）のDatetimeIndexを作成
# タイムゾーンはAustralia/Adelaideを指定
datetimeindex = pd.date_range('2021-10-20 02:30:50', periods=6, tz='Australia/Adelaide', freq='D')

# DateTimeIndexを表示
print("DateTimeIndex...\n", datetimeindex)

# DateTimeIndexの頻度を表示
print("DateTimeIndex frequency...\n", datetimeindex.freq)

実行結果

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

DateTimeIndex...
DatetimeIndex(['2021-10-20 02:30:50+10:30', '2021-10-21 02:30:50+10:30',
'2021-10-22 02:30:50+10:30', '2021-10-23 02:30:50+10:30',
'2021-10-24 02:30:50+10:30', '2021-10-25 02:30:50+10:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq='D')
DateTimeIndex frequency...
<Day>

まとめ

出力結果からわかるように、datetimeindex.freq を参照することで <Day> という頻度オブジェクトが取得できました。これは、DateTimeIndexが「日単位」の間隔で生成されていることを示しています。なお、freq_str プロパティを使えば、文字列形式（この場合は 'D'）で頻度を取得することも可能です。時系列データの分析では、インデックスの頻度を確認することはリサンプリングやシフト操作などの前処理において重要なポイントとなります。