[DEMO] 日出日落

日出与日落时间
接口详情官网地址: 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 为准。

当前接口契约

接口详情：https://www.gugudata.com/api/details/sunrisesunset

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

常见问题

城市和日期怎么填写？

city 填城市名，date 填 yyyyMMdd 格式的查询日期，例如 city=南京、date=20261110。查询不同城市时，每次传入一个城市名和一个日期。

返回时间是哪个时区？

日出、日落、曙暮光及正午时刻按查询城市的当地时间返回，并考虑当地时区与夏令时。跨城市比较时，请保留各城市所属时区。

白昼时长和白昼变化量如何读取？

DaylightHours 是当天的日光时长，格式为 hh:mm:ss。DaylightHoursDiff 表示与前一天的差，正号代表变长，负号代表变短。

需要民用、航海或天文曙暮光时看哪些字段？

民用曙暮光读取 CivilTwilightStart 和 CivilTwilightEnd，航海曙暮光读取 NauticalTwilightStart 和 NauticalTwilightEnd，天文曙暮光读取 AstroTwilightStart 和 AstroTwilightEnd。

返回响应

🟢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"
  }
}

当前接口契约#

常见问题#

城市和日期怎么填写？#

返回时间是哪个时区？#

白昼时长和白昼变化量如何读取？#

需要民用、航海或天文曙暮光时看哪些字段？#

请求参数