节假日API

节假日API接口，查询指定日期是否为节假日，查询下一个周末或法定节假日，查询下一个工作日，批量查询节假日信息，数据来源国务院节假日公告，每年更新一次

节假日API接口应用场景

1.  

   生成年度节假日表

   各类系统、网站最新节假日数据

   调用节假日API生成年度节假日表，供各类系统、网站等生成最新的年度节假日数据

2.  

   小程序、轻应用、小部件、云函数、各类终端智能假期提示

   丰富程序功能，提升用户体验

   通过节假日API接口，每日获取最新节假日提示，丰富程序功能，提升用户体验

3.  

   节假日、周末、调班、调休、工作日查询

   指定日期或时间段内节假日工作日信息

   查询指定日期或时间段内节假日、周末、调班、调休、工作日信息，规划业务时间周期、方案等

节假日API接口简介

每年的节假日数据都会不同，因为农历节日如春节、清明、中秋等是变动的，同时调休调班安排也会根据周末进行调整，月萌API提供人工及时维护的节假日API，方便各类系统快速有效集成。

节假日API接口支持2007年至2022年的法定节假日查询。

在使用节假日API接口时，可根据实际业务需求，将数据缓存到本地服务器使用或直接使用月萌API在线服务。如仅需要某段时间内节假日安排，可直接将数据缓存或入库至本地服务器；如需动态查询某日后的节假日、工作日等功能，则直接使用月萌API在线服务。

节假日数据源： 中国政府网 http://www.gov.cn/zhengce/xxgkzl.htm （注：搜索节假日即可）

节假日API接口功能列表

1. 1查询指定日期的节假日信息
2. 2查询指定日期区间段节假日信息
3. 3查询指定日期的下一个节假日（开始日期）
4. 4查询指定日期的下一个工作日（包含调班）
5. 5指定日期（默认今日）的节假日信息及供机器人播报的节假日信息文本语料
6. 6指定日期下一日（默认明日）的节假日信息及供机器人播报的节假日信息文本语料
7. 7下一个节假日信息及供机器人播报的节假日信息文本语料

功能说明请参见接口说明及API文档。

节假日API接口常见问题

我们的优势

节假日API接口功能

节假日API接口主要包含以下功能，若需更多功能可以在问题反馈区留言

1. 1查询指定日期的节假日信息
2. 2查询指定日期区间段节假日信息
3. 3查询指定日期的下一个节假日（开始日期）
4. 4查询指定日期的下一个工作日（包含调班）
5. 5指定日期（默认今日）的节假日信息及供机器人播报的节假日信息文本语料
6. 6指定日期下一日（默认明日）的节假日信息及供机器人播报的节假日信息文本语料
7. 7下一个节假日信息及供机器人播报的节假日信息文本语料

查询指定日期的节假日信息

参数均包含默认值，都不设置时表示查询今日的周末、节假日信息，且周末指周六和周日。

date参数可设置为2007年及以后的任意日期，无节假日信息时返回错误码MNA-100010，详见错误码参照

weekend参数作用：针对非周六周日双休的情况，有些公司实行单休如仅休周日，此时可以设置weekend为7，有些公司根据业务错峰休周末，如周二周三休假，可设置为2,3。

返回样例：（可通过在线调试工具查看返回样例，可直接下载demo运行查看）

				{
	"status": "success",
	"message": "",
	"time": 1641140610,
	"data": {
		"date": "2022-01-03",
		"type": 2,
		"offwork": true,
		"name": "元旦",
		"wage": 2,
		"descr": "元旦休假",
		"week": 1,
		"weekname": "周一"
	}
}
			

查询指定日期区间段节假日信息

start/end可以设置为2007年后任意日期区间，可以根据业务需求设置合理区间，无节假日信息时返回错误码MNA-100010，详见错误码参照。

weekend参数作用：针对非周六周日双休的情况，有些公司实行单休如仅休周日，此时可以设置weekend为7，有些公司根据业务错峰休周末，如周二周三休假，可设置为2,3。

返回样例：

				{
	"status": "success",
	"message": "",
	"time": 1641144545,
	"data": [{
		"date": "2022-01-03",
		"type": 2,
		"offwork": true,
		"name": "元旦",
		"wage": 2,
		"descr": "元旦休假",
		"week": 1,
		"weekname": "周一"
	}, {
		"date": "2022-01-04",
		"type": 0,
		"offwork": false,
		"name": "工作日",
		"wage": 1,
		"descr": "",
		"week": 2,
		"weekname": "周二"
	}, {
		"date": "2022-01-05",
		"type": 0,
		"offwork": false,
		"name": "工作日",
		"wage": 1,
		"descr": "",
		"week": 3,
		"weekname": "周三"
	}]
}
			

查询指定日期的下一个节假日

参见功能1查询指定日期的节假日信息，输入参数多一个下一个节假日是否包含周末，其它相同，返回值相同。

查询指定日期的下一个工作日

参见功能1查询指定日期的节假日信息。

指定日期的节假日信息及语料

date/weekend字段与前文相同

forcast指预报指定天数内（默认5天内）的放假信息（包含周末、节假日），仅作用于返回的chat文本语料中，进行节假日的智能预报。

语料包含如：

• 今天是国庆节，可以放松休息啦！
• 今天是国庆节，继续放假！
• 今天是国庆节，继续放假！明天要上班了哦~
• 今天是国庆节调班，辛苦了！
• 今天是工作日，加油！
• 明天就是国庆节啦！
• 后天就是国庆节啦！
• 还有三天就是国庆节啦！

语料包含很多种类似的形式，简洁且人性化。实现原理也比较简单，是通过“查询指定日期的下一个节假日”获取相关信息，解析后个性化制作提示信息，可以通过同样的方式编程进行自定义设置。

返回样例：

				{
	"status": "success",
	"message": "",
	"time": 1641195935,
	"data": {
		"info": {
			"date": "2021-12-30",
			"type": 0,
			"offwork": false,
			"name": "工作日",
			"wage": 1,
			"descr": "",
			"week": 4,
			"weekname": "周四"
		},
		"chat": "今天是工作日, 加油！后天就是元旦啦！"
	}
}
			

指定日期下一日的节假日信息及语料

与上一功能基本相同，只是“今天”会替换成“明天”。

怎么感觉和上面的功能重复了，我把指定日期设成“明天”不就行了？是的，没错，月萌API在处理接口时，为了保证接口的简单（参数少）易用（易理解不混淆），会尽可能地拆分功能，满足各类使用场景，即使这样会增加一些冗余性，根据实际业务场景忽略这些“多余”的功能就好啦。

下一个节假日信息及语料

语料格式：

• 下一个节假日是元旦(2022-01-01), 还有31天

返回示例：

				{
	"status": "success",
	"message": "",
	"time": 1641196776,
	"data": {
		"info": {
			"date": "2022-01-01",
			"type": 2,
			"offwork": true,
			"name": "元旦",
			"wage": 3,
			"descr": "元旦休假",
			"week": 6,
			"weekname": "周六"
		},
		"chat": "下一个节假日是元旦(2022-01-01), 还有31天"
	}
}