全部文章 web开发 Api文档 时光画轴 全部壁纸 二次元 初音未来 自然 时光 游戏 崩坏学园 英雄联盟 碧蓝航线 全部番剧 电影 国创 番剧 全部视频 动画 影视 音乐
logo
【Api】PHP时间、农历查询Api接口

【Api】PHP时间、农历查询Api接口

Timeless 2018-06-08 393

这个一般JS实现比较容易,像本站应用里面Dock标签页就是使用js去计算的。

时间计算,百度以及一些日历网站的计算比较准确,干支纪月、干支纪日、节气有些问题,反正关于农历的计算有一定误差

接口返回的数据很全面,如:农历、黄历、禁忌、星期、生肖、当月的节气等,以json数据格式返回

查询当前时间

JSON返回方式(成功)

QQ截图20180608172508.png

参数说明:可以不传参,默认为当天,Get请求即可。

地址://cos.timelessq.com/api/time/index.php

{
    "states": 1,  //成功状态
    "message": "请求当前时间数据成功",  //成功
    "data": {
        "timestamp": 1528448743,    //unix时间戳
        "year": 2018,    //公历年
        "leapYear": false,    //是否闰年
        "animal": "狗",    //生肖
        "maxDayInMonth": 30,    //当前月最大天数
        "month": "06",    //公历月
        "enMonth": "June",    //公历月英文名称
        "cnMonth": "六月",    //公历月中文名称
        "constellation": "双子",    //星座
        "enWeek": "Friday",    //星期英文
        "cnWeek": "星期五",    //星期中文
        "day": "08",    //公历日
        "festivalList": [],    //当天节日
        "solarTerms": {    //当月节气
            "6": "芒种",
            "21": "夏至"
        },
        "nowTerms": "",    //当天节气
        "hour": "09",    //小时
        "minute": "05",    //分钟
        "second": "43",    //秒钟
        "lunar": {
            "lunarYear": "2018",    //农历年
            "cnyear": "贰零壹捌",    //农历年大写
            "cyclicalYear": "戊戌",    //干支纪年
            "cyclicalMonth": "丁巳",    //干支纪月   这个算法不明确,所以可能不准确
            "cyclicalDay": "辛未",    //干支纪日   这个算法不明确,所以可能不准确
            "lunarMonth": "四月",    //农历月
            "dayInLunarMonth": 30,    //农历月最大天数
            "leapMonth": false,    //农历是否闰月
            "lunarDay": "廿五",    //农历日
            "lunarHour": "巳时"    //干支纪时
        },
        "suit": "嫁娶,祭祀,祈福,求嗣,开光,出行,解除,出火,拆卸,修造,进人口,入宅,移徙,动土,安床,纳畜,栽种,纳财,交易,立券,挂匾,造畜椆栖",    //宜
        "taboo": "安葬,开生坟,合寿木,行丧",    //禁忌
        "chong": "生肖冲牛",    //冲
        "sha": "煞西",    //煞
        "cheng": "除",    //成
        "zhengchong": "正冲正冲乙丑",    //正冲
        "taishen": "厨灶厕外西南"    //胎神
    }
}

JSON返回方式(失败)

失败情况下一般是参数问题,参数不识别,没有按规则走,格式为yyyy-MM-dd,如2018-05:08。

{
    "states": 0,
    "message": "日期格式错误,期望的格式为 yyyy-MM-dd"
}

时间查询 JSON返回方式,指定日期

QQ截图20180608180850.png

参数说明:可以不传参,默认为当天,Get请求即可。

date: 格式为yyyy-MM-dd年-月-日

time: 格式为h:i:s   时:分:秒   这个可以不写 默认00:00:00

地址://cos.timelessq.com/api/time/index.php?date=2018-02-16&time=18:03:50

或者 //cos.timelessq.com/api/time/index.php?date=2018-10-01

{
    "states": 2,
    "message": "请求指定时间数据成功",
    "data": {
        "timestamp": 1518804230,
        "year": 2018,
        "leapYear": false,
        "animal": "狗",
        "maxDayInMonth": 28,
        "month": "02",
        "enMonth": "June",
        "cnMonth": "二月",
        "constellation": "水瓶",
        "enWeek": "Friday",
        "cnWeek": "星期五",
        "day": "16",
        "festivalList": [
            "春节"
        ],
        "solarTerms": {
            "4": "立春",
            "19": "雨水"
        },
        "nowTerms": "",
        "hour": "18",
        "minute": "03",
        "second": "50",
        "lunar": {
            "lunarYear": "2018",
            "cnyear": "贰零壹捌",
            "cyclicalYear": "戊戌",
            "cyclicalMonth": "甲寅",
            "cyclicalDay": "己卯",
            "lunarMonth": "正月",
            "dayInLunarMonth": 29,
            "leapMonth": false,
            "lunarDay": "初一",
            "lunarHour": "酉时"
        },
        "suit": "祭祀,祈福,斋醮,出行,开市,立券,动土,移徙,入宅,破土,安葬",
        "taboo": "开光,嫁娶,作灶,掘井,纳畜",
        "chong": "生肖冲鸡",
        "sha": "煞西",
        "cheng": "除",
        "zhengchong": "正冲正冲癸酉",
        "taishen": "占门厕外正南"
    }
}

请求失败返回信息和不传参的一样一样的

农历部分数据不太稳定,每日宜忌只有2008-2020年,数据来源与360,百度的暂时没空抓取~

有问题可以直接在文章下面留言


分享到微信