万年历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都能提供强大的数据支持。

目录
相关文章
|
5月前
|
JSON API PHP
万年历API接口详解:精准获取指定日期信息
本文介绍接口盒子提供的万年历API,支持获取农历、节气、宜忌、星座等信息,具备完整的请求与返回示例,适用于黄历、日程管理等应用开发。
1426 0
|
API
免费节假日api接口使用教程-聚合数据
免费节假日api接口使用教程-聚合数据
4824 0
免费节假日api接口使用教程-聚合数据
|
API 开发者
工作日和节假日api
节假日api核心服务托管在阿里云之上,API天然分布式、高可用。
|
Linux
centos7 升级qemu-kvm版本
centos7 手动升级qemu-kvm版本
2809 0
|
6月前
|
人工智能 IDE 定位技术
AI IDE正式上线!通义灵码开箱即用
通义灵码AI IDE现已正式上线,用户可免费下载使用。作为AI原生开发环境工具,它深度适配千问3大模型,集成通义灵码插件能力,支持编程智能体、行间建议预测和行间会话等功能。其核心亮点包括:支持最强开源模型千问3,具备MCP工具调用能力;开箱即用的智能编码助手;自带编程智能体模式,端到端完成编码任务;长期记忆、NES行间预测及Inline Chat功能,大幅提升编程效率。目前,通义灵码插件下载量超1500万,生成代码超30亿行,广泛应用于企业开发场景。
AI IDE正式上线!通义灵码开箱即用
|
5月前
|
前端开发 Java 开发者
SpringBoot 3 + Flutter3 实战低代码运营管理
Spring Boot 3 与 Flutter 3 强强联合,助力现代 Web 与移动应用开发。Spring Boot 3 提升后端开发效率,支持最新 Java 特性;Flutter 3 实现跨平台高性能 UI,热重载加速前端迭代。两者结合打造高效、可扩展的应用开发新体验。
243 0
|
API
万年历[取当日信息]免费API接口教程
此API提供万年历当天的详细信息,包括农历、星期、宜忌、生肖、星座、节日、五行、星宿等。支持POST和GET请求,需提供用户ID和KEY。返回数据包含阳历、农历、干支、节日列表等多项内容。示例URL:https://cn.apihz.cn/api/time/getday.php?id=88888888&key=88888888。
3816 10
|
机器学习/深度学习 并行计算 数据可视化
目标分类笔记(二): 利用PaddleClas的框架来完成多标签分类任务(从数据准备到训练测试部署的完整流程)
这篇文章介绍了如何使用PaddleClas框架完成多标签分类任务,包括数据准备、环境搭建、模型训练、预测、评估等完整流程。
1010 0
目标分类笔记(二): 利用PaddleClas的框架来完成多标签分类任务(从数据准备到训练测试部署的完整流程)
|
运维 Kubernetes Java
阿里云容器计算服务ACS ,更普惠易用、更柔性、更弹性的容器算力
ACS(阿里云容器计算服务)推出Serverless容器算力,提供更普惠、柔性、弹性的算力资源,适用于多种业务场景,如复合应用、ACK集成、EMR大数据处理等,帮助企业降低成本、提升效率。
|
人工智能 算法 图形学
总有一个是你想要的分享40个Python游戏源代码
这是一系列基于Python开发的游戏项目集合,包括中国象棋、麻将、足球、坦克大战、扑克等多种类型游戏,运用了Pygame等库实现图形界面与AI算法。此外还包含迷宫、数独、推箱子等益智游戏及经典游戏如《仙剑奇侠传二战棋版》和《星露谷物语》的Python版本,适合编程学习与娱乐。
1188 11