Python astimezone()の使い方|UTC・日本時間(JST)への変換とreplaceとの違い
Pythonのastimezone()は、タイムゾーン付きのdatetimeを、同じ瞬間のまま別のタイムゾーンの時刻に変換するメソッドです。dt.astimezone(ZoneInfo("Asia/Tokyo"))で日本時間、dt.astimezone(timezone.utc)でUTC、引数なしのdt.astimezone()で実行環境のローカル時刻になります。
よく混同されるreplace(tzinfo=...)は「ラベルの貼り替え」で、時刻は変換されません。この記事では、astimezone()の書き方、UTCと日本時間(JST)の相互変換、replace()やpytzのlocalize()との違い、naiveなdatetimeに使ったときの落とし穴を、Python 3.12で実行した結果つきで説明します。
astimezone()の書き方
公式ドキュメントでの定義はdatetime.astimezone(tz=None)です。返り値は「selfと同じUTC時刻を持ち、tzにおけるローカルな時刻を表す」datetimeになります(datetime — Python 3.15.0 ドキュメント、2026年10月18日確認)。
| 書き方 | 結果 |
|---|---|
dt.astimezone(ZoneInfo("Asia/Tokyo")) |
日本時間(+09:00)に変換 |
dt.astimezone(timezone.utc) |
UTC(+00:00)に変換 |
dt.astimezone() |
実行環境(OS)のローカル時刻に変換 |
dt.astimezone("Asia/Tokyo") |
TypeError(文字列は渡せない) |
引数にはZoneInfoやtimezoneなどのtzinfoオブジェクトを渡します。ZoneInfoはPython 3.9以降の標準モジュールzoneinfoに入っています。
astimezone()の基本:同じ瞬間を別の地域の時刻で表す
from zoneinfo import ZoneInfo
from datetime import datetime
dt = datetime(2026, 10, 18, 12, 0, tzinfo=ZoneInfo("Asia/Tokyo"))
print("東京 :", dt)
print("UTC :", dt.astimezone(ZoneInfo("UTC")))
print("ニューヨーク:", dt.astimezone(ZoneInfo("America/New_York")))
print("ロンドン :", dt.astimezone(ZoneInfo("Europe/London")))
実行結果:
東京 : 2026-10-18 12:00:00+09:00
UTC : 2026-10-18 03:00:00+00:00
ニューヨーク: 2026-10-17 23:00:00-04:00
ロンドン : 2026-10-18 04:00:00+01:00
4つとも同じ瞬間で、表記が違うだけです。ニューヨークとロンドンは10月18日の時点で夏時間のため、UTCとの差がそれぞれ-4時間、+1時間になっています。
UTCを日本時間(JST)に変換する
APIやデータベースから受け取ったUTCの時刻を日本時間で表示する、というのが最も多い使い方です。
from zoneinfo import ZoneInfo
from datetime import datetime, timezone, timedelta
utc = datetime(2026, 10, 18, 3, 0, tzinfo=timezone.utc)
print(utc.astimezone(ZoneInfo("Asia/Tokyo")))
JST = timezone(timedelta(hours=9), "JST")
print(utc.astimezone(JST))
print(utc.astimezone(JST).strftime("%Y-%m-%d %H:%M %Z"))
実行結果:
2026-10-18 12:00:00+09:00
2026-10-18 12:00:00+09:00
2026-10-18 12:00 JST
日本には夏時間がないため、ZoneInfo("Asia/Tokyo")でもtimezone(timedelta(hours=9))でも結果は同じです。夏時間のある地域を扱う可能性があるならZoneInfoを使ってください。
ISO形式の文字列(末尾がZ)から変換する
from zoneinfo import ZoneInfo
from datetime import datetime
s = "2026-10-18T03:00:00Z"
print(datetime.fromisoformat(s).astimezone(ZoneInfo("Asia/Tokyo")))
実行結果:
2026-10-18 12:00:00+09:00
末尾のZ(UTCの意味)をfromisoformat()が読めるのはPython 3.11以降です(同ドキュメント「バージョン 3.11 で変更」)。それより古い環境ではZを+00:00に置き換えてから渡します。
astimezone()とreplace()の違い
最も間違えやすい点です。
dt = datetime(2026, 10, 18, 12, 0, tzinfo=ZoneInfo("Asia/Tokyo"))
print("astimezone:", dt.astimezone(ZoneInfo("UTC")))
print("replace :", dt.replace(tzinfo=ZoneInfo("UTC")))
実行結果:
astimezone: 2026-10-18 03:00:00+00:00
replace : 2026-10-18 12:00:00+00:00
| やること | 時・分の数字 | 表す瞬間 | |
|---|---|---|---|
astimezone(tz) |
別の地域の時刻に変換 | 変わる | 同じ |
replace(tzinfo=tz) |
タイムゾーンのラベルだけ貼り替え | 変わらない | 別の瞬間になる |
replace()が正しいのは、タイムゾーンを持たない(naiveな)datetimeに「これは日本時間だ」と情報を補うときです。
naive = datetime(2026, 10, 18, 12, 0) # タイムゾーン情報なし
aware = naive.replace(tzinfo=ZoneInfo("Asia/Tokyo"))
print(aware)
実行結果:
2026-10-18 12:00:00+09:00
- naive → aware(タイムゾーンを付ける):
replace(tzinfo=...) - aware → 別のタイムゾーン(変換する):
astimezone(...) - aware → naive(タイムゾーンを外す):
replace(tzinfo=None)
pytzのlocalize()との違い
古いコードではpytzがよく使われています。pytzのタイムゾーンをreplace(tzinfo=...)で付けると、オフセットがおかしくなります(pytz 2026.5で確認)。
import pytz
from datetime import datetime
tokyo = pytz.timezone("Asia/Tokyo")
naive = datetime(2026, 10, 18, 12, 0)
print(naive.replace(tzinfo=tokyo))
print(tokyo.localize(naive))
print(tokyo.localize(naive).astimezone(pytz.utc))
実行結果:
2026-10-18 12:00:00+09:19
2026-10-18 12:00:00+09:00
2026-10-18 03:00:00+00:00
+09:19は、標準時が定められる前の地方平均時(LMT)のオフセットで、pytzではタイムゾーンをreplace()で付けるとこれが使われます。pytzでは「付けるときはlocalize()、変換はastimezone()」が決まりでした。標準のzoneinfoならreplace()で正しく付けられるので、新しく書くコードではzoneinfoを使うのが簡単です。pytzの使い方は「Python datetime・pytzでタイムゾーン操作完全ガイド」で扱っています。
naiveなdatetimeに使うと実行環境で結果が変わる
naive = datetime(2026, 10, 18, 12, 0)
print(naive.astimezone(ZoneInfo("UTC")))
実行結果(環境変数TZ=Asia/Tokyoで実行):
2026-10-18 03:00:00+00:00
実行結果(TZ=UTCで実行):
2026-10-18 12:00:00+00:00
Python 3.6以降、naiveなdatetimeにastimezone()を使うとエラーにならず、実行環境のローカル時刻とみなされます。手元のPC(日本時間)では正しく、UTC設定のサーバーでは9時間ずれる、という再現しにくい不具合の原因になります。先にreplace(tzinfo=...)で地域を明示してから変換してください。
引数なしのastimezone()も環境依存
from datetime import datetime, timezone
utc = datetime(2026, 10, 18, 3, 0, tzinfo=timezone.utc)
print(utc.astimezone())
実行結果(TZ=Asia/Tokyo):
2026-10-18 12:00:00+09:00
実行結果(TZ=UTC):
2026-10-18 03:00:00+00:00
「動いているPCの時刻で表示したい」ときには便利ですが、サーバー上で日本時間を出したいならZoneInfo("Asia/Tokyo")を明示します。
夏時間(サマータイム)も自動で反映される
from zoneinfo import ZoneInfo
from datetime import datetime, timezone
ny = ZoneInfo("America/New_York")
for d in [datetime(2026, 10, 18, 3, 0, tzinfo=timezone.utc),
datetime(2026, 12, 18, 3, 0, tzinfo=timezone.utc)]:
local = d.astimezone(ny)
print(local, local.tzname())
実行結果:
2026-10-17 23:00:00-04:00 EDT
2026-12-17 22:00:00-05:00 EST
同じUTC3時でも、10月は夏時間(EDT、-4時間)、12月は標準時(EST、-5時間)で変換されます。timezone(timedelta(hours=-5))のような固定オフセットでは、この切り替えは起きません。存在しない時刻・重複する時刻の扱いは「Python zoneinfoと夏時間」を参照してください。
保存はUTC、表示でastimezone()
from zoneinfo import ZoneInfo
from datetime import datetime, timezone
user_tz = ZoneInfo("Asia/Tokyo")
entered = datetime(2026, 10, 18, 12, 0, tzinfo=user_tz)
stored = entered.astimezone(timezone.utc) # 保存はUTC
print("保存:", stored.isoformat())
print("表示:", stored.astimezone(user_tz)) # 表示は利用者の地域
実行結果:
保存: 2026-10-18T03:00:00+00:00
表示: 2026-10-18 12:00:00+09:00
awareなdatetime同士の比較や引き算は、タイムゾーンが違っても自動で正しく計算されます。
tokyo = datetime(2026, 10, 18, 12, 0, tzinfo=ZoneInfo("Asia/Tokyo"))
ny = datetime(2026, 10, 17, 23, 0, tzinfo=ZoneInfo("America/New_York"))
print(tokyo == ny, tokyo - ny)
実行結果:
True 0:00:00
比較のためにわざわざastimezone()でそろえる必要はありません。astimezone()が必要になるのは、主に表示や文字列への書き出しのときです。
よくあるエラー
| エラー | 原因と対処 |
|---|---|
TypeError: tzinfo argument must be None or of a tzinfo subclass, not type 'str' |
astimezone("Asia/Tokyo")と文字列を渡した。ZoneInfo("Asia/Tokyo")で包む |
ZoneInfoNotFoundError: 'No time zone found with key Japan/Tokyo' |
キーの綴り違い。日本は"Asia/Tokyo" |
WindowsでZoneInfoNotFoundError |
OSにタイムゾーンデータが無い場合、zoneinfoはPyPIのtzdataパッケージを使う(zoneinfo ドキュメント)。pip install tzdataで入れる |
まとめ
astimezone(tz)は同じ瞬間を別のタイムゾーンの時刻に変換する- 日本時間は
ZoneInfo("Asia/Tokyo")、UTCはtimezone.utc replace(tzinfo=)はラベルの貼り替え。naiveにタイムゾーンを付けるときだけ使う- naiveなdatetimeや引数なしの
astimezone()は実行環境のタイムゾーンに依存する - 夏時間は
ZoneInfoなら自動で反映される
zoneinfoモジュール全体の使い方は「Python zoneinfoとは?」にまとめています。
よくある質問
Q. astimezone()で日本時間に変換するにはどう書きますか?
from zoneinfo import ZoneInfoとしたうえで、dt.astimezone(ZoneInfo(“Asia/Tokyo”))と書きます。dtはタイムゾーン付き(aware)のdatetimeにしておきます。
Q. astimezone()とreplace(tzinfo=)は何が違いますか?
astimezone()は同じ瞬間を別の地域の時刻に変換し、時・分の数字が変わります。replace(tzinfo=)はタイムゾーンのラベルだけを貼り替えるので数字は変わらず、別の瞬間を表すことになります。
Q. 引数なしのastimezone()は何に変換されますか?
実行しているOSのローカルなタイムゾーンに変換されます。サーバーの設定がUTCならUTCになるため、日本時間を出したい場合はZoneInfo(“Asia/Tokyo”)を明示します。
Q. naiveなdatetimeにastimezone()を使うとどうなりますか?
エラーにはならず、実行環境のローカル時刻とみなして変換されます(Python 3.6以降)。環境によって結果が変わるため、先にreplace(tzinfo=…)でタイムゾーンを付けてから変換してください。





