世界时间 API

简介

世界时间 API (World Time API) 是一种可以获取全球时区时间的 API，它返回的是 ISO 8601 格式的日期和时间。

通过调用世界时间 API，程序员可以快速获取到任意时区的当前时间，方便开发时统一时间标准。

API 请求

请求地址

API 请求的地址为：http://worldtimeapi.org/api/timezone/{Area}/{Location}

其中 {Area} 代表大洲（例如 Asia, Europe 等），{Location} 代表所在城市或地区（例如 Shanghai, New_York 等）。

示例：获取上海的当前时间，请求地址为 http://worldtimeapi.org/api/timezone/Asia/Shanghai

请求参数

该 API 不需要任何请求参数。

API 响应

响应格式

API 响应采用 JSON 格式。

响应示例：

{
  "abbreviation": "CST",
  "client_ip": "223.104.8.78",
  "datetime": "2022-11-03T02:31:34.356964+08:00",
  "day_of_week": 4,
  "day_of_year": 307,
  "dst": false,
  "dst_from": null,
  "dst_offset": 0,
  "dst_until": null,
  "raw_offset": 28800,
  "timezone": "Asia/Shanghai",
  "unixtime": 1667512294,
  "utc_datetime": "2022-11-02T18:31:34.356964+00:00",
  "utc_offset": "+08:00",
  "week_number": 44
}

响应字段

| 字段名 | 类型 | 描述 | | ------------ | ------ | -------------------------------------------------------- | | abbreviation | string | 时区缩写（例如 CST, EST 等） | | client_ip | string | 客户端 IP 地址 | | datetime | string | 当前时间，ISO 8601 格式（例如 2022-11-03T02:31:34+08:00） | | day_of_week | int | 星期几，1 代表周一，7 代表周日 | | day_of_year | int | 一年中的第几天 | | dst | bool | 是否处于夏令时(部分国家采用夏令时) | | dst_from | string | 夏令时生效时间 | | dst_offset | int | 夏令时偏移量 | | dst_until | string | 夏令时结束时间 | | raw_offset | int | 当前时区与 UTC 时区的秒数偏移量 | | timezone | string | 时区名称（例如 Asia/Shanghai, America/New_York 等） | | unixtime | int | 当前时间的 Unix 时间戳，单位为秒 | | utc_datetime | string | 当前时间的 UTC 时间，ISO 8601 格式（例如 2022-11-02T18:31:34+00:00） | | utc_offset | string | 当前时区与 UTC 时区的时差，格式为 ±HH:MM | | week_number | int | 当前年份中的第几周 |

示例代码

import requests

url = "http://worldtimeapi.org/api/timezone/Asia/Shanghai"
response = requests.get(url)
data = response.json()

print("当前时间：", data["datetime"])
print("时区：", data["timezone"])

const axios = require('axios');

const url = 'http://worldtimeapi.org/api/timezone/Asia/Shanghai';

axios.get(url)
  .then((response) => {
    const data = response.data;
    console.log('当前时间：', data.datetime);
    console.log('时区：', data.timezone);
  })
  .catch((error) => {
    console.log(error);
  });

参考链接

• 世界时间 API 官方文档