Python
PR

Pythonのdatetimeの使い方|日時の計算・タイムゾーン・Unix時間を実例で解説

Pythonのdatetimeの使い方|日時の計算・タイムゾーン・Unix時間を実例で解説
hr
記事内に商品プロモーションを含む場合があります

ログに時刻を付ける、締め切りまでの残り日数を出す、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
timezoneUTC からのずれ(時差)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(タイムゾーンなし)に分けています。

naiveaware
作り方の例datetime.now()
datetime(2026, 10, 18, 9, 30)
datetime.now(JST)
datetime(2026, 10, 18, 9, 30, tzinfo=JST)
tzinfoNoneタイムゾーンが入っている
表示2026-10-18 09:30:002026-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
%zUTC との時差+0900
%:zUTC との時差(コロンあり。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 を指定する

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました