阳历、农历查询API接口

阳历、农历查询API接口

2019-03-10 59

接口是nodejs实现的,农历、黄历基于https://github.com/6tail/lunar-javascript,存放在Github上,有兴趣的同学可以自行研究搭建

接口返回的数据支持公历和农历、星座、干支、生肖、节气、节日、彭祖百忌、每日宜忌、吉神宜趋、凶煞宜忌、吉神方位、冲煞、纳音等

支持的时间跨度:1901-01-01 至 2099-12-31

1、获取公历、农历、老黄历信息 

url:https://api.timelessq.com/time

method:GET

params:datetime   {String}   时间,格式为yyyy-MM-dd或yyyy-MM-dd hh:MM:ss,可以不传参,默认为现在

例子:https://api.timelessq.com/time?datetime=2020-10-01 10:00:00

{
  "errno": 0, // 是否出错
  "errmsg": "", // 错误信息
  "data": {
    "year": 2021, // 公历年
    "leapYear": false, // 是否为闰年
    "month": 1, // 公历月
    "maxDayInMonth": 31, // 公历当月天数
    "enMonth": "January", // 公历月(英文)
    "astro": "摩羯座", // 星座
    "cnWeek": "星期日", // 星期(中文)
    "enWeek": "Sunday", // 星期(英文)
    "day": 10, // 公历日
    "hour": 12, // 时
    "minute": 50, // 分
    "second": 20, // 秒
    "festivals": [ // 公历节日
      "中国人民警察节",
      "中国公安110宣传日"
    ],
    "lunar": { // 农历
      "zodiac": "鼠", // 生肖
      "year": 2020, // 农历年
      "month": 11, // 农历月
      "day": 27, // 农历日
      "cnYear": "二零二零", // 农历年份
      "cnMonth": "冬月", // 农历月份
      "cnDay": "廿七", // 农历日期
      "cyclicalYear": "庚子", // 干支纪年
      "cyclicalMonth": "己丑", // 干支纪月
      "cyclicalDay": "戊午", // 干支纪日
      "hour": "午时", // 时辰
      "maxDayInMonth": 29, // 农历当月天数
      "leapMonth": 4, // 闰月
      "yuexiang": "蛾眉残月", // 月相
      "festivals": [], // 农历节日
      "solarTerms": [ // 二十四节气
        {
          "name": "小寒", // 节气名
          "time": "2021-01-05 11:23:17" // 时间
        },
        {
          "name": "大寒",
          "time": "2021-01-20 04:39:42"
        }
      ]
    },
    "almanac": { // 老黄历
      "yi": { // 宜
        "day": "嫁娶 祭祀 沐浴 裁衣 出行 理发 移徙 捕捉 畋猎 放水 入宅 除服 成服 启钻 安葬 移柩 入殓",
        "hour": "作灶 祭祀 斋醮 酬神 修造 嫁娶 移徙 入宅 开市 交易"
      },
      "ji": { // 忌
        "day": "盖屋 开市 动土 破土",
        "hour": "祈福 求嗣 造桥 乘船"
      },
      "chong": {  // 冲
        "day": "生肖冲(壬子)鼠",
        "hour": "生肖冲(壬子)鼠"
      },
      "sha": {  // 煞
        "day": "煞北",
        "hour": "煞北"
      },
      "xingxiu": "星宿",  // 星宿
      "zheng": "日",  // 七政
      "pengzubaiji": [  // 彭祖百忌
        "戊不受田田主不祥",
        "午不苫盖屋主更张"
      ],
      "jishenfangwei": {  // 吉神方位
        "xi": "东南",  // 喜神
        "yanggui": "东北",  // 阳贵神
        "yingui": "西南",  // 阴贵神
        "fu": "正北",  // 福神
        "cai": "正北"  // 财神
      },
      "taishen": {  // 胎神方位
        "month": "占炉灶",
        "day": "房床碓外正东"
      },
      "nayin": {  // 纳音
        "year": "壁上土",
        "month": "霹雳火",
        "day": "天上火",
        "time": "天上火"
      },
      "shiershen": "执神", // 建除十二执星
      "festivals": [] // 老黄历节日
    }
  }
}

2、获取十二时辰黄历信息

url:https://api.timelessq.com/time/shichen

method:GET

params:date   {String}   日期,格式为yyyy-MM-dd,可以不传参,默认为当天

例子:https://api.timelessq.com/time/shichen?date=2020-10-01

{
  "errno": 0,
  "errmsg": "",
  "data": [
    {
      "date": "2021-1-10",  // 日期
      "hours": "23:00-00:59",  // 时辰范围
      "hour": "子时",  // 时辰
      "yi": "嫁娶 移徙 入宅 开市 交易 修造 安葬",  // 宜
      "ji": "赴任 词讼 祈福 求嗣",  // 忌
      "chong": "生肖冲(壬午)马",  // 冲
      "sha": "煞南"  // 煞
    },
    {
      "date": "2021-1-10",
      "hours": "01:00-02:59",
      "hour": "丑时",
      "yi": "无",
      "ji": "诸事不宜",
      "chong": "生肖冲(癸未)羊",
      "sha": "煞东"
    },
    ...
  ]
}

3、获取二十四节气信息

url:https://api.timelessq.com/time/jieqi

method:GET

params:year   {Integer}   年份,格式为yyyy,不传默认为今年

例子:https://api.timelessq.com/time/jieqi?year=2020

{
  "errno": 0,
  "errmsg": "",
  "data": [
    {  // 上一阳历年的节气
      "name": "DA_XUE",
      "time": "2020-12-07 00:09:21"
    },
    {
      "name": "冬至",
      "time": "2020-12-21 18:02:12"
    },
    {
      "name": "小寒",
      "time": "2021-01-05 11:23:17"
    },
    ...
    {  // 下一阳历年的节气
      "name": "XIAO_HAN",
      "time": "2022-01-05 17:13:54"
    }
  ]
}

更多接口查看https://api.timelessq.com

 

评论(0)

还没有评论,快来抢第一吧