POST AI agent ready /v1/timezone/convert

时区转换器 API - 免费时间转换

将日期时间从一个 IANA 时区转换为另一时区。返回格式化的日期时间和偏移差。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/timezone/convert \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-03-24T10:30:00","from":"America/New_York","to":"Asia/Tokyo"}'

When to use this API

协调全球团队的会议

当用户选择本地时区的会议时间时，将其转换为每个与会者的时区，并在他们的姓名旁边显示本地时间。如果任何参与者的会议时间在上午 8 点至晚上 8 点之外，则显示警告。

标准化统一日历的事件时间戳

从存储不同时区时间的不同服务导入日历事件。在将每个事件呈现在单个日历视图上之前，将其转换为用户的本地时区，以确保正确的时间顺序。

计算办公室之间的营业时间重叠

对于在纽约、伦敦和新加坡设有办事处的分布式公司，将每个办事处时区的上午 9 点至下午 5 点转换为通用参考。显示所有三个办公室均在线的重叠窗口。

Frequently asked questions

转换是否处理夏令时转换？

是的。转换考虑了源时区和目标时区的 DST 规则。如果源时间在 DST 转换期间下降，则响应会反映正确的偏移量。

我应该为时间参数使用什么日期时间格式？

使用 ISO 8601 格式：YYYY-MM-DDTHH:mm:ss。不要在字符串中包含时区偏移量； “from”参数指定源时区。

什么是offset_diff？

offset_diff 是源时区和目标时区之间的小时和分钟差异。例如，+13:00 表示目标时区比源时区早 13 小时。

我可以与 UTC 进行转换吗？

是的。使用“UTC”作为 from 或 to 参数。这对于以 UTC 格式存储时间戳并以用户的本地时区显示它们非常有用。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.