时间与时区

API HUB

实用工具可直接调用免费

在线调试上游文档

调用地址

GET https://api.blueworkshop.top/api/v1/time

无需鉴权支持 CORS 每 IP 每分钟 120 次

在线调试

请求会发送到本站接口

当前请求：https://api.blueworkshop.top/api/v1/time

请求参数

参数	类型	默认值	说明
`tz`	string	`Asia/Shanghai`	IANA 时区名称，默认 Asia/Shanghai。示例：`Asia/Shanghai`
`format`	枚举：both / iso / unix	`both`	返回格式。示例：`both`

请求示例

cURL

curl "https://api.blueworkshop.top/api/v1/time?tz=Asia%2FShanghai&format=both"

JavaScript

const res = await fetch("https://api.blueworkshop.top/api/v1/time?tz=Asia%2FShanghai&format=both");
const data = await res.json();
console.log(data);

响应示例

{
  "ok": true,
  "data": {
    "timezone": "Asia/Shanghai",
    "iso": "2026-10-24T10:30:00.000+08:00",
    "local": "2026-10-24 10:30:00",
    "unix": 1792818600,
    "unixMs": 1792818600000,
    "offsetMinutes": 480
  },
  "meta": {
    "endpoint": "time",
    "cached": false
  }
}

成功时返回 JSON 信封：ok 表示是否成功，data 为数据，meta.cached 表示是否命中本站缓存。图片类接口直接返回二进制图片。

错误响应

HTTP	错误码	说明
400	`missing_param` / `invalid_param`	缺少参数或参数格式不正确，响应会带上出错参数名。
404	`not_found`	接口不存在，或上游没有找到对应资源。
405	`method_not_allowed`	请求方法与接口要求不一致。
429	`rate_limited`	请求过于频繁，响应头 Retry-After 给出建议等待秒数。
502	`upstream_error` / `upstream_rate_limited`	上游服务异常或触发限流。
504	`timeout`	上游请求超时。

接口说明

基于系统时间与 ICU 时区数据返回当前时间，无需任何外部服务。可用 tz 参数指定任意 IANA 时区，例如 Asia/Shanghai、America/New_York。

format 参数可控制返回格式：both 同时返回 ISO 与 Unix，iso 只返回 ISO 时间，unix 只返回时间戳。