World Time API logo

World Time API

World Time API

World Time API 是免费的时区和当前时间 API:按时区、IP、城市名查询当前 UTC、本地时间、DST 状态、UTC offset。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

完全免费,无需 API key

先注意什么

没有 SLA(社区项目,偶尔会挂)

第一步先查

GET http://worldtimeapi.org/api/timezone/Asia/Shanghai 拿上海时间;GET /ip 用调用者 IP 自动判定。

认证
CORS
不支持
HTTPS
注册
?
协议
REST
计费

可用率 · 30 天窗口

巡检: 1可用率: 0%
01

关于这个 API

World Time API 是一个由开发者社区维护的免费时间 API,最大特点是「真的免费、真的简单」——不要注册、不要 API key、文档一页。最常用场景是「我有用户的 IP 或时区字符串,想知道他们现在几点」。返回 JSON 里包含 UTC 时间、本地时间、UTC offset、是否 DST、未来 DST 切换时间等丰富字段。也常被开发者拿来「确认服务器和 NTP 同步是否正确」(对比自己 server 时间和 API 返回时间)。劣势:作为社区项目没有 SLA 保证,偶尔会挂或 latency 高。生产环境关键场景建议自己用 PostgreSQL CURRENT_TIMESTAMP 或装 NTP 服务,把 World Time API 作为辅助。

02

你可以做什么

  • 1App 内显示用户本地时间
  • 2DST 切换时验证时区
  • 3会议安排自动转换时区
  • 4CI/CD 调度跨时区任务
03

优劣对比

优点

  • 完全免费,无需 API key
  • 响应简洁(一个 JSON 就够)
  • 支持 IP 自动定位时区

注意事项

  • 没有 SLA(社区项目,偶尔会挂)
  • 历史时间查询不支持(只给当前时刻)
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://worldtimeapi.org/<endpoint>
05

快速开始

GET http://worldtimeapi.org/api/timezone/Asia/Shanghai 拿上海时间;GET /ip 用调用者 IP 自动判定。

06

常见问题

免费会限速吗?+

没明确限速,但合理使用(每个 IP 每秒 < 5 次)才不会被屏蔽。

能返回历史某天的时间吗?+

不能。这是 "current time" API。历史时区查询用 Time Zone Database (tzdb) 本地查。

07

技术细节

CORS: NoHTTPS: Yes注册: ?开源: No
认证方式
unknown
计费
unknown
协议
REST
SDK
python, javascript, go, java, php
上次巡检
2026/5/12 07:38:40
08

标签