| name | world_clock |
| description | Get current time in any timezone and convert times between locations. Use when user asks about time in different cities, timezone conversions, or scheduling across timezones. |
| version | 1.0.0 |
| author | Workshop Team |
World Clock Skill
Get the current time anywhere in the world and convert times between timezones. Useful for scheduling across timezones, checking times in other cities, and handling daylight saving time.
When to Use
- User asks "What time is it in [city]?"
- User needs to convert time between timezones
- User is scheduling a meeting across timezones
- User asks about daylight saving time
- User asks when business hours start/end in another timezone
Available Operations
- Current Time: Get the current time in any timezone
- Time Conversion: Convert a specific time from one timezone to another
- DST Information: Check if a location is currently in daylight saving time
- Multiple Timezones: Show current time in several locations at once
Instructions
When a user asks about time or timezones:
Step 1: Identify the Request Type
- Current time query: "What time is it in Tokyo?"
- Conversion query: "If it's 3pm in New York, what time is it in London?"
- Scheduling query: "When should I schedule a call for 9am PST for someone in Berlin?"
Step 2: Get Timezone Identifier
Use the WorldTimeAPI with the appropriate timezone identifier.
API Endpoint:
https://worldtimeapi.org/api/timezone/{Area}/{Location}
Step 3: Make the API Call
Example - Get Tokyo time:
https://worldtimeapi.org/api/timezone/Asia/Tokyo
Example - Get New York time:
https://worldtimeapi.org/api/timezone/America/New_York
Step 4: Present Results
Format clearly with:
- Current local time (12-hour and 24-hour format)
- Day of the week and date
- Timezone abbreviation (PST, EST, JST, etc.)
- UTC offset
- Whether DST is active
Common Timezone Identifiers
Americas
| City | Timezone ID |
|---|
| New York | America/New_York |
| Los Angeles | America/Los_Angeles |
| Chicago | America/Chicago |
| Denver | America/Denver |
| Toronto | America/Toronto |
| Vancouver | America/Vancouver |
| Mexico City | America/Mexico_City |
| Sao Paulo | America/Sao_Paulo |
| Buenos Aires | America/Argentina/Buenos_Aires |
Europe
| City | Timezone ID |
|---|
| London | Europe/London |
| Paris | Europe/Paris |
| Berlin | Europe/Berlin |
| Amsterdam | Europe/Amsterdam |
| Rome | Europe/Rome |
| Madrid | Europe/Madrid |
| Moscow | Europe/Moscow |
| Istanbul | Europe/Istanbul |
| Dublin | Europe/Dublin |
Asia & Pacific
| City | Timezone ID |
|---|
| Tokyo | Asia/Tokyo |
| Singapore | Asia/Singapore |
| Hong Kong | Asia/Hong_Kong |
| Shanghai | Asia/Shanghai |
| Beijing | Asia/Shanghai |
| Seoul | Asia/Seoul |
| Mumbai | Asia/Kolkata |
| Delhi | Asia/Kolkata |
| Dubai | Asia/Dubai |
| Sydney | Australia/Sydney |
| Melbourne | Australia/Melbourne |
| Auckland | Pacific/Auckland |
Africa & Middle East
| City | Timezone ID |
|---|
| Cairo | Africa/Cairo |
| Johannesburg | Africa/Johannesburg |
| Lagos | Africa/Lagos |
| Tel Aviv | Asia/Jerusalem |
| Riyadh | Asia/Riyadh |
Timezone Abbreviations Reference
| Abbreviation | Full Name | UTC Offset |
|---|
| PST | Pacific Standard Time | UTC-8 |
| PDT | Pacific Daylight Time | UTC-7 |
| MST | Mountain Standard Time | UTC-7 |
| MDT | Mountain Daylight Time | UTC-6 |
| CST | Central Standard Time | UTC-6 |
| CDT | Central Daylight Time | UTC-5 |
| EST | Eastern Standard Time | UTC-5 |
| EDT | Eastern Daylight Time | UTC-4 |
| GMT | Greenwich Mean Time | UTC+0 |
| BST | British Summer Time | UTC+1 |
| CET | Central European Time | UTC+1 |
| CEST | Central European Summer Time | UTC+2 |
| IST | India Standard Time | UTC+5:30 |
| JST | Japan Standard Time | UTC+9 |
| AEST | Australian Eastern Standard Time | UTC+10 |
| AEDT | Australian Eastern Daylight Time | UTC+11 |
API Response Format
The WorldTimeAPI returns:
{
"abbreviation": "EST",
"datetime": "2024-01-15T14:30:00.123456-05:00",
"day_of_week": 1,
"day_of_year": 15,
"dst": false,
"dst_offset": 0,
"timezone": "America/New_York",
"unixtime": 1705343400,
"utc_datetime": "2024-01-15T19:30:00.123456+00:00",
"utc_offset": "-05:00",
"week_number": 3
}
Key fields:
datetime: Current local time with offsetabbreviation: Timezone abbreviation (EST, PST, etc.)utc_offset: Offset from UTCdst: Whether daylight saving time is activeday_of_week: 0=Sunday, 1=Monday, etc.
Examples
Example 1: Current Time Query
User asks: "What time is it in Tokyo?"
- Call:
https://worldtimeapi.org/api/timezone/Asia/Tokyo
- Response format:
"It's currently 10:30 PM JST (Japan Standard Time) in Tokyo.
That's Monday, January 15, 2024.
UTC offset: +09:00"
Example 2: Time Conversion
User asks: "If I schedule a call for 3pm Eastern, what time is that in London?"
- Get current UTC offset for both timezones
- Calculate: Eastern (EST) is UTC-5, London (GMT) is UTC+0
- Difference: 5 hours ahead
- Response: "3:00 PM Eastern = 8:00 PM GMT in London"
Example 3: Multi-Timezone Display
User asks: "Show me the time in New York, London, and Tokyo"
- Call all three timezone endpoints
- Present in a table format:
| City | Local Time | Date |
|---|
| New York | 2:30 PM EST | Mon, Jan 15 |
| London | 7:30 PM GMT | Mon, Jan 15 |
| Tokyo | 4:30 AM JST | Tue, Jan 16 |
Example 4: Meeting Scheduling
User asks: "I need to find a time that works for LA, New York, and Berlin"
- Get current times for all three
- Note offsets: LA (PST -8), NY (EST -5), Berlin (CET +1)
- Find overlap during business hours (9am-6pm local)
- Suggest: "9:00 AM Pacific = 12:00 PM Eastern = 6:00 PM Berlin"
Handling Edge Cases
City Not in List
If user mentions a city not in the common list:
- Try to find the nearest major city in the same timezone
- Or search for the country's timezone
- Note any uncertainty in the response
Daylight Saving Time
DST changes dates vary by country:
- US/Canada: 2nd Sunday March, 1st Sunday November
- Europe: Last Sunday March, Last Sunday October
- Australia: 1st Sunday October, 1st Sunday April (opposite hemisphere)
- Japan, China, India: No DST
Always check the dst field in the API response.
Date Line Crossing
When converting across the International Date Line, the date may change:
- Tokyo is 14 hours ahead of Los Angeles
- Monday 10pm in LA = Tuesday 12pm in Tokyo
Notes
- WorldTimeAPI is completely free with no API key required
- Rate limit: 1 request per second
- Times are accurate to the second
- API automatically handles DST transitions
- For offline use, basic conversions can be done with UTC offset math
