Python「Day of month directive '%d' may not be used」の原因と直し方
Python 3.15 の Day of month directive '%d' may not be used は、入力と書式に年を足せば直る。
3.15 から、年の無い書式で %d を使う strptime() は ValueError になった。
公開:
要約
Python 3.15 で datetime.strptime("10-31", "%m-%d") のように年の無い書式で日付を読むと、次の ValueError で止まる。
ValueError: Day of month directive '%d' may not be used without a year directive. Parsing dates involving a day of month without a year is ambiguous and fails to parse leap day. Add a year to the input and format. See https://github.com/python/cpython/issues/70647.3.14 までは、年の無い書式で読んだ日付を 1900 年として扱っていた。
1900 年はうるう年ではないので、"02-29" は読めない。
この挙動は 3.13 から DeprecationWarning で予告され、3.15 で ValueError に変わった(What's new in Python 3.15(新しいタブで開く))。
入力と書式に年を足せば直る。
解決策
1. 入力と書式に年を足す
from datetime import datetime
s = "02-29"
d = datetime.strptime(f"2024-{s}", "%Y-%m-%d")
print(d.month, d.day) # 2 29足す年はうるう年にする。
うるう年でない年を足すと、2 月 29 日が ValueError になる。
公式のドキュメントの strptime() の項も、年の無い文字列にはうるう年を足してから読むよう書いている(例は 1984 年)。
月と日だけが要るなら、d.month と d.day を使えば、足した年は外に出ない。
ログの時刻のように日付そのものが要るなら、うるう年ではなく実際の年(ファイルの更新日の年など)を足す。
2. 3.14 のうちに呼び出しを洗い出す
python -W error::DeprecationWarning app.py3.14 で警告をエラーに変えて走らせると、年の無い書式で strptime() を呼ぶ行が例外で止まる。
3.15 に上げる前に、止まった行を 1 の形に直す。
What's New によると、日を表す %e を年なしで使う書式も 3.15 で非推奨になり、3.17 で同じ扱いになる予定である。%e を使っている書式も、いまのうちに年を足しておく。
よくある原因
- 誕生日や記念日のように、月と日だけの文字列を
%m-%dや%m/%dで読んでいる。
3.15.2 ではdatetime.strptime()のほか、date.strptime()とtime.strptime()も同じValueErrorになった。%H:%Mを足しても、年が無ければ止まる。
月だけを読む%mは、年が無くても 1900 年 10 月 1 日として読めた。 - 3.13・3.14 で出ていた警告をそのままにして 3.15 に上げた。
3.14 は警告を出したうえで 1900 年として読み、終了コードは 0 だった。 - syslog のように年を含まないログの時刻を
%b %d %H:%M:%Sで読んでいる。
この書式も 3.15 では同じValueErrorになる。