⚡ API 接口文档

仓鼠时间网提供免费的时间数据 API，可供开发者在应用中集成世界时间查询功能。

🌐 获取当前时间

GET /api/time?tz={时区}
参数：tz (可选，默认 Asia/Shanghai)

示例：
/api/time?tz=America/New_York

{
  "timezone": "America/New_York",
  "date": "2026/07/28",
  "weekday": "星期二",
  "time": "09:30:00",
  "hour": "09",
  "minute": "30",
  "second": "00",
  "timestamp": 1785243000000,
  "isDST": true,
  "dstText": "正在实行夏令时",
  "nextFestival": { "name": "元旦", "days": 5 },
  "sunTimes": { "sunrise": "06:45", "sunset": "19:30", "dayLength": "765 分钟" }
}

🔍 搜索城市

GET /api/cities?q={关键词}
参数：q (必填，支持中文/拼音首字母)

示例：
/api/cities?q=bj （拼音首字母匹配）
/api/cities?q=北京（中文匹配）

🔄 时差转换

GET /api/convert?from={时区1}&to={时区2}
参数：from (必填), to (必填)

示例：
/api/convert?from=Asia/Shanghai&to=America/New_York

💡 使用说明

所有 API 目前免费使用，无需 API Key
请合理控制调用频率，建议不超过 10 次/秒
数据缓存 800ms，重复请求不会重复计算
时区参数使用 IANA 时区格式（如 Asia/Shanghai）
需要更多帮助？查看时钟挂件