POST AI agent ready /v1/timezone

时区 API - 免费当前时间查找

返回给定 IANA 时区的当前时间、UTC 偏移量、缩写和 DST 状态。如果未指定时区，则默认为 UTC。

Endpoint

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

为团队仪表板构建多时区时钟小部件。为每个团队成员的时区（例如美国/纽约、欧洲/柏林、亚洲/东京）调用此端点，并在他们的名字旁边呈现当前当地时间。

在发送推送通知或电子邮件之前，请检查收件人的时区，确认其处于当地时间上午 9 点到下午 6 点之间。将交付延迟到下一个业务窗口，以提高打开率并避免非工作时间中断。

该端点接受什么时区格式？

它接受 IANA 时区标识符，例如 America/New_York、Europe/London 或 Asia/Tokyo。完整列表保存在 iana.org/time-zones 上。

响应是否考虑了夏令时？

是的。 is_dst 字段指示 DST 是否处于活动状态，utc_offset 反映当前偏移量（包括任何 DST 调整）。

如果我通过了无效的时区，会发生什么情况？

端点返回 400 错误，并显示一条消息，解释无法识别时区标识符。

我可以用它来获取当前的 UTC 时间吗？

是的。忽略时区参数（默认为 UTC）或显式传递“UTC”以获取当前协调世界时。

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