日出日落 - 咕咕数据 API 文档

日出与日落时间
接口详情官网地址: https://www.gugudata.com/api/details/sunrisesunset

查询全球城市在指定日期的日出、日落、日光时长及其日变化、天文/航海/民用曙暮光、太阳正午和日地距离。原有入参与返回结构保持兼容。极昼、极夜等情况下，当日客观不存在的天文事件字段可能为空字符串。

请求方法: GET
接口路径: /weather/sunriseandsunset
调试地址: https://api.gugudata.com/weather/sunriseandsunset/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY

city (string, 必填): 查询城市名，支持全球城市，如北京、南京、伦敦等

date (string, 必填): 查询日期，格式为 yyyyMMdd，如 20260810

返回字段:

Data.City: 城市名称

Data.SunriseTime / SunsetTime: 当地日出、日落时间，格式为 HH:mm

Data.DaylightHours: 日光时长，格式为 HH:mm:ss

Data.DaylightHoursDiff: 相比前一日的变化，格式为 (+/-)HH:mm

Data.AstroTwilightStart / AstroTwilightEnd: 天文晨光开始、暮光结束时间

Data.NauticalTwilightStart / NauticalTwilightEnd: 航海晨光开始、暮光结束时间

Data.CivilTwilightStart / CivilTwilightEnd: 民用晨光开始、暮光结束时间

Data.SolarNoonTime: 当地太阳正午时间，格式为 HH:mm

Data.SolarNoonDistance: 当日地球与太阳距离，单位为百万公里

HTTP 200 仅表示请求到达接口；业务成功以 DataStatus.StatusCode=100 为准。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "city=南京&date=20260808",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-08-10 11:18:07.681",
    "DataTotalCount": 1
  },
  "Data": {
    "City": "南京",
    "SunriseTime": "05:24",
    "SunsetTime": "18:56",
    "DaylightHours": "13:31:44",
    "DaylightHoursDiff": "+00:00",
    "AstroTwilightStart": "03:53",
    "NauticalTwilightStart": "04:26",
    "CivilTwilightStart": "04:58",
    "AstroTwilightEnd": "20:26",
    "NauticalTwilightEnd": "19:53",
    "CivilTwilightEnd": "19:22",
    "SolarNoonTime": "12:10",
    "SolarNoonDistance": "151.681"
  }
}