Nager.DateNager.Date 公共节假日 API

GET/api/v4/Holidays/{countryCode}/Next

查询未来公共节假日

返回指定国家未来 365 天内的公共节假日；没有结果时上游返回 204。

查询支持国家、国家资料、年度或未来公共节假日、当天节假日状态与服务版本。完整 Community API v4 仅含六个只读 Endpoint；商业使用需要有效赞助。

请求

operationId: listUpcomingHolidays
服务器: https://nagerholidays.com
认证: 无

请求参数

`countryCode`

pathstring必填

ISO 3166-1 alpha-2 国家代码。

US

响应

`200`

PublicHolidayV4Dtoapplication/json

请求成功。

字段: countryCodedateholidayTypesnamenationalHolidaysubdivisionCodes

`204`

unknownapplication/json

请求成功。

{
  "countryCode": "US",
  "date": "2026-01-01",
  "holidayTypes": "Public",
  "name": "New Year's Day",
  "nationalHoliday": true,
  "subdivisionCodes": [
    "subdivisionCodes-example"
  ]
}