Pythonのdatetimeにタイムゾーンを付与(zoneinfo)の使い方

# 基本: タイムゾーン付き(aware)なdatetimeを作る
from datetime import datetime
from zoneinfo import ZoneInfo

# Asia/Tokyo(日本時間)で 2023-05-01 09:30 を表す aware datetime
dt_aware = datetime(2023, 5, 1, 9, 30, tzinfo=ZoneInfo("Asia/Tokyo"))

print(dt_aware)          # 文字列表現にオフセット(+09:00)が含まれる
print(dt_aware.tzname()) # タイムゾーン名(JST)などが取得できる

pip install tzdata

# naive(タイムゾーンなし)とaware(タイムゾーンあり)の違い
from datetime import datetime
from zoneinfo import ZoneInfo

dt_naive = datetime(2023, 5, 1, 9, 30)  # tzinfo=None
dt_aware = datetime(2023, 5, 1, 9, 30, tzinfo=ZoneInfo("Asia/Tokyo"))

print(dt_naive, dt_naive.tzinfo)
print(dt_aware, dt_aware.tzinfo)

from datetime import datetime
from zoneinfo import ZoneInfo

# 1) 地域を明示する(例: 東京)
tokyo_now = datetime.now(ZoneInfo("Asia/Tokyo"))

# 2) システムのローカルタイムゾーンを自動付与
local_now = datetime.now().astimezone()  # tz未指定で現在時刻→ローカルTZ付与

print("Tokyo:", tokyo_now.isoformat())
print("Local:", local_now.isoformat(), local_now.tzinfo)

from datetime import datetime
from zoneinfo import ZoneInfo

utc_now = datetime.now(ZoneInfo("UTC"))
print(utc_now.isoformat(), utc_now.tzname())

from datetime import datetime
from zoneinfo import ZoneInfo

# もともと「東京の 2023-03-01 09:00」を表していたnaive時刻だとわかっている想定
dt_naive = datetime(2023, 3, 1, 9, 0, 0)

# 東京時間としてラベル付け(時刻は変わらない)
dt_tokyo = dt_naive.replace(tzinfo=ZoneInfo("Asia/Tokyo"))

# UTCへ「変換」して確認
dt_utc = dt_tokyo.astimezone(ZoneInfo("UTC"))

print("naive: ", dt_naive)         # tzなし
print("tokyo: ", dt_tokyo)         # +09:00が付くが、時刻は 09:00 のまま
print("to UTC:", dt_utc)           # 00:00+00:00 に変換される

from datetime import datetime
from zoneinfo import ZoneInfo

dt_tokyo = datetime(2023, 12, 1, 12, 0, tzinfo=ZoneInfo("Asia/Tokyo"))
dt_ny = dt_tokyo.astimezone(ZoneInfo("America/New_York"))

print("Tokyo:", dt_tokyo.isoformat())
print("NY:   ", dt_ny.isoformat(), dt_ny.tzname())

from datetime import datetime
from zoneinfo import ZoneInfo

# 1) すでにローカルTZが付いた現在時刻 → UTCへ
local_now = datetime.now().astimezone()
to_utc = local_now.astimezone(ZoneInfo("UTC"))
print("local_now:", local_now.isoformat())
print("to_utc   :", to_utc.isoformat())

# 2) naiveな「東京の時刻」とわかっているケース → 東京を付与 → UTCへ
dt_naive_tokyo = datetime(2023, 7, 1, 12, 0, 0)  # これが東京の時刻だと分かっている前提
dt_tokyo = dt_naive_tokyo.replace(tzinfo=ZoneInfo("Asia/Tokyo"))
dt_utc = dt_tokyo.astimezone(ZoneInfo("UTC"))
print("tokyo    :", dt_tokyo.isoformat())
print("utc      :", dt_utc.isoformat())

from datetime import datetime
from zoneinfo import ZoneInfo

# 受信: クライアントのローカル時刻(例: Asia/Tokyo) → UTCで保存
received_local = datetime(2024, 10, 1, 9, 0, tzinfo=ZoneInfo("Asia/Tokyo"))
store_utc = received_local.astimezone(ZoneInfo("UTC"))
print("save(UTC):", store_utc.isoformat())

# 表示: 保存していたUTC → ユーザーがNYならNY時間に変換して表示
display_for_ny = store_utc.astimezone(ZoneInfo("America/New_York"))
print("display (NY):", display_for_ny.isoformat(), display_for_ny.tzname())

from datetime import datetime, timedelta
from zoneinfo import ZoneInfo

# 2023-03-12はNYで夏時間開始(02:00がスキップ)
dt_utc1 = datetime(2023, 3, 12, 6, 30, tzinfo=ZoneInfo("UTC"))  # 切替前
dt_utc2 = dt_utc1 + timedelta(hours=2)                          # 2時間後(切替後)

ny1 = dt_utc1.astimezone(ZoneInfo("America/New_York"))
ny2 = dt_utc2.astimezone(ZoneInfo("America/New_York"))

print("UTC1:", dt_utc1.isoformat(), "-> NY:", ny1.isoformat(), ny1.tzname())
print("UTC2:", dt_utc2.isoformat(), "-> NY:", ny2.isoformat(), ny2.tzname())

pip install tzdata

from datetime import datetime
from zoneinfo import ZoneInfo, ZoneInfoNotFoundError

def safe_zone(name: str, fallback="UTC"):
    try:
        return ZoneInfo(name)
    except ZoneInfoNotFoundError:
        print(f"[warn] timezone '{name}' not found. fallback to {fallback}")
        return ZoneInfo(fallback)

dt = datetime(2024, 1, 1, 12, 0, 0, tzinfo=safe_zone("Asia/Tokyoo"))  # 綴りミス
print(dt.isoformat(), dt.tzinfo)

from datetime import datetime
from zoneinfo import ZoneInfo

dt_tokyo = datetime(2024, 4, 5, 14, 23, 45, 123456, tzinfo=ZoneInfo("Asia/Tokyo"))
print("Tokyo:", dt_tokyo.isoformat())

dt_utc = dt_tokyo.astimezone(ZoneInfo("UTC"))
print("UTC  :", dt_utc.isoformat())

# Z表記にしたい場合(マイクロ秒を落としつつ)
dt_utc_z = dt_utc.replace(microsecond=0).isoformat().replace("+00:00", "Z")
print("UTC(Z):", dt_utc_z)

# 小数部桁数を制御したい場合(timespec)
print("seconds:", dt_tokyo.isoformat(timespec="seconds"))