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#

bash

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

Usage#

bash

convert_time --from <source_timezone> --to <target_timezone> --time <time> [--date <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#

bash

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

Output:

text

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#

bash

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

Using 12-hour format#

bash

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