できない.dev

Python で datetime の naive と aware を比較できず TypeError になる

can't compare offset-naive and offset-aware datetimes は tzinfo の有無が違う datetime を比較・減算したときに起きる。
両方を aware(zoneinfo / timezone.utc)に揃えると解決する。

公開: 更新:

症状できない · exit 1
python bad.py
Traceback (most recent call last):
  File "/tmp/tmp.U9cZOrL23Q/bad.py", line 5, in <module>
    print(aware > naive)
          ^^^^^^^^^^^^^
TypeError: can't compare offset-naive and offset-aware datetimes

2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細

要約

TypeError: can't compare offset-naive and offset-aware datetimes は、片方に tzinfo が付いて aware、もう片方が naive のまま比較・減算した場合に発生する。
両方を aware に揃えるのが基本方針である。
Python 3.9 以降は、標準モジュールの zoneinfo を使うことが推奨されている。

実行例

実際に上記の手順を python:3.12(Debian GNU/Linux 13 trixie)環境で動かした。
まず aware > naive の比較で、TypeError: can't compare offset-naive and offset-aware datetimes が終了コード 1 で発生した。
続く解消策1・2 では、aware 同士の比較と replace(tzinfo=...) による昇格・UTC 変換がそれぞれ正常に完了した。

$ python bad.py
Traceback (most recent call last):
  File "/tmp/tmp.U9cZOrL23Q/bad.py", line 5, in <module>
    print(aware > naive)
          ^^^^^^^^^^^^^
TypeError: can't compare offset-naive and offset-aware datetimes
$ echo $?
1
$ python solve_aware.py
aware 同士: False / 差分: 3:00:00
$ python solve_replace.py
昇格後: 2025-01-01 12:00:00+09:00 / UTC 変換: 2025-01-01 03:00:00+00:00

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
python:3.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 両方を aware にする

from datetime import datetime, timezone
from zoneinfo import ZoneInfo
 
now = datetime.now(ZoneInfo("Asia/Tokyo"))
later = datetime.now(timezone.utc)
 
# どちらも aware なので比較・減算が可能
print(later > now)

datetime 公式ドキュメント(新しいタブで開く) のとおり、tzinfo を持つかどうかで naive / aware が決まる。

2. naive を aware に昇格

from datetime import datetime
from zoneinfo import ZoneInfo
 
naive = datetime(2025, 1, 1, 12, 0)
aware = naive.replace(tzinfo=ZoneInfo("Asia/Tokyo"))

replace(tzinfo=...) は、時刻の数字をそのまま保ったまま「これは JST だ」と注釈を付ける操作である。
UTC に変換したいなら astimezone(timezone.utc) を続けて呼ぶ。

3. aware を naive に揃える(推奨しない)

from datetime import datetime, timezone
from zoneinfo import ZoneInfo
 
aware = datetime.now(timezone.utc)
naive = aware.astimezone(ZoneInfo("Asia/Tokyo")).replace(tzinfo=None)

DB の制約で naive しか保存できない場合の最終手段である。
意図しないタイムゾーン差を生むので、できるならスキーマ側を aware に直したほうがよい。

4. プロジェクト全体のルール統一

実用上は「内部表現は UTC aware、ユーザー表示で ZoneInfo 変換」が事故が少ない。
ZoneInfo 自体は zoneinfo モジュール公式(新しいタブで開く) のとおり標準ライブラリに含まれており、pytz は新規採用しなくてよい。

よくある原因

  1. datetime.now() と datetime.now(timezone.utc) が混在している。
    引数なしの now() は naive、tzinfo を渡すと aware で、結果の型が異なる。
  2. 外部ライブラリが aware を返している。
    SQLAlchemy / pydantic / Django ORM などは多くの場合 aware で値を返すため、自前の naive と比較すると落ちる。
  3. ISO 文字列にタイムゾーンが無い。
    datetime.fromisoformat("2025-01-01T12:00:00") はタイムゾーン情報なしで naive になり、末尾に +09:00 が付くと aware になる。
  4. pytz と zoneinfo が混在している。
    古い pytz 由来の tzinfo は localize 経由でないと正しく扱えず、zoneinfo と挙動が違う場面がある。