万年历是中国古代传说中最古老的一部太阳历。万年历的名称来源于商朝一位名叫万年的人,他是这部历法的编撰者。为纪念他的功绩便将这部历法命名为“万年历”。万年历是记录一定时间范围内的具体阳历与阴历的日期的年历,方便有需要的人查询使用。万年只是一种象征,表示时间跨度大。能同时显示公历、农历和干支历等多套历法,更能包含黄历相关吉凶宜忌、节假日、提醒等多种功能信息。
今天我就来说一说 APISpace 的万年历API,支持2020年至2030年任意一个公历日期的万年历数据,公历日期对应的农历、农历节日节气、天干地支纪年纪月纪日、生肖属相、宜忌、星座等信息。本接口返回数据起始日期为北京时间当前日期-1,如果需要查询到未来N天的数据,则需要将days设置为N+1。例如查询未来5天的万年历数据,则days=6,返回昨天+未来5天的万年历数据。在这里也分享给大家。
APISpace 上面还多有各种各样的API,包括常见的短信、物流、天气啥的,有需要的可以自己上去看看~
接口信息
- 请求方式:GET
- Query参数;
- days:支持未来15天
- 返回示例:
{
"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": "闭执位" //十二神
}
},
…… //其他日期万年历信息
]
}