万年历、星座、节气查询API接口

农历、老黄历基于https://github.com/6tail/lunar-javascript

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

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

1、万年历信息

 查询公历、农历、老黄历信息

https://api.timelessq.com/time

1.1、请求参数

参数名	位置	类型	必填	说明	示例值
datetime	query	string	否	查询指定时间信息，不传取当前时间	2020-10-01

1.2、示例代码

var axios = require('axios');

var config = {
   method: 'get',
   url: 'https://api.timelessq.com/time?datetime=2020-10-01'
};

axios(config)
.then(function (response) {
   console.log(JSON.stringify(response.data));
})
.catch(function (error) {
   console.log(error);
});

1.3、返回响应

{
    "errno": 0,
    "errmsg": "",
    "data": {
        "year": 2020, // 公历年
        "leapYear": true, // 是否为闰年
        "month": 10, // 公历月
        "maxDayInMonth": 31, // 公历当月天数
        "enMonth": "October", // 公历月（英文）
        "astro": "天秤座", // 星座
        "cnWeek": "星期四", // 星期（中文）
        "enWeek": "Thursday", // 星期（英文）
        "weekInYear": 40, // 本年第几周
        "day": 1, // 公历日
        "dayInYear": 275, // 本年第几天
        "julianDay": 2459123.8333333335, // 儒略日
        "hour": 8, // 时
        "minute": 0, // 分
        "second": 0, // 秒
        "festivals": [ // 节日
            "国庆节",
            "中秋节"
        ],
        "lunar": {
            "zodiac": "鼠", // 生肖
            "year": 2020, // 农历年
            "month": 8, // 农历月
            "day": 15, // 农历日
            "cnYear": "二零二零", // 农历年份
            "cnMonth": "八月", // 农历月份
            "cnDay": "十五", // 农历日期
            "cyclicalYear": "庚子", // 干支纪年
            "cyclicalMonth": "乙酉", // 干支纪月
            "cyclicalDay": "丁丑", // 干支纪日
            "hour": "子时", // 时辰
            "maxDayInMonth": 30, // 农历当月天数
            "leapMonth": 4, // 闰月
            "yuexiang": "望", // 月相
            "wuhou": "蛰虫坯户", // 物候
            "shujiu": "", // 数九
            "sanfu": "", // 三伏
            "solarTerms": {} // 二十四节气
        },
        "almanac": {
            "yi": "嫁娶 祭祀 祈福 求嗣 沐浴 出火 出行 拆卸 修造 动土 进人口 开市 交易 立券 入宅 移徙 安床 栽种 纳畜 入殓 安葬 启钻 除服 成服", // 宜
            "ji": "无", // 忌
            "chong": "生肖冲(辛未)羊", // 冲
            "sha": "煞东", // 煞
            "nayin": "涧下水", // 纳音
            "shiershen": "定神", // 建除十二执星
            "xingxiu": "斗宿", // 星宿
            "zheng": "木", // 七政
            "shou": "玄武", // 四宫
            "pengzubaiji": [ // 彭祖百忌
                "丁不剃头头必生疮",
                "丑不冠带主不还乡"
            ],
            "jishenfangwei": { // 吉神方位
                "xi": "离-正南",
                "yanggui": "乾-西北",
                "yingui": "兑-正西",
                "fu": "巽-东南",
                "cai": "坤-西南"
            },
            "liuyao": "佛灭", // 六曜
            "jiuxing": "八白土洞明", // 九星
            "taisui": "离-正南" // 太岁方位
        }
    }
}

2、星座查询

查询星座信息

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

2.1、请求参数

参数名	位置	类型	必填	说明	示例值
keyword	query	string	否	查找日期或星座名称：如1900年起始	2022-01-01 或 天秤(座)、水瓶(座)

2.2、示例代码

var axios = require('axios');

var config = {
   method: 'get',
   url: 'https://api.timelessq.com/time/astro'
};

axios(config)
.then(function (response) {
   console.log(JSON.stringify(response.data));
})
.catch(function (error) {
   console.log(error);
});

2.3、返回响应

{
    "errno": 0,
    "errmsg": "",
    "data": {
        "name": "天秤座",
        "range": "9.23-10.23",
        "zxtd": "公平和谐",
        "sssx": "风",
        "zggw": "第七宫",
        "yysx": "阳性",
        "zdtz": "衡量抉择",
        "zgxx": "金星",
        "xyys": "褐色",
        "jssw": "珊瑚、琥珀",
        "xyhm": "3",
        "kyjs": "木",
        "bx": "平衡、和谐",
        "yd": "优雅，友善，善于交际",
        "qd": "犹豫不决，怕寂寞，以貌取人",
        "jbtz": "太阳位于天秤座的人很有气质，谈吐应对得体，善于与人沟通协调，是绝佳的谈判人才，属于迷人优雅派人物。只不过，思想易左右摇摆；追求外表光鲜，易失去自我。",
        "jttz": "天秤座是黄道宫上的第七个星座，主宰星为金星。你极具风度，浑身充满了优雅的贵族气息，喜欢与人群接触，不喜欢单打独斗，对于具有美感的事物特别感兴趣，出色的交际能力让你很容易与人打成一片；你很注意自己的外在形象，希望在他人面前表现出完美的一面，但也易让人感觉虚荣、做作。你喜欢从正反两面看待问题，力求公平公正，最怕冲突和不协调；有一套自己人生哲学，懂得享受生活。",
        "xsfg": "太阳落在天秤座的你，凡事要求公平，遇事从多角度思考，以达到你所追求的平等；热衷于团队合作，在轻松愉快的环境中工作可以激发出你的热情，会有非常出色的表现。只是有时太追求平衡，反而难以达到更好的效果。",
        "gxmd": "有时神经过敏，显得神经质，常常处于焦虑不安的状态；意志薄弱，遇事摇摆不定，难以抉择，常给人瞻前顾后的印象，显得懦弱。应放松身心，释放压力，增强魄力与行动力，快速作出决定。",
        "zj": "天秤座常常追求平等、和谐，擅于察言观色，交际能力很强，因此真心朋友不少，因为你也足够真诚，但是最大的缺点就是面对选择总是犹豫不决。天秤男容易在乎自己而忽略别人，天秤女就喜欢被陪伴的感觉。"
    }
}

3、十二时辰

查询十二时辰黄历信息

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

3.1、请求参数

参数名	位置	类型	必填	说明	示例值
date	query	string	否	查询指定日期时辰信息，不传取当天	2020-10-01

3.2、示例代码

var axios = require('axios');

var config = {
   method: 'get',
   url: 'https://api.timelessq.com/time/shichen'
};

axios(config)
.then(function (response) {
   console.log(JSON.stringify(response.data));
})
.catch(function (error) {
   console.log(error);
});

3.3、返回响应

{
    "errno": 0,
    "errmsg": "",
    "data": [
        {
            "date": "2022-3-29",
            "hours": "23:00-00:59",
            "hour": "子时",
            "yi": "无",
            "ji": "诸事不宜",
            "chong": "生肖冲(壬午)马",
            "sha": "煞南",
            "nayin": "霹雳火",
            "jiuxing": "三碧木天玑"
        },
        {
            "date": "2022-3-29",
            "hours": "01:00-02:59",
            "hour": "丑时",
            "yi": "祭祀 祈福 斋醮 酬神 修造 作灶",
            "ji": "无",
            "chong": "生肖冲(癸未)羊",
            "sha": "煞东",
            "nayin": "霹雳火",
            "jiuxing": "二黒土天璇"
        },
        {
            "date": "2022-3-29",
            "hours": "03:00-04:59",
            "hour": "寅时",
            "yi": "祈福 求嗣 订婚 嫁娶 出行 求财 开市 交易 安床 赴任 祭祀",
            "ji": "上梁 盖屋 入殓",
            "chong": "生肖冲(甲申)猴",
            "sha": "煞北",
            "nayin": "松柏木",
            "jiuxing": "一白水天枢"
        }
    ]
}

4、获取二十四节气信息

查询二十四节气时间信息

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

4.1、请求参数

参数名	位置	类型	必填	说明	示例值
year	query	string	否	公历年	2020

4.2、示例代码

var axios = require('axios');

var config = {
   method: 'get',
   url: 'https://api.timelessq.com/time/jieqi'
};

axios(config)
.then(function (response) {
   console.log(JSON.stringify(response.data));
})
.catch(function (error) {
   console.log(error);
});

4.3、返回响应

{
    "errno": 0,
    "errmsg": "",
    "data": [
        {
            "name": "大雪",
            "time": "2021-12-07 05:56:55"
        },
        {
            "name": "冬至",
            "time": "2021-12-21 23:59:09"
        },
        {
            "name": "小寒",
            "time": "2022-01-05 17:13:54"
        },
        {
            "name": "大寒",
            "time": "2022-01-20 10:38:56"
        },
        {
            "name": "立春",
            "time": "2022-02-04 04:50:36"
        }
    ]
}