timezone-tools

name

timezone-tools

description

Get current time in any timezone and convert times between timezones. Use when working with time, dates, timezones, scheduling across regions, "what time is it in X", "convert 3pm Sydney to London", DST checks, or when the user mentions specific cities/regions for time queries. Supports IANA timezone names. Do NOT use for date arithmetic (adding days/months), recurring event scheduling, business-day calculations, or full calendar/booking logic - those need a dedicated date library or scheduling tool.

Timezone Tools

Get current time in any timezone and convert times between different timezones using IANA timezone database.

Quick Start

Get current time in a timezone

python scripts/get_time.py "America/New_York"

Convert time between timezones

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

Search for timezone names

python scripts/list_timezones.py "perth"

Instructions

When the user asks about time or timezones:

1. For current time queries (e.g., "What time is it in Tokyo?"):

   • Use scripts/get_time.py with IANA timezone name
   • If unsure of timezone name, search first with list_timezones.py
   • Script outputs: timezone, datetime, day of week, DST status

2. For time conversions (e.g., "What's 2pm EST in Perth time?"):

   • Use scripts/convert_time.py with source timezone, time (HH:MM 24-hour), target timezone