万年历API接口详细教程:获取指定日12时辰详细信息

简介: 万年历“取指定日-12时辰详细信息”API提供免费、全面的农历及时辰数据,涵盖干支、五行、纳音、宜忌、方位等90余项命理信息,支持POST/GET请求,适用于算命、风水、日历类应用开发。

概述

万年历"取指定日-12时辰详细信息"API是一个功能强大的免费接口,专门用于获取中国传统农历日历中指定日期的12个时辰详细数据。该接口提供了丰富的命理信息,包括干支、五行、纳音、十神、方位吉凶等90多项数据,是开发算命、风水、日历等应用的理想工具。

接口基本信息

请求地址

复制

https://cn.apihz.cn/api/time/getzddayhs.php

请求方式

支持POST和GET两种请求方式。

请求参数

名称

参数

必填

说明

用户ID

id

用户中心的数字ID

用户KEY

key

用户中心通讯秘钥

查询方式

type

0=按阳历查询,1=按阴历查询,默认0

指定年

nian

指定要查询的年份(1800-2199年)

指定月

yue

指定要查询的月份

指定日

ri

指定要查询的日

返回参数说明

接口返回包含90多项详细数据,主要分为以下几类:

  1. 1.基础信息:阳历/阴历年月日、时辰时间
  2. 2.干支信息:年月日时干支、生肖、冲煞
  3. 3.宜忌信息:当日宜忌事项
  4. 4.方位信息:财神、福神、喜神等方位
  5. 5.天神信息:十二天神吉凶类型
  6. 6.九星信息:北斗九星相关数据
  7. 7.五行八字:年月日时五行、纳音、十神等
  8. 8.其他命理:地势、旬空、胎元、命宫等

调用示例

GET请求示例

复制

https://cn.apihz.cn/api/time/getzddayhs.php?id=88888888&key=88888888&nian=2025&yue=10&ri=1&type=0

PHP调用示例

php

复制

<?php
// 设置请求参数
$id = "您的用户ID";
$key = "您的用户KEY";
$nian = "2025";
$yue = "10";
$ri = "1";
$type = "0";
// 构建请求URL
$url = "https://cn.apihz.cn/api/time/getzddayhs.php?" .
       "id=" . $id . 
       "&key=" . $key . 
       "&nian=" . $nian . 
       "&yue=" . $yue . 
       "&ri=" . $ri . 
       "&type=" . $type;
// 发送GET请求
$response = file_get_contents($url);
// 解析JSON响应
$data = json_decode($response, true);
// 检查请求是否成功
if ($data && isset($data[0]['code'])) {
    if ($data[0]['code'] == 200) {
        // 处理返回的数据
        foreach ($data as $hour) {
            echo "时辰: " . $hour['SHICHENG'] . "\n";
            echo "八字: " . $hour['ALLBAZI'] . "\n";
            echo "宜: " . $hour['YI'] . "\n";
            echo "忌: " . $hour['JI'] . "\n";
            echo "-----------------------\n";
        }
    } else {
        echo "错误: " . $data[0]['msg'];
    }
} else {
    echo "请求失败";
}
?>

Python调用示例

python

下载

复制

运行

import requests
import json
# 设置请求参数
params = {
    'id': '您的用户ID',
    'key': '您的用户KEY',
    'nian': '2025',
    'yue': '10',
    'ri': '1',
    'type': '0'
}
# 发送GET请求
try:
    response = requests.get('https://cn.apihz.cn/api/time/getzddayhs.php', params=params)
    data = response.json()
    
    # 检查请求是否成功
    if isinstance(data, list) and len(data) > 0:
        if 'code' in data[0]:
            if data[0]['code'] == 200:
                # 处理返回的数据
                for hour in data:
                    print(f"时辰: {hour['SHICHENG']}")
                    print(f"八字: {hour['ALLBAZI']}")
                    print(f"宜: {hour['YI']}")
                    print(f"忌: {hour['JI']}")
                    print("-----------------------")
            else:
                print(f"错误: {data[0]['msg']}")
        else:
            # 直接处理返回的时辰数据
            for hour in data:
                print(f"时辰: {hour['SHICHENG']}")
                print(f"八字: {hour['ALLBAZI']}")
                print("-----------------------")
    else:
        print("返回数据格式异常")
        
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")
except json.JSONDecodeError as e:
    print(f"JSON解析失败: {e}")

Python使用POST请求示例

python

下载

复制

运行

import requests
import json
# 设置请求参数
data = {
    'id': '您的用户ID',
    'key': '您的用户KEY',
    'nian': '2025',
    'yue': '10',
    'ri': '1',
    'type': '0'
}
# 发送POST请求
try:
    response = requests.post('https://cn.apihz.cn/api/time/getzddayhs.php', data=data)
    result = response.json()
    
    # 处理返回数据
    if isinstance(result, list) and len(result) > 0:
        for hour_data in result:
            print(f"时辰: {hour_data.get('SHICHENG', 'N/A')}")
            print(f"干支: {hour_data.get('GANZHI', 'N/A')}")
            print(f"生肖: {hour_data.get('SHENGXIAO', 'N/A')}")
            print(f"宜: {hour_data.get('YI', 'N/A')}")
            print(f"忌: {hour_data.get('JI', 'N/A')}")
            print("五行信息:")
            print(f"  年: {hour_data.get('YEARWUXING', 'N/A')}")
            print(f"  月: {hour_data.get('MONTHWUXING', 'N/A')}")
            print(f"  日: {hour_data.get('DAYWUXING', 'N/A')}")
            print(f"  时: {hour_data.get('TIMEWUXING', 'N/A')}")
            print("="*50)
            
except Exception as e:
    print(f"请求失败: {e}")

返回数据示例解析

接口成功调用后,会返回一个包含12个对象的数组,每个对象代表一个时辰的详细信息。以下是关键字段的说明:

基础信息字段

  • YLYEAR, YLMONTH, YLDAY: 阳历年月日
  • YIYEAR, YIMONTH, YIDAY: 阴历年月日
  • SHICHENG: 时辰时间范围
  • YIYYYYMMDD: 阴历年月日汉字写法

干支八字信息

  • YIYEAR_GANZHI, YIMONTH_GANZHI, YIDAY_GANZHI, GANZHI: 年月日时干支
  • ALLBAZI: 完整八字合写
  • SHENGXIAO: 时辰生肖
  • CHONG, CHONGGAN, CHONGGANTIE: 冲煞信息

宜忌与方位

  • YI, JI: 宜忌事项
  • POSITIONCAI, POSITIONFU, POSITIONXI: 财神、福神、喜神方位
  • TIANSHEN, TIANSHENLUCK, TIANSHENTYPE: 十二天神信息

九星与命理

  • NINESTAR系列字段: 北斗九星详细信息
  • YEARWUXING等: 年月日时五行
  • YEARNAYIN等: 纳音信息
  • YEARSHISHENGAN等: 十神信息
  • YEARDISHI等: 地势(长生十二神)
  • TAIYUAN, MINGGONG, SHENGONG: 胎元、命宫、身宫

使用注意事项

  1. 1.认证信息:示例中的ID和KEY为公共凭证,有调用频次限制,建议注册获取个人独享凭证。
  2. 2.年份范围:默认支持1800年至明年,如需更广范围需联系定制。
  3. 3.错误处理:始终检查返回的code字段,400表示错误,200表示成功。
  4. 4.数据解析:返回数据为JSON格式,包含12个时辰对象,需循环处理。
  5. 5.调用限制:免费接口有每分钟调用频次限制,但每日无总上限。

应用场景

该API适用于多种应用开发场景:

  1. 1.算命应用:提供完整的八字排盘和命理分析数据
  2. 2.日历应用:显示每日宜忌和吉凶时辰
  3. 3.风水软件:提供方位吉凶和星象信息
  4. 4.传统文化教育:学习中国传统历法和命理知识
  5. 5.活动策划:选择吉日吉时举办重要活动

总结

万年历"取指定日-12时辰详细信息"API是一个功能全面、数据丰富的免费接口,为开发者提供了便捷的传统日历和命理数据获取途径。通过简单的HTTP请求即可获得专业的命理分析数据,大大降低了开发相关应用的技术门槛。无论是个人兴趣项目还是商业应用,这个API都能提供强大的数据支持。

相关文章
|
23小时前
|
云安全 人工智能 自然语言处理
|
5天前
|
搜索推荐 编译器 Linux
一个可用于企业开发及通用跨平台的Makefile文件
一款适用于企业级开发的通用跨平台Makefile,支持C/C++混合编译、多目标输出(可执行文件、静态/动态库)、Release/Debug版本管理。配置简洁,仅需修改带`MF_CONFIGURE_`前缀的变量,支持脚本化配置与子Makefile管理,具备完善日志、错误提示和跨平台兼容性,附详细文档与示例,便于学习与集成。
314 116
|
8天前
|
数据采集 人工智能 自然语言处理
Meta SAM3开源:让图像分割,听懂你的话
Meta发布并开源SAM 3,首个支持文本或视觉提示的统一图像视频分割模型,可精准分割“红色条纹伞”等开放词汇概念,覆盖400万独特概念,性能达人类水平75%–80%,推动视觉分割新突破。
568 53
Meta SAM3开源:让图像分割,听懂你的话
|
20天前
|
域名解析 人工智能
【实操攻略】手把手教学,免费领取.CN域名
即日起至2025年12月31日,购买万小智AI建站或云·企业官网,每单可免费领1个.CN域名首年!跟我了解领取攻略吧~
|
5天前
|
人工智能 Java API
Java 正式进入 Agentic AI 时代:Spring AI Alibaba 1.1 发布背后的技术演进
Spring AI Alibaba 1.1 正式发布,提供极简方式构建企业级AI智能体。基于ReactAgent核心,支持多智能体协作、上下文工程与生产级管控,助力开发者快速打造可靠、可扩展的智能应用。
|
4天前
|
弹性计算 人工智能 Cloud Native
阿里云无门槛和有门槛优惠券解析:学生券,满减券,补贴券等优惠券领取与使用介绍
为了回馈用户与助力更多用户节省上云成本,阿里云会经常推出各种优惠券相关的活动,包括无门槛优惠券和有门槛优惠券。本文将详细介绍阿里云无门槛优惠券的领取与使用方式,同时也会概述几种常见的有门槛优惠券,帮助用户更好地利用这些优惠,降低云服务的成本。
267 132
|
8天前
|
机器学习/深度学习 人工智能 自然语言处理
AgentEvolver:让智能体系统学会「自我进化」
AgentEvolver 是一个自进化智能体系统,通过自我任务生成、经验导航与反思归因三大机制,推动AI从“被动执行”迈向“主动学习”。它显著提升强化学习效率,在更少参数下实现更强性能,助力智能体持续自我迭代。开源地址:https://github.com/modelscope/AgentEvolver
406 29
|
14天前
|
安全 Java Android开发
深度解析 Android 崩溃捕获原理及从崩溃到归因的闭环实践
崩溃堆栈全是 a.b.c?Native 错误查不到行号?本文详解 Android 崩溃采集全链路原理,教你如何把“天书”变“说明书”。RUM SDK 已支持一键接入。
713 224