## 节假日 >[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日(周六)上班。" } ] } ~~~