Nager.DateNager.Date 公共节假日 API

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

查询年度公共节假日

返回指定国家和年份的公共节假日，包括名称、适用范围、行政区和节假日类型。

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

请求

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

请求参数

`countryCode`

pathstring必填

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

US

`year`

pathintegerint32必填

要查询公共节假日的公历年份。

响应

`200`

PublicHolidayV4Dtoapplication/json

请求成功。

字段: countryCodedateholidayTypesnamenationalHolidaysubdivisionCodes

`400`

ProblemDetailsapplication/json

请求参数无效。

字段: detailinstancestatustitletype

`404`

ProblemDetailsapplication/json

未找到指定国家或资源。

字段: detailinstancestatustitletype

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