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