万年历API接口详解：精准获取指定日期信息

本文链接：https://blog.youkuaiyun.com/apihz/article/details/149308907

本文详细介绍由接口盒子提供的万年历API接口，该接口可精准获取指定公历日期的农历、节气、宜忌、星座等全方位信息。

接口基本信息

接口地址：https://cn.apihz.cn/api/time/getzdday.php
请求方式：GET/POST
数据格式：JSON
版权来源：万年历数据版权说明

请求参数说明

参数名	必填	说明
id	是	用户ID（需注册获取）
key	是	用户通讯秘钥
nian	是	公历年（1900~次年）
yue	是	公历月（1-12，不加0）
ri	是	公历日（1-31，不加0）

📌 注意：年份不能超过当前年份的下一年（如2024年最多查询2025年）

返回参数示例

json

复制

{
  "code": 200,
  "ynian": "2025",
  "yyue": "10",
  "yri": "1",
  "nyue": "八月",
  "nri": "初十",
  "ganzhinian": "乙巳年",
  "xingqi": "星期三",
  "yi": "破屋|坏垣|求医|治病|余事勿取",
  "ji": "移徙|入宅",
  "jieri": "国庆节|世界音乐日|国际老人节",
  "shengxiao": "蛇",
  "xingzuo": "天秤座",
  "jieqi": "秋分",
  "jieqimsg": "秋分 第9天 (距下一个节气'寒露',还有7天)",
  // 完整参数详见文档...
}

调用示例代码

🔹 PHP调用示例

php

复制

<?php
$api_url = 'https://cn.apihz.cn/api/time/getzdday.php';
$params = [
    'id'  => '88888888',      // 替换为您的ID
    'key' => '88888888',      // 替换为您的KEY
    'nian' => '2025',         // 查询年份
    'yue'  => '10',           // 查询月份
    'ri'   => '1'             // 查询日期
];

// 拼接GET请求URL
$request_url = $api_url . '?' . http_build_query($params);
$response = file_get_contents($request_url);
$data = json_decode($response, true);

// 处理返回数据
if ($data['code'] == 200) {
    echo "日期: {$data['ynian']}年{$data['yyue']}月{$data['yri']}日\n";
    echo "农历: {$data['nyue']}{$data['nri']}\n";
    echo "宜: {$data['yi']}\n";
} else {
    echo "请求失败: {$data['msg']}";
}
?>

🔹 Python调用示例

python

运行

复制

import requests

params = {
    "id": "88888888",     # 替换为您的ID
    "key": "88888888",    # 替换为您的KEY
    "nian": "2025",       # 查询年份
    "yue": "10",          # 查询月份
    "ri": "1"             # 查询日期
}

response = requests.get(
    "https://cn.apihz.cn/api/time/getzdday.php",
    params=params
)
data = response.json()

if data["code"] == 200:
    print(f"日期: {data['ynian']}年{data['yyue']}月{data['yri']}日")
    print(f"农历: {data['nyue']}{data['nri']}")
    print(f"节气: {data['jieqi']}（{data['jieqimsg']}）")
else:
    print(f"请求失败: {data['msg']}")