smithery/henkisdabro

timezone-tools

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…

Installation

$ npx skills add smithery/henkisdabro --skill timezone-tools

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/henkisdabro.

npx skills add smithery/henkisdabro

Browse all from smithery/henkisdabro

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,021 B
  • docs SUMMARY.md 258 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

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/gettime.py with IANA timezone name - If unsure of timezone name, search first with listtimezones.py - Script outputs: timezone, datetime, day of week, DST status

  1. 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 - Script shows source time, target time, and time difference - Automatically handles DST changes

  1. For timezone searches:

- Use scripts/list_timezones.py with city/country name - Returns matching IANA timezone names

Common Timezones Reference

For quick reference, see [data/commontimezones.json](data/commontimezones.json) which includes major cities worldwide, with Perth prominently featured.

User's local timezone: The scripts automatically detect your local timezone using tzlocal.

Examples

Example 1: Current time query

User: "What time is it in Perth?"

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

Example 2: Time conversion

User: "I have a meeting at 2pm New York time, what time is that in Perth?"

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

Example 3: Multiple timezone search

User: "What are the timezone codes for London, Tokyo, and Sydney?"

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

Time Format

  • All times use 24-hour format (HH:MM): 14:30 not 2:30 PM
  • ISO 8601 datetime format for output: 2025-11-07T14:30:45
  • IANA timezone names (e.g., America/New_York, not EST)

Troubleshooting

"Invalid timezone" error

  • Use IANA timezone names: America/New_York not EST or Eastern
  • Search with list_timezones.py if unsure
  • Check [data/commontimezones.json](data/commontimezones.json) for reference

"Invalid time format" error

  • Use 24-hour format: 14:30 not 2:30 PM
  • Format must be HH:MM with colon separator

Missing dependencies

Install required Python packages:

pip install tzlocal

Dependencies

  • Python 3.9+
  • tzlocal>=5.0 - for local timezone detection
  • zoneinfo - built-in Python 3.9+ (IANA timezone database)

Notes

  • Scripts automatically handle Daylight Saving Time (DST)
  • Local timezone is auto-detected from system
  • All timezone data uses IANA Time Zone Database
  • Perth, Australia timezone: Australia/Perth (UTC+8, no DST)