📖 API 接口说明

欢迎使用全球时间 API。本接口提供高可用的全球时区时间查询服务,支持多种时区格式偏移。

📍 接口地址

https://time.api.qnyunk.cn/
🔌 硬件开发者建议: 对于 ESP32ESP8266 等资源受限的单片机设备,建议优先使用 HTTP 协议请求,以减少 SSL 握手带来的内存开销和处理时间。

📋 请求参数

参数名 类型 必选 说明
type Integer YES 1: 只获取时间
2: 获取日期、时间及时间戳
utc String/Float NO 时区偏移。例如:+8, -5, +5:30, +9.5
默认:+8 (北京时间)
无参数 - NO 直接访问根目录将进入本 API 说明文档页面

✨ 响应格式

所有响应均以标准 JSON 格式返回。

1. 获取时间 (type=1)

示例请求:https://time.api.qnyunk.cn/?type=1&utc=+8

{ "time": "14:30:05", "timezone": "UTC+8" }

2. 获取完整日期时间 (type=2)

示例请求:https://time.api.qnyunk.cn/?type=2&utc=+8

{ "date": "2025-12-23", "time": "14:30:05", "timezone": "UTC+8", "timestamp": 1734954605 }