一、接口说明
本接口提供全球标准时区数据查询功能,支持以下操作:
- 获取当前服务器时间
- 转换指定时区时间
- 查询时区缩写信息
📌 时区数据来源于 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 | ✅ 有 |
五、使用建议
- 前端可结合 时区转换工具 实现动态时间显示
- 数据库建议缓存时区规则,减少重复请求
- 夏令时转换需注意日期范围有效性
六、注意事项
⚠️ 时区缩写可能因地区政策调整而变化,建议使用全称进行精确匹配
🔄 本服务器时间同步至 NTP 服务器 每日校准
🌍 时区数据更新后,旧版本缩写将保留兼容性支持