日历-按月
一次请求获取指定月份每一天的完整日历数据,包含农历、公历、星期等基础信息。
明确标识国家法定节假日、调休工作日及周末,方便前端直接渲染日历的休假状态。
包含二十四节气(如立春、清明)交节时间及传统节日(如春节、中秋)、国际节日。
提供每日的简要宜忌信息,适合在月视图中进行概要展示,引导用户查看详情。
将分散的每日数据聚合成月度包,减少网络请求次数,提升加载速度。
统一的 JSON 数组格式,与前端常用的日历组件(如 FullCalendar)数据结构易于适配。
支持查询历史年份及未来年份的月度日历,时间跨度大。
利用节假日和工作日数据,自动生成企业的月度考勤排班表。
为各类 APP 的日期选择器或日历挂件提供底层的月视图数据支持。
帮助用户在月视图中快速识别假期和吉日,规划长期的旅行或商务行程。
| 名称 | 值 |
|---|
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| month | 是 | string | Month (yyyy-MM), defaults to current month |
| 名称 | 类型 | 说明 | 示例值 |
|---|---|---|---|
| year | integer | 年份 | |
| month | integer | 月份 | |
| days | array | 每日详情列表 |
{
"code": 200,
"data": {
"days": [
{
"date": "2025-05-01",
"day": 1,
"gan_zhi": "乙巳年 庚辰月 庚午日",
"lunar": "二〇二五年四月初四",
"lunar_day": "初四",
"term": "",
"week_day": 4
},
{
"date": "2025-05-02",
"day": 2,
"gan_zhi": "乙巳年 庚辰月 辛未日",
"lunar": "二〇二五年四月初五",
"lunar_day": "初五",
"term": "",
"week_day": 5
},
{
"date": "2025-05-03",
"day": 3,
"gan_zhi": "乙巳年 庚辰月 壬申日",
"lunar": "二〇二五年四月初六",
"lunar_day": "初六",
"term": "",
"week_day": 6
},
{
"date": "2025-05-04",
"day": 4,
"gan_zhi": "乙巳年 庚辰月 癸酉日",
"lunar": "二〇二五年四月初七",
"lunar_day": "初七",
"term": "",
"week_day": 0
},
{
"date": "2025-05-05",
"day": 5,
"gan_zhi": "乙巳年 辛巳月 甲戌日",
"lunar": "二〇二五年四月初八",
"lunar_day": "初八",
"term": "立夏",
"week_day": 1
},
{
"date": "2025-05-06",
"day": 6,
"gan_zhi": "乙巳年 辛巳月 乙亥日",
"lunar": "二〇二五年四月初九",
"lunar_day": "初九",
"term": "",
"week_day": 2
},
{
"date": "2025-05-07",
"day": 7,
"gan_zhi": "乙巳年 辛巳月 丙子日",
"lunar": "二〇二五年四月初十",
"lunar_day": "初十",
"term": "",
"week_day": 3
},
{
"date": "2025-05-08",
"day": 8,
"gan_zhi": "乙巳年 辛巳月 丁丑日",
"lunar": "二〇二五年四月十一",
"lunar_day": "十一",
"term": "",
"week_day": 4
},
{
"date": "2025-05-09",
"day": 9,
"gan_zhi": "乙巳年 辛巳月 戊寅日",
"lunar": "二〇二五年四月十二",
"lunar_day": "十二",
"term": "",
"week_day": 5
},
{
"date": "2025-05-10",
"day": 10,
"gan_zhi": "乙巳年 辛巳月 己卯日",
"lunar": "二〇二五年四月十三",
"lunar_day": "十三",
"term": "",
"week_day": 6
},
{
"date": "2025-05-11",
"day": 11,
"gan_zhi": "乙巳年 辛巳月 庚辰日",
"lunar": "二〇二五年四月十四",
"lunar_day": "十四",
"term": "",
"week_day": 0
},
{
"date": "2025-05-12",
"day": 12,
"gan_zhi": "乙巳年 辛巳月 辛巳日",
"lunar": "二〇二五年四月十五",
"lunar_day": "十五",
"term": "",
"week_day": 1
},
{
"date": "2025-05-13",
"day": 13,
"gan_zhi": "乙巳年 辛巳月 壬午日",
"lunar": "二〇二五年四月十六",
"lunar_day": "十六",
"term": "",
"week_day": 2
},
{
"date": "2025-05-14",
"day": 14,
"gan_zhi": "乙巳年 辛巳月 癸未日",
"lunar": "二〇二五年四月十七",
"lunar_day": "十七",
"term": "",
"week_day": 3
},
{
"date": "2025-05-15",
"day": 15,
"gan_zhi": "乙巳年 辛巳月 甲申日",
"lunar": "二〇二五年四月十八",
"lunar_day": "十八",
"term": "",
"week_day": 4
},
{
"date": "2025-05-16",
"day": 16,
"gan_zhi": "乙巳年 辛巳月 乙酉日",
"lunar": "二〇二五年四月十九",
"lunar_day": "十九",
"term": "",
"week_day": 5
},
{
"date": "2025-05-17",
"day": 17,
"gan_zhi": "乙巳年 辛巳月 丙戌日",
"lunar": "二〇二五年四月二十",
"lunar_day": "二十",
"term": "",
"week_day": 6
},
{
"date": "2025-05-18",
"day": 18,
"gan_zhi": "乙巳年 辛巳月 丁亥日",
"lunar": "二〇二五年四月廿一",
"lunar_day": "廿一",
"term": "",
"week_day": 0
},
{
"date": "2025-05-19",
"day": 19,
"gan_zhi": "乙巳年 辛巳月 戊子日",
"lunar": "二〇二五年四月廿二",
"lunar_day": "廿二",
"term": "",
"week_day": 1
},
{
"date": "2025-05-20",
"day": 20,
"gan_zhi": "乙巳年 辛巳月 己丑日",
"lunar": "二〇二五年四月廿三",
"lunar_day": "廿三",
"term": "",
"week_day": 2
},
{
"date": "2025-05-21",
"day": 21,
"gan_zhi": "乙巳年 辛巳月 庚寅日",
"lunar": "二〇二五年四月廿四",
"lunar_day": "廿四",
"term": "小满",
"week_day": 3
},
{
"date": "2025-05-22",
"day": 22,
"gan_zhi": "乙巳年 辛巳月 辛卯日",
"lunar": "二〇二五年四月廿五",
"lunar_day": "廿五",
"term": "",
"week_day": 4
},
{
"date": "2025-05-23",
"day": 23,
"gan_zhi": "乙巳年 辛巳月 壬辰日",
"lunar": "二〇二五年四月廿六",
"lunar_day": "廿六",
"term": "",
"week_day": 5
},
{
"date": "2025-05-24",
"day": 24,
"gan_zhi": "乙巳年 辛巳月 癸巳日",
"lunar": "二〇二五年四月廿七",
"lunar_day": "廿七",
"term": "",
"week_day": 6
},
{
"date": "2025-05-25",
"day": 25,
"gan_zhi": "乙巳年 辛巳月 甲午日",
"lunar": "二〇二五年四月廿八",
"lunar_day": "廿八",
"term": "",
"week_day": 0
},
{
"date": "2025-05-26",
"day": 26,
"gan_zhi": "乙巳年 辛巳月 乙未日",
"lunar": "二〇二五年四月廿九",
"lunar_day": "廿九",
"term": "",
"week_day": 1
},
{
"date": "2025-05-27",
"day": 27,
"gan_zhi": "乙巳年 辛巳月 丙申日",
"lunar": "二〇二五年五月初一",
"lunar_day": "初一",
"term": "",
"week_day": 2
},
{
"date": "2025-05-28",
"day": 28,
"gan_zhi": "乙巳年 辛巳月 丁酉日",
"lunar": "二〇二五年五月初二",
"lunar_day": "初二",
"term": "",
"week_day": 3
},
{
"date": "2025-05-29",
"day": 29,
"gan_zhi": "乙巳年 辛巳月 戊戌日",
"lunar": "二〇二五年五月初三",
"lunar_day": "初三",
"term": "",
"week_day": 4
},
{
"date": "2025-05-30",
"day": 30,
"gan_zhi": "乙巳年 辛巳月 己亥日",
"lunar": "二〇二五年五月初四",
"lunar_day": "初四",
"term": "",
"week_day": 5
},
{
"date": "2025-05-31",
"day": 31,
"gan_zhi": "乙巳年 辛巳月 庚子日",
"lunar": "二〇二五年五月初五",
"lunar_day": "初五",
"term": "",
"week_day": 6
}
],
"month": 5,
"year": 2025
},
"msg": "success"
}