Data & analysis

Time Converter

Try it

Convert time between different timezones using IANA timezone database. Supports 12/24-hour formats, specific dates, and automatic DST handling.

What it does

Convert time between different timezones using IANA timezone database. Supports 12/24-hour formats, specific dates, and automatic DST handling.

The skill document

time-converter

Convert time between different timezones.

Usage Scenarios

Scenario 1: Cross-Timezone Meeting Time

User input: "纽约上午10点对应北京时间几点？"

Expected output: 2026-06-19 10:00 America/New_York = 2026-06-19 22:00 Asia/Shanghai. Offset: -04:00 (EDT) → +08:00 (CST). Difference: 12 hours ahead.

Scenario 2: Convert to UTC

User input: "伦敦下午2点半转成UTC时间。"

Expected output: 2026-06-19 14:30 Europe/London = 2026-06-19 13:30 UTC (BST active, UTC+1). Offset: +01:00 → +00:00.

Scenario 3: International Call Planning

User input: "东京晚上9点换算到洛杉矶时间。"

Expected output: 2026-06-19 21:00 Asia/Tokyo (JST) = 2026-06-19 05:00 America/Los_Angeles (PDT). Note: this is 5:00 AM same day in Los Angeles. Difference: 16 hours behind.

Scenario 4: 国内外团队会议时间配对

User input: "我上海的，美国那边同事在纽约，我们想每周开一次远程会议，对方说周三上午10点（EST），那是北京时间几点？" Expected output: 进行时区转换：纽约EST（冬令时UTC-5）→北京时间（UTC+8）时差13小时，EST周三上午10点即北京时间周三晚上23点。如果在美国夏令时（EDT，UTC-4），时差12小时，即周三晚上22点。自动识别当前是否夏令时。建议双方各让一步，选在双方都方便的折中时间（如北京时间上午9点=EST前一天晚8点/EDT晚9点）。

Description

A simple command-line tool to convert time from one timezone to another. Supports various time formats and displays the converted time with timezone offsets.

Installation

chmod +x ~/.openclaw/skills/time-converter/convert_time

Usage

convert_time --from  --to  --time  [--date ]

Arguments

  • --from: Source timezone (e.g., America/New_York, Asia/Shanghai, Europe/London)
  • --to: Target timezone (e.g., Asia/Tokyo, UTC, America/Los_Angeles)
  • --time: Time to convert (formats: HH:MM, HH:MM:SS, HH:MM AM/PM)
  • --date: Optional date for conversion (format: YYYY-MM-DD, default: today)

Examples

Basic conversion

convert_time --from "America/New_York" --to "Asia/Shanghai" --time "10:00"

Output:

2024-03-20 10:00:00 America/New_York
  =
2024-03-20 23:00:00 Asia/Shanghai

Offset: -04:00 → +08:00

With specific date

convert_time --from "Europe/London" --to "UTC" --time "14:30" --date "2024-12-25"

Using 12-hour format

convert_time --from "Asia/Tokyo" --to "America/Los_Angeles" --time "9:00 PM"

Common Timezones

  • UTC - Coordinated Universal Time
  • America/New_York - Eastern Time (US)
  • America/Los_Angeles - Pacific Time (US)
  • America/Chicago - Central Time (US)
  • Europe/London - London Time
  • Europe/Paris - Central European Time
  • Asia/Shanghai - China Standard Time
  • Asia/Tokyo - Japan Standard Time
  • Asia/Singapore - Singapore Time
  • Australia/Sydney - Australian Eastern Time

Notes

  • Uses Python's zoneinfo module (Python 3.9+)
  • Automatically handles daylight saving time transitions
  • Timezone names follow the IANA timezone database format

Related skills

World Clock Pro: Time & Timezone Converter

Answers time and timezone questions with live data from the worldclock.pro MCP server. Use when the user asks what time it is in a city or country, converts a time between zones (9am EST in Tokyo, UTC to local), schedules a meeting or call across time zones, asks when clocks change for daylight savi

datetime-convert

Convert any time representation — unix timestamps (s/ms/us/ns), ISO 8601/RFC 3339/RFC 2822, strftime, spreadsheet serials, IANA timezones, natural language ("3 days ago"/"下周一"), date arithmetic, durations. Use for bare epoch numbers, timezone/format conversion, 时间戳转北京时间, or a whole time column.

捷帮时区转换

时区转换工具，提供全球时区查询和时间转换功能。当用户提到时区转换、世界时钟、不同时区时间对比、时差计算、UTC转换、北京时间转纽约时间、时区查询、跨时区会议时间等需求时使用此技能。

3 installs

Epoch Time Convert

Convert between Unix epoch timestamps and human-readable datetimes, with timezone support and automatic unit detection (seconds/millis/micros/nanos). Use whe...

4 installs

datefmt-lite

Convert and format dates/times with zero external APIs — ISO 8601, Unix epoch, RFC 2822, and timezone conversion using only the local `date` binary and TZ database. Use when you need quick timestamp formatting, epoch conversion, duration arithmetic, or "what time is it in <city>" math without network calls.

2 installs

Currency Convert

Converts an amount from one currency to another using live exchange rates from Open Exchange Rates API. Runs a local Python script via exec for accurate, rea...

1 installs