timezone-tools

タイムゾーンツール

IANA タイムゾーンデータベースを使用して、任意のタイムゾーンの現在時刻を取得し、異なるタイムゾーン間で時刻を変換します。

クイックスタート

タイムゾーンの現在時刻を取得する

python scripts/get_time.py "America/New_York"

タイムゾーン間で時刻を変換する

python scripts/convert_time.py "America/New_York" "14:30" "Australia/Perth"

タイムゾーン名を検索する

python scripts/list_timezones.py "perth"

手順

ユーザーから時刻やタイムゾーンについて質問された場合：

1. 現在時刻に関する質問の場合（例：「東京は今何時ですか？」）：

   • IANA タイムゾーン名を指定して scripts/get_time.py を使用します
   • タイムゾーン名がわからない場合は、まず list_timezones.py で検索します
   • スクリプトの出力：タイムゾーン、日時、曜日、夏時間の状態

2. 時刻の変換に関する質問の場合（例：「EST の午後2時はパース時刻で何時ですか？」）：

   • 変換元のタイムゾーン、時刻（24時間形式の HH:MM）、変換先のタイムゾーンを指定して scripts/convert_time.py を使用します
   • スクリプトには変換元の時刻、変換後の時刻、時差が表示されます
   • 夏時間の変更は自動的に処理されます

3. タイムゾーンの検索の場合：

   • 都市名または国名を指定して scripts/list_timezones.py を使用します
   • 一致する IANA タイムゾーン名が返されます

よく使うタイムゾーンの一覧

すぐに確認するには、世界の主要都市（特にパース）を掲載した data/common_timezones.json を参照してください。

ユーザーのローカルタイムゾーン：スクリプトは tzlocal を使用してローカルタイムゾーンを自動的に検出します。

例

例 1：現在時刻に関する質問

ユーザー：「パースは今何時ですか？」

python scripts/list_timezones.py "perth"
# Output: Australia/Perth

python scripts/get_time.py "Australia/Perth"
# Output:
# Timezone: Australia/Perth
# Current time: 2025-11-07T15:30:45
# Day: Thursday
# DST: No

例 2：時刻の変換

ユーザー：「ニューヨーク時間の午後2時に会議があります。パースでは何時ですか？」

python scripts/convert_time.py "America/New_York" "14:00" "Australia/Perth"
# Output:
# Source: America/New_York - 2025-11-07T14:00:00 (Thursday, DST: No)
# Target: Australia/Perth - 2025-11-08T03:00:00 (Friday, DST: No)
# Time difference: +13.0h

例 3：複数のタイムゾーンを検索

ユーザー：「ロンドン、東京、シドニーのタイムゾーンコードを教えてください。」

python scripts/list_timezones.py "london"
python scripts/list_timezones.py "tokyo"
python scripts/list_timezones.py "sydney"
# Outputs:
# Europe/London
# Asia/Tokyo
# Australia/Sydney

時刻形式

• すべての時刻は24時間形式（HH:MM）です：14:30（2:30 PM ではありません）
• 出力には ISO 8601 の日時形式を使用します：2025-11-07T14:30:45
• IANA タイムゾーン名を使用します（例：EST ではなく America/New_York）

トラブルシューティング

「Invalid timezone」エラー

• IANA タイムゾーン名を使用してください：EST や Eastern ではなく America/New_York
• タイムゾーン名がわからない場合は、list_timezones.py で検索してください
• 参照先として data/common_timezones.json を確認してください

「Invalid time format」エラー

• 24時間形式を使用してください：2:30 PM ではなく 14:30
• 形式はコロンで区切った HH:MM である必要があります

依存関係の不足

必要な Python パッケージをインストールします：

pip install tzlocal

依存関係

• Python 3.9+
• tzlocal>=5.0 - ローカルタイムゾーンの検出に使用
• zoneinfo - Python 3.9+ に組み込み（IANA タイムゾーンデータベース）

補足

• スクリプトは夏時間（DST）を自動的に処理します
• ローカルタイムゾーンはシステムから自動検出されます
• すべてのタイムゾーンデータは IANA Time Zone Database を使用します
• オーストラリア・パースのタイムゾーン：Australia/Perth（UTC+8、夏時間なし）