Pythonのdatetime.now()とdatetime.today()の違いとは？使い分けを解説

datetime.now() と datetime.today() の主な違い

Pythonのdatetimeモジュールには、現在の日時を取得するためのメソッドとして datetime.now() と datetime.today() の2つがあります。どちらも現在のローカル日時を返す点で似ていますが、両者には重要な違いが存在します。

1. キーワード引数（tz引数）の有無

最大の違いは、datetime.now() はオプションのキーワード引数 tz（tzinfoオブジェクト）を受け取ることができるのに対し、datetime.today() は一切のキーワード引数を受け取らないという点です。公式ドキュメントでもこの仕様が明記されています。

2. 公式ドキュメントの記述

Python公式ドキュメントでは、datetime.now() について次のように説明されています。

datetime.now() は現在のローカルな日付および時刻を返します。オプション引数 tz が None または指定されていない場合、このメソッドは today() と同じように動作します。ただし、可能であれば time.time() のタイムスタンプを経由する場合よりも高い精度で日時を取得します（例えば、C言語の gettimeofday() 関数を提供しているプラットフォームではこれが可能です）。

3. コードでの動作比較

実際のコードで挙動を確認してみましょう。

from datetime import datetime

# 引数なしの場合、now() と today() はほぼ同じ結果を返す
print(datetime.now())
print(datetime.today())

# now() はタイムゾーンを指定できる（zoneinfo モジュールを使用）
from zoneinfo import ZoneInfo
print(datetime.now(ZoneInfo("Asia/Tokyo")))  # タイムゾーン情報付き（aware）の日時

# today() にタイムゾーンを渡すことはできない
# datetime.today(ZoneInfo("Asia/Tokyo"))  # → TypeError が発生

4. aware と naive の違い

datetime.now() にタイムゾーンを指定すると、タイムゾーン情報を持つ「aware」なdatetimeオブジェクトが返されます。一方、datetime.today() は常にタイムゾーン情報を持たない「naive」なローカル日時を返します。国際化対応やサーバー間の時刻同期が必要なアプリケーションでは、この違いが非常に重要になります。

まとめ：どちらを使うべきか

• datetime.now()：タイムゾーン（tzinfo）を指定でき、awareなdatetimeオブジェクトを取得可能。より高精度な日時を取得できる。
• datetime.today()：引数を取らず、常にnaiveなローカル日時を返すシンプルなメソッド。
• 現代のPython開発では、UTCを扱う datetime.now(timezone.utc) のように now() を使うことがベストプラクティスとされています。