Python Pandas入門：DateTimeIndexの日付が年の初日かどうかを判定するis_year_startプロパティの使い方

DateTimeIndexに含まれる日付が、その年の最初の日（1月1日）であるかどうかを判定するには、PandasのDateTimeIndex.is_year_startプロパティを使用します。このプロパティは、各日付に対して年の初日であればTrue、そうでなければFalseを返すブール値の配列を生成します。

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

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

import pandas as pd

DatetimeIndexの作成

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

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

DateTimeIndexの表示

作成したDateTimeIndexを表示して確認します。

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

年の初日かどうかの判定

is_year_startプロパティを使って、DateTimeIndex内の各日付が年の最初の日かどうかをチェックします。

print("\nDateTimeIndexの日付が年の初日かどうかを確認...\n", datetimeindex.is_year_start)

サンプルコード全体

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

import pandas as pd

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

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

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

# 各日付が年の初日かどうかを判定
print("\nDateTimeIndexの日付が年の初日かどうかを確認...\n", datetimeindex.is_year_start)

実行結果

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

DateTimeIndex...
DatetimeIndex(['2021-12-30 02:30:50+10:30', '2021-12-31 02:30:50+10:30',
'2022-01-01 02:30:50+10:30', '2022-01-02 02:30:50+10:30',
'2022-01-03 02:30:50+10:30', '2022-01-04 02:30:50+10:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq='D')
DateTimeIndex frequency...
<Day>

DateTimeIndexの日付が年の初日かどうかを確認...
[False False True False False False]

結果の解説

出力結果を見ると、2021年12月30日から始まる6日間の日付の中で、「2022-01-01」だけがTrueになっていることがわかります。つまり、is_year_startは年が切り替わる1月1日のみを正しく検出しています。このように、時系列データの分析において特定の日付が年の境界に該当するかどうかを簡単に判定できるため、年度ごとの集計やフィルタリング処理などに活用できます。