| この記事の要点 |
|
タイムゾーンと現在日時の取得とは
サーバが UTC で稼働している場合や、複数地域のユーザーを相手にするアプリでは、「いつのこと?」を正しく扱うためにタイムゾーンを意識した日時処理が必須です。Python では datetime モジュールに加え、pytz または zoneinfo でタイムゾーンを取り扱います。
方式の選び方
| 方式 | Python バージョン | 推奨度 |
|---|---|---|
zoneinfo(標準) | 3.9 以上 | ★★★(推奨) |
pytz(サードパーティ) | 3.8 以下も可 | ★★(互換用途) |
datetime.timezone 直接 | 3.2 以上 | ★(簡易用途) |
1. zoneinfo(Python 3.9+ 推奨)
インポート
from datetime import datetime
from zoneinfo import ZoneInfo
現在日時の取得
jst = ZoneInfo('Asia/Tokyo')
now = datetime.now(jst)
print(now)
# 2026-06-11 14:30:00+09:00
文字列化
# strftime で任意フォーマット
now_str = now.strftime('%Y-%m-%d %H:%M:%S')
print(now_str) # 2026-06-11 14:30:00
# ISO 8601 形式
print(now.isoformat()) # 2026-06-11T14:30:00+09:00
別タイムゾーンへの変換
utc = ZoneInfo('UTC')
ny = ZoneInfo('America/New_York')
now_jst = datetime.now(ZoneInfo('Asia/Tokyo'))
now_utc = now_jst.astimezone(utc)
now_ny = now_jst.astimezone(ny)
print(now_jst) # 2026-06-11 14:30:00+09:00
print(now_utc) # 2026-06-11 05:30:00+00:00
print(now_ny) # 2026-06-11 01:30:00-04:00
2. pytz(旧来からの定番)
インポート
from datetime import datetime
from pytz import timezone
現在日時の取得
jst = timezone('Asia/Tokyo')
now = datetime.now(jst)
print(now)
# 2026-06-11 14:30:00+09:00
日付の文字列化
now_str = now.strftime('%Y-%m-%d %H:%M:%S')
print(now_str) # 2026-06-11 14:30:00
pytz の注意点
pytz はlocalize() を使わずに datetime(2026, 6, 11, tzinfo=jst) のように直接渡すと、古い時刻の歴史的なオフセットが当たって誤動作することがあります。
# NG: 直接 tzinfo に渡すとオフセットがズレる
naive = datetime(2026, 6, 11, 14, 30)
bad = naive.replace(tzinfo=jst) # +09:19 とかになる場合がある
# OK: localize を使う
good = jst.localize(naive) # +09:00 になる
zoneinfo はこの問題がない(タプル渡しの替わりに不可変な情報を持つ)ため、新規コードでは zoneinfo を推奨します。
3. UTC を扱う簡易版
from datetime import datetime, timezone
now_utc = datetime.now(timezone.utc)
print(now_utc.isoformat())
# 2026-06-11T05:30:00+00:00
strftime / strptime フォーマット指定子
| 指定子 | 意味 | 例 |
|---|---|---|
%Y | 4 桁の西暦 | 2026 |
%m | 月 (01-12) | 06 |
%d | 日 (01-31) | 11 |
%H | 時 (00-23) | 14 |
%M | 分 (00-59) | 30 |
%S | 秒 (00-59) | 00 |
%z | UTC オフセット | +0900 |
%Z | タイムゾーン名 | JST |
%a / %A | 曜日(短/長) | Thu / Thursday |
文字列 → datetime に戻す
from datetime import datetime
from zoneinfo import ZoneInfo
s = '2026-06-11 14:30:00'
naive = datetime.strptime(s, '%Y-%m-%d %H:%M:%S')
aware = naive.replace(tzinfo=ZoneInfo('Asia/Tokyo'))
print(aware) # 2026-06-11 14:30:00+09:00
# ISO 8601 文字列なら fromisoformat
dt = datetime.fromisoformat('2026-06-11T14:30:00+09:00')
print(dt) # 2026-06-11 14:30:00+09:00
naive と aware
| 種類 | tzinfo | 用途 |
|---|---|---|
| naive | None | タイムゾーン情報なし。地域不明 |
| aware | tzinfo を持つ | タイムゾーン情報あり。正確な時刻 |
naive と aware を混在させると例外。両方 aware に揃えるか、文字列でやり取りするのが安全です。
from datetime import datetime
from zoneinfo import ZoneInfo
naive = datetime(2026, 6, 11, 14, 30)
aware = datetime(2026, 6, 11, 14, 30, tzinfo=ZoneInfo('Asia/Tokyo'))
# print(aware - naive) # TypeError!
# 必ず aware に揃える
print(aware - aware.replace(tzinfo=ZoneInfo('UTC')))
よくあるタイムゾーン名
| 地域 | タイムゾーン名 | UTC オフセット |
|---|---|---|
| 日本 | Asia/Tokyo | +09:00 |
| UTC | UTC | +00:00 |
| ロンドン | Europe/London | +00:00 / +01:00 (DST) |
| ニューヨーク | America/New_York | -05:00 / -04:00 (DST) |
| ロサンゼルス | America/Los_Angeles | -08:00 / -07:00 (DST) |
| シンガポール | Asia/Singapore | +08:00 |
FAQ
Q: utcnow() はなぜ非推奨?
A: datetime.utcnow() は naive を返すため、aware と混在しやすく事故の元。Python 3.12 以降は非推奨。datetime.now(timezone.utc) を使いましょう。
Q: Windows で zoneinfo がエラーになる
A: pip install tzdata で IANA タイムゾーンデータベースを追加すると解決します。
関連
- datetime — 日付・時刻を扱う標準モジュール
- zoneinfo — IANA タイムゾーン(Python 3.9+)
- pytz — サードパーティのタイムゾーンライブラリ
- strftime — フォーマット指定で文字列化
子ページ
子ページはありません
同階層のページ
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスとは|モデリング/レンダリング/主要ソフトウェア (Blender / Maya)
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- プロジェクトをTomcatプロジェクトとして認識させる方法 2026-10-07 22:32:50
- MySQLの1366 Incorrect string value|Laravelの文字コード・絵文字エラー 2026-10-07 21:54:03
- curlの証明書ホスト名不一致|旧エラー51・現行60の確認と対処 2026-10-07 21:54:03
- LaravelのMassAssignmentException|fillableの原因と安全な対処 2026-10-07 21:54:03
- Eclipse で Tomcat の起動ログがコンソールに出ない時の確認手順 2026-10-07 21:54:02
- MySQLにおける中央値(Median)の導き方(バージョン8未満) 2026-10-07 13:49:45
- getInputForward 2026-10-07 13:41:15
- JSONから配列に変換 2026-10-07 13:41:15
- ビューから値をモデルに格納しコントローラーで受け取る方法 2026-10-07 13:23:41
- Laravelのテーブル作成と定義変更|マイグレーション・up/down・注意点 2026-10-07 13:23:41
- NumPy 配列に要素を追加する方法 (append / concatenate) 2026-10-07 13:23:41
- MariaDB・MySQLで現在日時を取得する方法|NOW・タイムゾーン・保存型 2026-10-07 13:13:36
- 【django】テンプレートで定数を使用する方法 2026-10-07 13:10:15
- Spring BootにおけるApplication.propertiesの環境依存設定の分割方法 2026-10-07 12:09:35
- Not supported for DML operations【Springエラー】 2026-10-07 11:09:38