できない.dev

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.py

3.14 で警告をエラーに変えて走らせると、年の無い書式で strptime() を呼ぶ行が例外で止まる。
3.15 に上げる前に、止まった行を 1 の形に直す。

What's New によると、日を表す %e を年なしで使う書式も 3.15 で非推奨になり、3.17 で同じ扱いになる予定である。
%e を使っている書式も、いまのうちに年を足しておく。

よくある原因

  1. 誕生日や記念日のように、月と日だけの文字列を %m-%d や %m/%d で読んでいる。
    3.15.2 では datetime.strptime() のほか、date.strptime() と time.strptime() も同じ ValueError になった。
    %H:%M を足しても、年が無ければ止まる。
    月だけを読む %m は、年が無くても 1900 年 10 月 1 日として読めた。
  2. 3.13・3.14 で出ていた警告をそのままにして 3.15 に上げた。
    3.14 は警告を出したうえで 1900 年として読み、終了コードは 0 だった。
  3. syslog のように年を含まないログの時刻を %b %d %H:%M:%S で読んでいる。
    この書式も 3.15 では同じ ValueError になる。