Period オブジェクトの日付情報から日を取得する

Pandas.Period.day 入出力解説

pandas.Period.day は、pandas ライブラリで Period 型の日付データの 日 情報を取得・設定するための属性です。

入力

pandas.Period.day に直接値を設定することはできません。代わりに、Period オブジェクトを生成時に指定するか、to_datetime() メソッドを使用して datetime 型に変換してから day 属性にアクセスする方法があります。

出力

pandas.Period.day は、Period オブジェクトの日付情報から 日 の値を 整数 型で返します。

コード例

# Period オブジェクト生成時に指定
period = pd.Period('2023-12-31')
print(period.day)  # 31

# to_datetime() メソッドを使用して取得
period = pd.Period('2023-12-31')
dt = period.to_datetime()
print(dt.day)  # 31

補足

• pandas.Period 型は、カレンダーの日付を表すデータ型です。
• day 属性は、Period オブジェクトの日付情報から 日 の値を取得します。
• to_datetime() メソッドは、Period オブジェクトを datetime 型に変換します。

Pandas.Period.day サンプルコード

# 年月日指定
period = pd.Period('2023-12-31')
print(period.day)  # 31

# 年月週指定
period = pd.Period('2023W52')
print(period.day)  # 29

# 年四半期指定
period = pd.Period('2023Q4')
print(period.day)  # 1

to_datetime() メソッドによる取得

# 年月日指定
period = pd.Period('2023-12-31')
dt = period.to_datetime()
print(dt.day)  # 31

# 年月週指定
period = pd.Period('2023W52')
dt = period.to_datetime()
print(dt.day)  # 29

# 年四半期指定
period = pd.Period('2023Q4')
dt = period.to_datetime()
print(dt.day)  # 1

比較

# 異なる周の同じ曜日の比較
period1 = pd.Period('2023W51', freq='W-MON')
period2 = pd.Period('2023W52', freq='W-MON')

print(period1.day)  # 25
print(period2.day)  # 1

print(period1 == period2)  # False

抽出

# 月末の抽出
df = pd.DataFrame({'Date': pd.to_datetime(['2023-12-01', '2023-12-15', '2023-12-31'])})
df['月末'] = df['Date'].dt.day.isin([31])

print(df)

#       Date    月末
# 0 2023-12-01  False
# 1 2023-12-15  False
# 2 2023-12-31   True

文字列変換

# 文字列への変換
period = pd.Period('2023-12-31')

print(period.strftime('%Y-%m-%d'))  # 2023-12-31
print(period.day)  # 31

時系列データへの適用

# 時系列データの月ごとの日数取得
df = pd.DataFrame({'Date': pd.to_datetime(['2023-01-01', '2023-02-01', '2023-03-01', '2023-04-01']), 'Value': [10, 20, 30, 40]})
df['日数'] = df['Date'].dt.days_in_month

print(df)

#       Date  Value  日数
# 0 2023-01-01   10   31
# 1 2023-02-01   20   28
# 2 2023-03-01   30   31
# 3 2023-04-01   40   30

これらのサンプルコードは、pandas.Period.day 属性のさまざまな使用方法を示しています。これらのコードを参考に、ご自身のデータ分析に役立ててください。

Pandas.Period.day の代替方法

dt.day 属性

Period オブジェクトを datetime 型に変換し、day 属性にアクセスする方法です。

period = pd.Period('2023-12-31')
dt = period.to_datetime()
print(dt.day)  # 31

strftime() メソッドを使用して、%d フォーマット指定で日付文字列から日を取得する方法です。

period = pd.Period('2023-12-31')
print(period.strftime('%d'))  # 31

dayofyear 属性は、1年の中でその日が何日目かを表す属性です。

period = pd.Period('2023-12-31')
print(period.dayofyear)  # 365

自作関数

特定の条件に基づいて日を取得する必要がある場合は、自作関数を作成する方法もあります。

def get_day(period):
    if period.freq == 'M':
        return period.dayofmonth
    elif period.freq == 'W':
        return period.dayofweek
    else:
        raise ValueError('Unsupported frequency')

period = pd.Period('2023-12-31')
print(get_day(period))  # 31

これらの方法は、それぞれ異なる利点と欠点があります。

• dt.day 属性は最もシンプルですが、datetime 型への変換が必要となります。
• strftime() メソッドはフォーマット指定が柔軟ですが、処理速度が遅くなる可能性があります。
• dayofyear 属性は特定の状況では有用ですが、一般的な使用には適していません。
• 自作関数は最も柔軟ですが、コード量が増加します。

ご自身のデータ分析のニーズに合った方法を選択してください。