一、接口说明

本接口提供全球标准时区数据查询功能,支持以下操作:

  • 获取当前服务器时间
  • 转换指定时区时间
  • 查询时区缩写信息

📌 时区数据来源于 IANA Time Zone Database,每小时更新一次

二、请求方式

GET /api-docs/Time_Zone

三、响应示例

{
  "timezone": "Asia/Shanghai",
  "current_time": "2023-10-15T14:30:45+08:00",
  "utc_offset": "+08:00",
  "abbreviation": "CST",
  "example": "将 UTC+0 时间转换为 CST 需要加 8 小时"
}

四、支持的时区列表

时区代码 时区名称 UTC 偏移 夏令时规则
Europe/London 伦敦 UTC+0 ✅ 有
Asia/Tokyo 东京 UTC+9 ✅ 有
America/New_York 纽约 UTC-5 ✅ 有
Australia/Sydney 悉尼 UTC+11 ✅ 有
世界地图

五、使用建议

  1. 前端可结合 时区转换工具 实现动态时间显示
  2. 数据库建议缓存时区规则,减少重复请求
  3. 夏令时转换需注意日期范围有效性

六、注意事项

⚠️ 时区缩写可能因地区政策调整而变化,建议使用全称进行精确匹配
🔄 本服务器时间同步至 NTP 服务器 每日校准
🌍 时区数据更新后,旧版本缩写将保留兼容性支持

了解更多时区规则