引言
当今社会,人们对时间的需求不仅仅是简单地知道日期,更多地是追求个性化、文化化和精确化的时间信息。在这个背景下,万年历API变得越来越重要,因为它可以提供超越传统日历的智慧,为我们带来了丰富的日期信息,如节日节气、天干地支纪年纪月纪日、宜忌、星座和生肖等。本文将来说一说万年历API~
万年历API应用场景
万年历API的使用
1.申请接口
注册登录 APISpace,进入 万年历API 的接口详情页,申请接口。
2.在线使用接口
申请接口成功,进入测试页面,输入需要查询的天数。
使用指南:
万年历 API 获取公历日期对应的农历、农历节日节气、天干地支纪年纪月纪日、生肖属相、宜忌、星座等信息。
本接口返回数据起始日期为北京时间当前日期-1(也就是昨天),如果需要查询到未来N天的数据,则需要将days设置为N+2。
例如要查询未来5天的万年历数据,则days=7,返回昨天+今天+未来5天的万年历数据。
3.接口返回示例
{
"result": [
{
"date": "2020-07-01", //日期
"lunar": "五月十一", //农历日期
"lunarYear": "鼠年", //农历年
"ganzhiYear": "庚子年", //干支年
"ganzhiMonth": "壬午月",//干支月
"ganzhiDay": "乙巳日", //干支月
"festival": [ //节日或纪念日
"建党节",
"香港回归纪念日"
],
"fitting": "求嗣,嫁娶", //宜
"taboo": "安葬,出行", //忌
"solarTerm": "夏至", //节气
"stDays": 11, //节气第N天
"nextSt": "小暑", //下一个节气
"nextstDays": 5, //距离下一个节气还有N天
"moreDetail": { //更多信息,若不需要,可在请求地址中传withMoreDetail=false
"zodiac": "鼠", //生肖
"constellation": "巨蟹座", //星座
"pzTaboo": "乙不栽植千株不长", //彭祖百忌
"foetus": "碓磨床房内东", //胎神占方
"elementYear": "壁上土", //年五行
"elementMonth": "杨柳木", //月五行
"elementDay": "覆灯火", //日五行
"star": "氐宿(氐土貉)", //星宿
"chong": "猪 (己亥)", //冲
"sha": "东", //煞
"obsidian": "先负", //六曜
"twelveGods": "闭执位" //十二神
}
},
…… //其他日期万年历信息
]
}