Pythonで日付の妥当性を検証する方法！strptimeの使い方と書式指定子一覧

Pythonで日付の妥当性検証（バリデーション）を行う方法は、扱う日付データの形式によって大きく異なります。最も一般的なのは、datetimeモジュールが提供するstrptime()関数を使って、文字列を日付・時刻オブジェクトに変換する方法です。この関数は指定した書式に一致しない文字列を受け取ると例外を発生させるため、それを利用して日付が正しいかどうかを判定できます。

strptime()を使った基本的な日付検証

以下は、文字列が「YYYY-MM-DD」形式の有効な日付であるかを確認するサンプルコードです。

import datetime

date_string = '2017-12-31'
date_format = '%Y-%m-%d'

try:
  date_obj = datetime.datetime.strptime(date_string, date_format)
  print(date_obj)
except ValueError:
  print("日付の形式が正しくありません。YYYY-MM-DD形式で入力してください")

実行結果

このコードを実行すると、次のような出力が得られます。

2017-12-31 00:00:00

もしdate_stringに「2017-13-31」のような存在しない日付や、形式に合わない文字列を渡すと、ValueErrorが発生し、exceptブロックのメッセージが表示されます。これにより、無効な日付を確実に検出できます。

strptime()で使える主な書式指定子

strptime()では、さまざまな書式指定子（ディレクティブ）を組み合わせて日付を解析できます。代表的な指定子は以下の通りです。

補足：ISO形式ならfromisoformat()も便利

Python 3.7以降では、「YYYY-MM-DD」のようなISO 8601形式の日付文字列であれば、datetime.date.fromisoformat()を使うとよりシンプルに検証できます。

import datetime

try:
  date_obj = datetime.date.fromisoformat('2017-12-31')
  print(date_obj)
except ValueError:
  print("無効な日付です")

用途に応じてstrptime()とfromisoformat()を使い分けることで、柔軟かつ堅牢な日付バリデーションを実装できます。