Get Time

This skill provides the current local time with automatic timezone detection or manual timezone specification.

Usage

Automatic Timezone Detection

The script attempts to auto-detect the user's timezone using IP geolocation:

python3 scripts/get_time.py [format]

Manual Timezone Specification

For more accurate results, especially in containerized environments, specify the timezone explicitly:

python3 scripts/get_time.py [format] [timezone]

Important: When you know the user's timezone from context or memory, always pass it explicitly for accuracy.

Available Formats

• full (default): Full datetime with day name and timezone (e.g., "Sunday, December 14, 2025 at 05:09:44 PM EST")
• time: Just the time in 12-hour format (e.g., "05:09:44 PM")
• date: Just the date (e.g., "2025-12-14")
• datetime: Date and time with timezone (e.g., "2025-12-14 05:09:44 PM EST")
• iso: ISO 8601 format (e.g., "2025-12-14T17:09:44-05:00")
• unix: Unix timestamp (e.g., "1734220184")

Common Timezones

• US Eastern: America/New_York
• US Pacific: America/Los_Angeles
• US Central: America/Chicago
• US Mountain: America/Denver
• UK: Europe/London
• Central Europe: Europe/Paris
• Japan: Asia/Tokyo
• Australia Eastern: Australia/Sydney

See IANA timezone database for full list.

Examples

# Auto-detect timezone (may be less accurate in containers)
python3 scripts/get_time.py

# Get time in US Eastern timezone
python3 scripts/get_time.py full America/New_York

# Get just the time in Pacific timezone
python3 scripts/get_time.py time America/Los_Angeles

# Get ISO format for logging in specific timezone
python3 scripts/get_time.py iso Europe/London

# Get Unix timestamp (timezone-independent)
python3 scripts/get_time.py unix

Best Practices

1. Use user's known location: If you have information about the user's location from conversation history or memory, convert it to a timezone and pass it explicitly
2. Common US locations:
   • New York, Boston, Washington DC → America/New_York
   • Los Angeles, San Francisco, Seattle → America/Los_Angeles
   • Chicago, Dallas → America/Chicago
   • Denver, Phoenix → America/Denver
3. Fallback: If timezone detection fails or no timezone is specified, the script falls back to UTC