Pythonのdatetimeの使い方|日時の計算・タイムゾーン・Unix時間を実例で解説
ログに時刻を付ける、締め切りまでの残り日数を出す、API から受け取った「2026-10-18T00:30:00Z」のような文字列を日本時間に直す。Python でこうした日時の処理をするときは、最初から入っている datetime モジュールを使います。
この記事では、naive と aware の違い、日本時間の指定方法(Windows で必要になる tzdata を含む)、文字列との変換、timedelta での計算と月末・うるう年の注意点、Unix 時間との変換を実行結果つきで説明します。載せている出力は、Windows 11・Python 3.12.6 で実際に実行して確かめたものです。
datetime モジュールの主なクラス
よく使うクラスは次の 4 つです。モジュール名とクラス名がどちらも datetime なので、from datetime import datetime の形で読み込みます。
| クラス | 表すもの | 例 |
|---|---|---|
datetime | 日付と時刻 | 2026-10-18 09:30:00 |
date | 日付だけ | 2026-10-18 |
timedelta | 時間の長さ(差) | 2 days, 8:30:00 |
timezone | UTC からのずれ(時差) | UTC+09:00 |
現在の日時を取得する:datetime.now()
次のコードを sample.py という名前で保存します。
from datetime import datetime, timezone, timedelta
now = datetime.now()
print(now)
print(now.tzinfo)
JST = timezone(timedelta(hours=9))
now_jst = datetime.now(JST)
print(now_jst)
print(now_jst.tzinfo)
now_utc = datetime.now(timezone.utc)
print(now_utc)
PowerShell で、sample.py を保存したフォルダーに移動してから実行します。
py sample.py
次の出力は、日本時間の 2026 年 10 月 18 日 3 時 15 分ごろに実行したときのものです。現在時刻なので、実行した時刻によって変わります。
2026-10-18 03:15:47.213282
None
2026-10-18 03:15:47.213282+09:00
UTC+09:00
2026-10-17 18:15:47.213282+00:00
1 行目と 3 行目は同じ時刻ですが、3 行目には +09:00 が付いています。この違いが一番大事なポイントです。
naive と aware の違い
Python の公式ドキュメントでは、日時のオブジェクトを、タイムゾーンの情報を持つかどうかで aware(タイムゾーンあり)と naive(タイムゾーンなし)に分けています。
| naive | aware | |
|---|---|---|
| 作り方の例 | datetime.now()datetime(2026, 10, 18, 9, 30) | datetime.now(JST)datetime(2026, 10, 18, 9, 30, tzinfo=JST) |
tzinfo | None | タイムゾーンが入っている |
| 表示 | 2026-10-18 09:30:00 | 2026-10-18 09:30:00+09:00 |
| 意味 | 「9 時 30 分」だけ。どこの国の時刻かは分からない | 「日本時間の 9 時 30 分」と 1 つに決まる |
datetime.now() は「その PC の設定のタイムゾーン」の naive の時刻を返します。日本の PC では日本時間、UTC に設定されたサーバーでは UTC になり、同じプログラムでも動かす場所によって 9 時間ずれます。
naive と aware は混ぜて計算できない
naive と aware の日時は、引き算や大小の比較ができません。== での比較はエラーにならず、必ず False になります。
from datetime import datetime, timezone, timedelta
JST = timezone(timedelta(hours=9))
a = datetime(2026, 10, 18, 9, 30)
b = datetime(2026, 10, 18, 9, 30, tzinfo=JST)
print(a == b)
print(b - a)
False
Traceback (most recent call last):
...
TypeError: can't subtract offset-naive and offset-aware datetimes
大小の比較(a < b)では TypeError: can't compare offset-naive and offset-aware datetimes になります。プログラムの中では、どちらかにそろえる(迷ったら aware にそろえる)のが基本です。
日本時間(JST)を指定する 2 つの方法
日本時間は UTC(協定世界時)より 9 時間進んでいて、+09:00 と書きます。Python で日本時間を指定する方法は 2 つあります。
| 書き方 | 特徴 | tzname() の結果 |
|---|---|---|
timezone(timedelta(hours=9)) | 時差を数字で決める。追加のデータがいらない。サマータイムには対応しない | UTC+09:00 |
ZoneInfo("Asia/Tokyo") | 地域の名前で指定する(Python 3.9 以降)。サマータイムのある国も正しく扱える。Windows では tzdata が必要なことがある | JST |
日本時間だけならどちらでも結果は同じです。海外の時刻も扱うなら ZoneInfo を使います。ニューヨークで試すと、夏と冬で時差が切り替わりました。
from datetime import datetime
from zoneinfo import ZoneInfo
ny = ZoneInfo("America/New_York")
print(datetime(2026, 7, 1, 12, 0, tzinfo=ny))
print(datetime(2026, 12, 1, 12, 0, tzinfo=ny))
print(datetime.now(ZoneInfo("Asia/Tokyo")))
2026-07-01 12:00:00-04:00
2026-12-01 12:00:00-05:00
2026-10-18 03:15:47.249231+09:00
3 行目は現在時刻なので、実行した時刻で変わります。
Windows で ZoneInfoNotFoundError が出たら tzdata を入れる
Python の公式ドキュメント(zoneinfo)によると、zoneinfo モジュールはタイムゾーンのデータを自分では持たず、OS のデータか、PyPI の tzdata パッケージから読み込みます。そして「Windows などには IANA のタイムゾーンデータベースがない」「OS のデータも tzdata もないと、ZoneInfo を呼ぶとすべて ZoneInfoNotFoundError になる」と書かれています。
実際に、Windows 11 で作ったばかりの仮想環境(venv)で ZoneInfo("Asia/Tokyo") を使うと、次のエラーで止まりました(長いので一部を省略しています)。
ModuleNotFoundError: No module named 'tzdata'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
...
zoneinfo._common.ZoneInfoNotFoundError: 'No time zone found with key Asia/Tokyo'
仮想環境を有効にした状態で、次のコマンドで tzdata を入れると、同じコードが 2026-10-18 09:30:00+09:00 のように動きました。
py -m pip install tzdata
pandas などを入れると tzdata も一緒に入るため、「自分の PC では動くのに、新しい仮想環境では動かない」ということが起こります。Windows でも動かすプログラムで ZoneInfo を使うなら、requirements.txt に tzdata を書いておくと安心です。仮想環境と requirements.txt については、venv の記事と pip の記事で説明しています。
タイムゾーンを付ける replace と、変換する astimezone
次の 2 つを取り違えると 9 時間ずれます。
replace(tzinfo=...) は時刻の数字はそのままで、タイムゾーンの情報だけを付け替えます。astimezone(...) は同じ瞬間を、別のタイムゾーンの時刻に変換します。
from datetime import datetime, timezone, timedelta
JST = timezone(timedelta(hours=9))
utc = datetime(2026, 10, 18, 0, 30, tzinfo=timezone.utc)
print(utc.astimezone(JST))
print(utc.replace(tzinfo=JST))
naive = datetime(2026, 10, 18, 9, 30)
print(naive.replace(tzinfo=JST))
2026-10-18 09:30:00+09:00
2026-10-18 00:30:00+09:00
2026-10-18 09:30:00+09:00
UTC の 0 時 30 分は日本時間の 9 時 30 分なので、1 行目(astimezone)が正しい変換です。2 行目(replace)は数字がそのままなので、9 時間ずれた別の時刻になっています。replace は、3 行目のように「日本時間だと分かっている naive の日時に、タイムゾーンを付ける」ときに使います。
日時を文字列にする:strftime
strftime(string format time)は、日時を好きな形の文字列にします。%Y などの書式コードが、年や月の数字に置き換わります。
from datetime import datetime, timezone, timedelta
JST = timezone(timedelta(hours=9))
t = datetime(2026, 10, 18, 9, 5, 3, tzinfo=JST)
print(t.strftime("%Y-%m-%d %H:%M:%S"))
print(t.strftime("%Y年%m月%d日 %H時%M分"))
print(t.strftime("%a %b %d %I:%M %p"))
print(t.strftime("%z | %:z | %Z"))
print(f"{t:%Y/%m/%d}")
print(f"{t.year}年{t.month}月{t.day}日")
2026-10-18 09:05:03
2026年10月18日 09時05分
Sun Oct 18 09:05 AM
+0900 | +09:00 | UTC+09:00
2026/10/18
2026年10月18日
よく使う書式コードは次のとおりです。
| コード | 意味 | 例 |
|---|---|---|
%Y | 西暦 4 桁 | 2026 |
%m / %d | 月 / 日(0 埋め 2 桁) | 10 / 05 |
%H / %I | 時(24 時間制 / 12 時間制) | 21 / 09 |
%M / %S | 分 / 秒 | 05 / 03 |
%a / %A | 曜日の略称 / 正式名 | Sun / Sunday |
%b | 月の略称 | Oct |
%p | 午前・午後 | AM |
%z | UTC との時差 | +0900 |
%:z | UTC との時差(コロンあり。Python 3.12 から) | +09:00 |
%Z | タイムゾーン名 | UTC+09:00、JST |
注意点が 3 つあります。
- %M(分)と %m(月)を取り違えやすい:大文字の M が分、小文字の m が月です。
- naive の日時では %z・%:z・%Z が空になる:公式ドキュメントにも「naive のときは空文字に置き換わる」とあります。
- %a・%b・%p は言語の設定(ロケール)で変わる:上の出力は初期設定のまま実行したもので、英語になりました。日本語の曜日が必要なら、
"月火水木金土日"[t.weekday()]のように自分で変換するほうが確実です(weekday()は月曜が 0、日曜が 6)。
0 を付けないために %-m と書く例がありますが、これは Linux などの C ライブラリの拡張で、Python の公式ドキュメントにはありません。Windows の Python 3.12 で strftime("%-m") を実行すると ValueError: Invalid format string になりました。代わりに、上の最後の行のように t.month を f 文字列に入れます。
文字列を日時にする:strptime
strptime(string parse time)は逆に、文字列を読み取って datetime にします。文字列の形に合わせて、同じ書式コードで「どこに何が書いてあるか」を指定します。
from datetime import datetime
print(datetime.strptime("2026/10/18 09:30", "%Y/%m/%d %H:%M"))
print(datetime.strptime("2026年10月18日", "%Y年%m月%d日"))
print(datetime.strptime("2026-2-5", "%Y-%m-%d"))
print(datetime.strptime("2026-10-18 09:30:00 +0900", "%Y-%m-%d %H:%M:%S %z"))
print(datetime.strptime("2026-10-18T00:30:00Z", "%Y-%m-%dT%H:%M:%S%z"))
2026-10-18 09:30:00
2026-10-18 00:00:00
2026-02-05 00:00:00
2026-10-18 09:30:00+09:00
2026-10-18 00:30:00+00:00
%m や %d は 1 桁も読めます。%z を使うと aware の日時になり、+09:00 のようなコロン付きや、UTC を表す Z も読めます。%z がなければ naive になります。
strptime のエラーの読み方
文字列と書式が合わないと ValueError になります。メッセージで原因が分かります。
| 入力と書式 | エラーメッセージ | 原因 |
|---|---|---|
"2026-10-18" と "%Y/%m/%d" | time data ‘2026-10-18’ does not match format ‘%Y/%m/%d’ | 区切り文字が違う |
"2026-10-18 09:30" と "%Y-%m-%d" | unconverted data remains: 09:30 | 書式より文字列が長い(後ろが余った) |
"2026-02-30" と "%Y-%m-%d" | day is out of range for month | 存在しない日付 |
ISO 8601 形式との変換:isoformat と fromisoformat
「2026-10-18T09:30:00+09:00」のような形を ISO 8601 形式といい、API の応答やログ、JSON でよく使われます。この形なら、書式コードを書かずに変換できます。
from datetime import datetime, timezone, timedelta
JST = timezone(timedelta(hours=9))
t = datetime(2026, 10, 18, 9, 30, 15, 123456, tzinfo=JST)
print(t.isoformat())
print(t.isoformat(timespec="seconds"))
print(repr(datetime.fromisoformat("2026-10-18T09:30:00+09:00")))
print(repr(datetime.fromisoformat("2026-10-18T00:30:00Z")))
print(repr(datetime.fromisoformat("2026-10-18")))
2026-10-18T09:30:15.123456+09:00
2026-10-18T09:30:15+09:00
datetime.datetime(2026, 10, 18, 9, 30, tzinfo=datetime.timezone(datetime.timedelta(seconds=32400)))
datetime.datetime(2026, 10, 18, 0, 30, tzinfo=datetime.timezone.utc)
datetime.datetime(2026, 10, 18, 0, 0)
timedelta(seconds=32400) は 9 時間(9 × 3600 秒)のことです。末尾の Z は UTC を表し、Python 3.11 から fromisoformat で読めるようになりました(公式ドキュメントによると、3.10 以前の fromisoformat は isoformat() が出力する形しか読めず、Z には対応していません)。"2026/10/18 09:30" のようにスラッシュ区切りの文字列は ISO 8601 ではないので、Invalid isoformat string のエラーになります。その場合は strptime を使います。
datetime をそのまま json.dumps に渡すと TypeError になるので、JSON に入れるときは isoformat() で文字列にします。詳しくは Python で JSON を扱う方法の「datetime などを変換できない」で説明しています。
日時の計算:timedelta
日時に timedelta を足し引きすると、日付や時刻が繰り上がり・繰り下がりも含めて計算されます。日時どうしを引き算すると、timedelta が返ってきます。
from datetime import datetime, date, timedelta
t = datetime(2026, 10, 18, 9, 30)
print(t + timedelta(days=1))
print(t - timedelta(hours=10))
print(t + timedelta(weeks=2, minutes=45))
d = date(2026, 12, 24) - date(2026, 10, 18)
print(d, d.days)
diff = datetime(2026, 10, 20, 18, 0) - datetime(2026, 10, 18, 9, 30)
print(diff, diff.days, diff.seconds, diff.total_seconds())
2026-10-19 09:30:00
2026-10-17 23:30:00
2026-11-01 10:15:00
67 days, 0:00:00 67
2 days, 8:30:00 2 30600 203400.0
最後の行に注意してください。diff.seconds は「日数を除いた残りの秒数」(8 時間 30 分 = 30600 秒)で、全体の秒数ではありません。差の合計を秒で知りたいときは total_seconds()(203400 秒)を使います。
date どうしの引き算は、試験日までの残り日数などに使えます。date(2027, 4, 18) - date(2026, 10, 18) の .days は 182 でした。試験日から逆算して 1 日の勉強時間を決めたいときは、学習計画ツールでも同じ計算ができます。
「1 か月後」は timedelta では計算できない
timedelta が扱える単位は週・日・時・分・秒などで、月と年はありません。月によって日数が違うためです。timedelta(months=1) と書くと TypeError: 'months' is an invalid keyword argument for __new__() になります。
代わりに days=30 を足すと、1 月 31 日の 30 日後は 3 月 2 日になり、「1 か月後」とずれます。また、replace(month=2) で月だけ変えると、2 月 31 日は存在しないので ValueError: day is out of range for month になります。月の足し算は、月末にそろえる関数を自分で書くのが確実です。
import calendar
from datetime import date
def add_months(d, n):
y, m = divmod(d.month - 1 + n, 12)
year, month = d.year + y, m + 1
last = calendar.monthrange(year, month)[1]
return d.replace(year=year, month=month, day=min(d.day, last))
print(add_months(date(2026, 1, 31), 1))
print(add_months(date(2028, 1, 31), 1))
print(add_months(date(2026, 11, 30), 3))
print(add_months(date(2026, 3, 31), -1))
2026-02-28
2028-02-29
2027-02-28
2026-02-28
calendar.monthrange(年, 月)[1] で、その月の日数(月末の日)が分かります。2026 年 2 月は 28 日まで、うるう年の 2028 年 2 月は 29 日までになっています。月の計算が多いなら、外部ライブラリの python-dateutil にある relativedelta を使う方法もあります。
うるう年と 2 月 29 日の注意
うるう年かどうかは calendar.isleap(年) で調べられます。4 で割り切れる年がうるう年ですが、100 で割り切れて 400 で割り切れない年は平年です。実行すると、2026 年は False、2028 年は True、1900 年は False、2000 年は True でした。
2 月 29 日が絡むと注意が必要です。date(2026, 2, 29) は 2026 年がうるう年ではないので ValueError になります。date(2028, 2, 29).replace(year=2029) で「1 年後」を出そうとしても、2029 年 2 月 29 日はないので ValueError です。また、timedelta(days=365) を「1 年」として使うと、うるう年をまたぐと 1 日ずれます(2028-02-28 から 2029-02-28 までは 366 日)。
月末の日付は、翌月 1 日から 1 日引いても求められます(date(2026, 3, 1) - timedelta(days=1) は 2026-02-28)。
Unix 時間との変換:timestamp と fromtimestamp
Unix 時間(UNIX タイムスタンプ)は、1970 年 1 月 1 日 0 時 0 分 0 秒(UTC)からの経過秒数で日時を表す方法です。仕組みや、秒とミリ秒の見分け方、2038 年問題は Unix 時間変換ツールのページで説明しているので、ここでは Python での変換に絞ります。
from datetime import datetime, timezone, timedelta
from zoneinfo import ZoneInfo
JST = timezone(timedelta(hours=9))
print(datetime(2023, 11, 15, 7, 13, 20, tzinfo=JST).timestamp())
print(int(datetime(2023, 11, 15, 7, 13, 20, tzinfo=JST).timestamp()))
print(datetime.fromtimestamp(1700000000, tz=timezone.utc))
print(datetime.fromtimestamp(1700000000, tz=ZoneInfo("Asia/Tokyo")))
print(datetime.fromtimestamp(1700000000123 / 1000, tz=JST))
print(int(datetime.now(timezone.utc).timestamp()))
1700000000.0
1700000000
2023-11-14 22:13:20+00:00
2023-11-15 07:13:20+09:00
2023-11-15 07:13:20.123000+09:00
1792260989
timestamp() は小数(float)を返すので、整数の秒が欲しいときは int() で囲みます。JavaScript などから受け取る 13 桁の値はミリ秒なので、/ 1000 してから渡します。
naive の timestamp() は PC のタイムゾーンで結果が変わる
公式ドキュメントには「naive の datetime はローカル時刻(PC の時刻)とみなされる」とあり、tz を指定しない fromtimestamp() は「PC のローカルの日時に変換し、naive の datetime を返す」とあります。つまり、タイムゾーンを付けずに変換すると、同じコードでも PC の設定によって結果が変わります。
from datetime import datetime, timezone
naive = datetime(2023, 11, 15, 7, 13, 20)
print(naive.timestamp())
print(naive.replace(tzinfo=timezone.utc).timestamp())
print(datetime.fromtimestamp(1700000000))
print(datetime.now().astimezone().tzinfo)
タイムゾーンが「(UTC+09:00) 大阪、札幌、東京」の Windows 11 で実行した結果です。
1700000000.0
1700032400.0
2023-11-15 07:13:20
東京 (標準時)
サーバーが UTC で動いている場合を試すため、PowerShell で環境変数 TZ を UTC にしてから同じファイルを実行しました。この環境変数は、その PowerShell のウィンドウを閉じれば消えます(すぐ戻すなら Remove-Item Env:TZ)。
$env:TZ = "UTC"; py sample.py
1700032400.0
1700032400.0
2023-11-14 22:13:20
UTC
1 行目と 3 行目が、日本時間の PC と比べて 9 時間(32400 秒)ずれました。一方、タイムゾーンを付けた 2 行目は、どちらの環境でも同じ値です。Unix 時間と変換するときは、必ず aware の日時を使い、fromtimestamp には tz を指定すると覚えておきましょう。
同じ理由で、naive の UTC を返す datetime.utcnow() は Python 3.12 で非推奨になり、実行すると DeprecationWarning が出ます。代わりに datetime.now(timezone.utc) を使います。
よくある質問
データベースやログには、どのタイムゾーンで保存すればよいですか?
よく使われるのは、保存は UTC の aware(または Unix 時間)で行い、画面に表示するときに日本時間へ変換する方法です。文字列で保存するなら、+00:00 などの時差が付いた ISO 8601 形式にしておくと、fromisoformat でそのまま読み戻せます。
決まった時刻に Python のスクリプトを動かすには?
Linux のサーバーでは cron を使うのが一般的です。cron もサーバーのタイムゾーンの時刻で動くので、UTC のサーバーで「毎日 9 時」と書くと日本時間の 18 時に動きます。cron の書き方は Cron 式生成・解説ツールで確認できます。
まとめ
- タイムゾーンなし(naive)とあり(aware)を区別し、プログラムの中ではどちらかにそろえる
- 日本時間は
timezone(timedelta(hours=9))かZoneInfo("Asia/Tokyo")。Windows で ZoneInfo を使うなら tzdata を入れる - 文字列との変換は strftime・strptime。ISO 8601 形式なら isoformat・fromisoformat
- timedelta に月はない。月末・うるう年は calendar で確認する
- Unix 時間との変換は aware の日時で行い、fromtimestamp には tz を指定する
関連する記事・ツール
- Unix時間変換ツール
- Cron式生成・解説ツール
- PythonでJSONを扱う方法|json.loads・dumpsの使い方とエラー対処
- pipの使い方|インストール・アップグレード・requirements.txtを実例で解説
- Pythonのf文字列(f-string)の使い方|書式指定・桁区切り・ゼロ埋めを実例で解説
- Pythonのloggingの使い方|printから卒業するログ出力の基本と設定例
- タイムゾーンとUTC・ISO 8601の基本|エンジニアが日時の扱いで失敗しないために