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