1、节假日万年历API接口,免费好用

1、前言

节假日万年历接口,这个是RollToolsApi通用系列接口的其中一个,内部包含了7个小接口,能实现查询指定日期/月份/年份/时间范围的节假日和万年历信息,万年历的信息包含农历信息,宜忌等信息。这个接口的主要特点是,返回某个节日是否是工作日,节日和节假日,其准确度和国务院每年的通知完全匹配。

RollToolsApi通用系列接口包含多很多免费通用的API接口,利用这些接口可以帮你实现去开发出很多功能丰富,服务稳定的小程序,APP或者网页,无论是练手还是实战都是不错的选择。所有接口的列表可以在此查看 https://www.mxnzp.com/doc/list

2、接口明细

注意:app_id和app_secret是临时秘钥,如果真正使用,需要去https://www.mxnzp.com申请属于自己的专属秘钥。

2.1 获取指定日期的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday/single/{date}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/single/20181121?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定日期的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": {
            "date": "2018-11-21",
            "weekDay": 3,
            "yearTips": "戊戌",
            "type": 0,
            "typeDes": "工作日",
            "chineseZodiac": "狗",
            "solarTerms": "立冬后",
            "avoid": "嫁娶.安葬",
            "lunarCalendar": "十月十四",
            "suit": "破屋.坏垣.祭祀.余事勿取",
            "dayOfYear": 325,
            "weekOfYear": 47,
            "constellation": "天蝎座",
            "indexWorkDayOfMonth": 1
        }
    }
    

2.2 获取指定多个日期的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday/multi/{dates}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/multi/20180101,20181010,20181011?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定多个日期的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": [
            {
                "date": "2018-01-01",
                "weekDay": 1,
                "yearTips": "丁酉",
                "type": 2,
                "chineseZodiac": "鸡",
                "solarTerms": "冬至后",
                "avoid": "出行.安葬.修坟.开市",
                "lunarCalendar": "11-15",
                "typeDes" : "元旦",
                "suit": "祭祀.塑绘.开光.裁衣.冠笄.嫁娶.纳采.拆卸.修造.动土.竖柱.上梁.安床.移徙.入宅.安香.结网.捕捉.畋猎.伐木.进人口.放水",
                "dayOfYear": 1,
                "weekOfYear": 1,
                "constellation": "天蝎座",
                "indexWorkDayOfMonth": 1
            },
            ...这个地方只显示了一条
        ]
    }
    

2.3 获取指定月份的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday/list/month/{date}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/list/month/201802?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定月份的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": [
            {
                "date": "2018-02-01",
                "weekDay": 4,
                "yearTips": "丁酉",
                "type": 0,
                "chineseZodiac": "鸡",
                "typeDes" : "工作日",
                "solarTerms": "大寒后",
                "avoid": "开仓.嫁娶.移徙.入宅",
                "lunarCalendar": "12-16",
                "suit": "祭祀.沐浴.祈福.斋醮.订盟.纳采.裁衣.拆卸.起基.竖柱.上梁.安床.入殓.除服.成服.移柩.启攒.挂匾.求嗣.出行.合帐.造畜椆栖",
                "dayOfYear": 32,
                "weekOfYear": 5,
                "constellation": "天蝎座",
                "indexWorkDayOfMonth": 1
            },
            ...只显示了一部分数据
        ]
    }
    

2.4 获取指定月份的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday/list/month/{date}/{type}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/list/month/201810/rest?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定月份的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": [
            {
                "month": 10,
                "year": 2018,
                "days": [
                    {
                        "date": "2018-10-13",
                        "weekDay": 6,
                        "yearTips": "戊戌",
                        "type": 1,
                        "typeDes": "休息日",
                        "chineseZodiac": "狗",
                        "solarTerms": "寒露后",
                        "avoid": "开市.交易.祭祀.入宅.安葬",
                        "lunarCalendar": "九月初五",
                        "suit": "捕捉.畋猎.余事勿取",
                        "dayOfYear": 286,
                        "weekOfYear": 41,
                        "constellation": "天蝎座",
                        "indexWorkDayOfMonth": 1
                    },
                    ...中间隐藏了一部分的数据...
                ]
            }
        ]
    }
    

2.5 获取指定年份的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday//list/year/{date}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/list/year/2018?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定年份的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": [
            {
                "month": 1,
                "year": 2018,
                "days": [
                    {
                        "date": "2018-01-01",
                        "weekDay": 1,
                        "yearTips": "丁酉",
                        "type": 2,
                        "chineseZodiac": "鸡",
                        "solarTerms": "冬至后",
                        "typeDes" : "元旦",
                        "avoid": "出行.安葬.修坟.开市",
                        "lunarCalendar": "11-15",
                        "suit": "祭祀.塑绘.开光.裁衣.冠笄.嫁娶.纳采.拆卸.修造.动土.竖柱.上梁.安床.移徙.入宅.安香.结网.捕捉.畋猎.伐木.进人口.放水",
                        "dayOfYear": 1,
                        "weekOfYear": 1,
                        "constellation": "天蝎座",
                        "indexWorkDayOfMonth": 1
                    },
                    ...中间隐藏了"2018-01-02"~"2018-01-30"的数据
                ]
            },
            ...中间隐藏了02月到11月的数据
        ]
    }
    

2.6 获取指定月份的节假日及万年历信息

  • 接口地址: https://www.mxnzp.com/api/holiday/list/year/{date}/{type}

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/list/year/2018/rest?ignoreHoliday=false&app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取指定月份的节假日及万年历信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功,域名已经成功备案,为了更优雅的调用,不久后将废弃8091端口,请尽快使用新域名直接调用,多有不便敬请谅解",
        "data": [
            {
                "month": 1,
                "year": 2018,
                "days": [
                    {
                        "date": "2018-01-06",
                        "weekDay": 6,
                        "yearTips": "丁酉",
                        "type": 1,
                        "typeDes": "休息日",
                        "chineseZodiac": "鸡",
                        "solarTerms": "小寒后",
                        "avoid": "嫁娶.开市.入宅.安床.破土.安葬",
                        "lunarCalendar": "冬月廿",
                        "suit": "祭祀.斋醮.纳财.捕捉.畋猎",
                        "dayOfYear": 6,
                        "weekOfYear": 1,
                        "constellation": "天蝎座",
                        "indexWorkDayOfMonth": 1
                    },
                    ...中间还有一些数据没有显示...
                ]
            },
            ...中间有2月到11月的数据没有展示...
        ]
    }
    

2.7 获取最近前后七个节日信息

  • 接口地址: https://www.mxnzp.com/api/holiday/recent/list

  • 返回格式: JSON

  • 请求方式: GET

  • 请求示例: https://www.mxnzp.com/api/holiday/recent/list?app_id=ixssxqertpltndez&app_secret=QUF5S2JLZkNqSHdyeVVLczdCNSt1QT09

  • 接口备注: 获取最近前后七个节日信息

  • 返回示例:

    {
        "code": 1,
        "msg": "数据返回成功",
        "data": [
            {
                "date": "2019年07月07日",
                "lunarDate": "2019年06月05日",
                "holidayName": "国际合作节",
                "residueDays": -34,
                "lunarHoliday": false
            },
            ...这里只显示了一条
        ]
    }
    
  • 6
    点赞
  • 38
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
以下是使用C语言结构体表示万年历节假日的示例代码: ```c #include <stdio.h> #include <stdlib.h> #include <string.h> // 定义结构体表示节假日 struct Holiday { int month; // 月份 int day; // 日期 char name[20]; // 节假日名称 }; // 定义结构体表示某一天的信息 struct Day { int year; // 年份 int month; // 月份 int day; // 日期 int week; // 星期几 struct Holiday holiday; // 节假日信息 }; // 定义结构体表示某一月的信息 struct Month { int year; // 年份 int month; // 月份 int days; // 该月天数 struct Day days_info[42]; // 该月每一天的信息 }; // 定义结构体表示某一年的信息 struct Year { int year; // 年份 struct Month months[12]; // 该年每个月的信息 }; // 初始化节假日信息 void init_holiday(struct Holiday *holiday, int month, int day, char *name) { holiday->month = month; holiday->day = day; strcpy(holiday->name, name); } // 初始化某一天的信息 void init_day(struct Day *day, int year, int month, int day_num, int week, struct Holiday holiday) { day->year = year; day->month = month; day->day = day_num; day->week = week; day->holiday = holiday; } // 初始化某一月的信息 void init_month(struct Month *month, int year, int month_num, int days, struct Day *days_info) { month->year = year; month->month = month_num; month->days = days; memcpy(month->days_info, days_info, sizeof(struct Day) * 42); } // 初始化某一年的信息 void init_year(struct Year *year, int year_num, struct Month *months) { year->year = year_num; memcpy(year->months, months, sizeof(struct Month) * 12); } int main() { // 初始化节假日信息 struct Holiday new_year_day, spring_festival, tomb_sweeping_day; init_holiday(&new_year_day, 1, 1, "元旦"); init_holiday(&spring_festival, 1, 1, "春节"); init_holiday(&tomb_sweeping_day, 4, 4, "清明节"); // 初始化某一月的信息 struct Day days_info[42]; init_day(&days_info[0], 2022, 1, 1, 5, new_year_day); init_day(&days_info[1], 2022, 1, 2, 6, new_year_day); // ...省略其他日期的初始化 struct Month january; init_month(&january, 2022, 1, 31, days_info); // 初始化某一年的信息 struct Month months[12] = {january, /* ...省略其他月份的初始化 */}; struct Year year; init_year(&year, 2022, months); // 输出2022年1月1日的节假日名称 printf("%s\n", year.months[0].days_info[0].holiday.name); return 0; } ```

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值