Pandas Timestamp.fromisocalendar で ISO 週番号から Timestamp オブジェクトを作成

pandas.Timestamp.fromisocalendar は、ISO 8601 週番号と曜日番号を使用して Timestamp オブジェクトを作成する関数です。

引数

• year: 西暦
• week: 年の週番号 (1 から 53)
• day: 週の曜日番号 (1 から 7)
• tz: タイムゾーン (省略可能)

返値

Timestamp オブジェクト

例

from pandas import Timestamp

# 2024年3月21日 (木) を作成
ts = Timestamp.fromisocalendar(2024, 12, 4)

print(ts)
# Output: 2024-03-21 00:00:00+00:00

# タイムゾーンを指定
ts = Timestamp.fromisocalendar(2024, 12, 4, tz="Asia/Tokyo")

print(ts)
# Output: 2024-03-21 09:00:00+09:00

補足

• ISO 週番号は、1月1日が木曜日の場合は1から始まり、それ以外の場合は53から始まります。
• 曜日番号は、月曜日が1、日曜日が7です。
• Timestamp.fromisocalendar は、Python 3.8 以降でのみ使用できます。

Pandas arrays との関係

pandas.Timestamp.fromisocalendar は、pandas.arrays.DatetimeArray や pandas.Series などの Pandas データ構造で Timestamp オブジェクトを作成するために使用できます。

Pandas Timestamp.fromisocalendar サンプルコード

範囲の Timestamp オブジェクトを作成

from pandas import Timestamp

# 2024年3月19日から2024年3月25日までの Timestamp オブジェクトのリストを作成
dates = [Timestamp.fromisocalendar(2024, week, day) for week in range(12, 14) for day in range(1, 8)]

print(dates)
# Output:
# [Timestamp('2024-03-19 00:00:00+00:00'), Timestamp('2024-03-20 00:00:00+00:00'),
#  Timestamp('2024-03-21 00:00:00+00:00'), Timestamp('2024-03-22 00:00:00+00:00'),
#  Timestamp('2024-03-23 00:00:00+00:00'), Timestamp('2024-03-24 00:00:00+00:00'),
#  Timestamp('2024-03-25 00:00:00+00:00')]

特定の曜日の Timestamp オブジェクトを作成

from pandas import Timestamp

# 2024年3月21日 (木) を作成
ts = Timestamp.fromisocalendar(2024, 12, 4)

print(ts)
# Output: 2024-03-21 00:00:00+00:00

# 2024年3月25日 (日) を作成
ts = Timestamp.fromisocalendar(2024, 13, 7)

print(ts)
# Output: 2024-03-25 00:00:00+00:00

タイムゾーンを指定

from pandas import Timestamp

# 2024年3月21日 (木) を東京時間 (JST) で作成
ts = Timestamp.fromisocalendar(2024, 12, 4, tz="Asia/Tokyo")

print(ts)
# Output: 2024-03-21 09:00:00+09:00

Pandas Series で使用

from pandas import Series, Timestamp

# 2024年3月19日から2024年3月25日までの Timestamp オブジェクトの Series を作成
dates = Series([Timestamp.fromisocalendar(2024, week, day) for week in range(12, 14) for day in range(1, 8)])

print(dates)
# Output:
# 0   2024-03-19
# 1   2024-03-20
# 2   2024-03-21
# 3   2024-03-22
# 4   2024-03-23
# 5   2024-03-24
# 6   2024-03-25
# dtype: datetime64[ns]

Pandas Timestamp.fromisocalendar の代替方法

datetime.date.fromisocalendar を使用

from datetime import date
from pandas import Timestamp

# 2024年3月21日 (木) を作成
dt = date.fromisocalendar(2024, 12, 4)
ts = Timestamp(dt)

print(ts)
# Output: 2024-03-21 00:00:00+00:00

str を使用

from pandas import Timestamp

# 2024年3月21日 (木) を作成
ts = Timestamp("2024-W12-4")

print(ts)
# Output: 2024-03-21 00:00:00+00:00

pd.to_datetime を使用

from pandas import to_datetime

# 2024年3月21日 (木) を作成
ts = to_datetime("2024-W12-4")

print(ts)
# Output: 2024-03-21 00:00:00+00:00

これらの方法は、pandas.Timestamp.fromisocalendar と同じ結果を得ることができます。

• pandas.Timestamp.fromisocalendar は、Pandas のコードで使用する場合に最も便利です。
• datetime.date.fromisocalendar は、標準ライブラリを使用する場合に最も便利です。
• str や pd.to_datetime は、簡潔なコードを書きたい場合に便利です。