节假日
最后更新于：2022-04-02 08:22:23
## 节假日
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 查询本年度节假日信息，接口返回假日名称、类型、对应农历、是否上班、调休，假期范围、假期提示、及工作日信息等。请求参数中mode可以指定是否返回每天有关的国内外节日信息。请注意字段daycode表示日期类型，为0表示工作日、为1节假日、为2双休日、为3调休日（上班），字段isnotwork表示是否需要上班，为0表示上班，为1表示休息。（数据来自国务院办公厅假日通知）
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/time/holiday
```
### 请求参数
| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| date | string | 是 | 日期，格式年-月-日 |
| mode | int | 否 | 工作模式，返回节日详情 |
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| date | string | 2019-10-01 | 当前阳历日期 |
| daycode | int | 1 | 日期类型，为0表示工作日、为1节假日、为2双休日、3为调休日（上班） |
| weekday | int | 2 | 星期（数字） |
| cnweekday | string | 星期二 | 星期（中文） |
| lunaryear | string | 己亥 | 农历年 |
| lunarmonth | string | 九月 | 农历月 |
| lunarday | string | 初三 | 农历日 |
| info | string | 节假日 | 日期信息 |
| start | int | 0 | 假期起点 |
| end | int | 6 | 假期结束 |
| holiday | string | 10月1日 | 节日日期 |
| name | string | 国庆节 | 节日名称（中文） |
| enname | string | National Day | 节日名称（英文） |
| isnotwork | int | 1 | 是否需要上班，0为工作日，1为休息日 |
| vacation | string | 2019-10-01~2019-10-07 | 假期范围 |
| tip | string | 10月1日至7日放假调休，共7天...... | 放假提示 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->timeHoliday()
->withDate('2020-01-24')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功",
"data": [
{
"date":"2020-01-24",
"daycode":1,
"weekday":5,
"cnweekday":"星期五",
"lunaryear":"己亥",
"lunarmonth":"腊月",
"lunarday":"三十",
"info":"节假日",
"start":0,
"end":6,
"holiday":"十二月三十",
"name":"除夕",
"enname":"NewYear’s Eve",
"isnotwork":1,
"vacation":"2020-01-24~2020-01-30",
"tip":"1月24日至30日放假调休，共7天。1月19日(周日)、2月1日(周六)上班。"
}
]
}
~~~
';