黄历运势返回字段全解：黄历/吉神凶煞/吉时字段一文读懂
# 黄历运势返回字段全解：黄历/吉神凶煞/吉时字段一文读懂
> 接口 黄历运势（apiCode=856） · 免费服务 · 适用人群：开发者、产品经理 · 阅读时间约 8 分钟
## TL;DR
- 所有接入点的业务数据都在 `showapi_res_body` 内，`ret_code=0` 为成功。
- 黄历（856-2）返回农历/干支/宜忌/冲煞/值神等约 22 个字段。
- 吉神凶煞（856-4）返回神煞方位、三煞、太岁、十二值神等约 30 个字段。
- 吉时（856-3）返回 12 个时辰对象，每个含吉凶/吉神/时段/时冲/时柱。
## Why：为什么需要一张字段速查表
黄历运势的字段名（如 `zhishen`、`nayin`、`tjjs`、`wxcy`）都是业务缩写，初看容易猜错含义；三个接入点字段差异很大，混用会出问题。本文把三个接入点的返回字段一次性列清，作为全系列可搜索的「字段字典」，其余文章与你的代码都引用它。
## What：字段约定
- 所有字段位于 `showapi_res_body` 对象内。
- `ret_code`：0 为成功（扣除次数），其余为失败（不扣除次数）。
- 时间范围：1901-01-01 至当前年份；更新频率每年 1 月 1 日—1 月 3 日早上 9 点。
## 黄历接入点（856-2）返回字段
| 字段 | 类型 | 示例 | 说明 |
|------|------|------|------|
| `nongli` | String | 二零二五年正月(大)十四 | 农历 |
| `zhishen` | String | 玉堂(黄道日) | 值神 |
| `jieqi24` | String | 2月3日立春 2月18日雨水 | 当月 24 节气 |
| `nayin` | String | [年]壁上土 [月]霹雷火 [日]城墙土 | 纳音 |
| `tszf` | String | 占门厕外正南 | 胎神占方 |
| `shengxiao` | String | 属鼠 | 生肖 |
| `rulueli` | String | 2460717.5 | 儒略历 |
| `xsyj` | String | 岁刑 伐日… | 凶神宜忌 |
| `xingzuo` | String | 摩羯座 | 星座 |
| `ganzhi` | String | 庚子年 戊子月 己卯日 | 干支 |
| `dizhi` | String | 今日与羊、猪半合… | 地支 |
| `pzbj` | String | 己不破券二比并亡… | 彭祖百忌 |
| `zhiri` | String | 平执位(凶) | 值日 |
| `msg` | String | 查询成功 | 描述 |
| `gongli` | String | 公元 2025年2月11日 星期二 | 公历 |
| `jsyq` | String | 天恩 神在 五合… | 吉神宜趋 |
| `ji` | String | 祈福 安葬 | 忌 |
| `jieri` | String | 元旦 | 节日 |
| `qixiang` | String | 今日二九第2天 进九第11天 | 气象（数九） |
| `chongsha` | String | 冲鸡煞西 正冲癸酉(1933 1993) | 冲煞 |
| `yi` | String | 动土 修造 装修 拆卸 出行 | 宜 |
| `wxcy` | String | （可能为空） | 五行穿衣 |
## 吉神凶煞接入点（856-4）返回字段
| 字段 | 类型 | 示例 | 说明 |
|------|------|------|------|
| `yuezhi` | String | 子水 | 月支 |
| `yueqisha` | String | 午 | 月七煞 |
| `fantaisui` | String | 鼠、马、羊、兔 | 犯太岁 |
| `esbx` | String | 东方尾宿尾火虎(吉) | 二十八宿 |
| `caishen` | String | 正北 | 财神 |
| `yuesansha` | String | 南 三煞巳午未 丙丁坐煞 | 月三煞 |
| `niansansha` | String | 南 三煞巳午未 丙丁坐煞 | 年三煞 |
| `jiuxing` | String | 七赤咸池金星(凶) | 九星 |
| `nianqisha` | String | 午 | 年七煞 |
| `wuhou` | String | 水泉动 | 物候 |
| `rilu` | String | 午命互禄 乙命进禄 | 日禄 |
| `rikongwang` | String | 申酉 | 日空亡 |
| `zhongdong` | String | 仲冬 | 仲冬 |
| `niankongwang` | String | 辰巳 | 年空亡 |
| `suipowei` | String | 正南 | 岁破位 |
| `risansha` | String | 西 三煞申酉戌 庚辛坐煞 | 日三煞 |
| `niantaisui` | String | 卢秘星君 | 年太岁 |
| `zhishen12` | String | 玉堂 ― 吉：俗称"大黄道日"… | 十二值神 |
| `zhiri12` | String | 平执位 ― 凶：俗称"小黑道日"… | 十二值日 |
| `tjjs` | String | 寅,卯,午 | 推荐吉时 |
| `yueling` | String | 戊子 | 月令 |
| `msg` | String | 查询成功 | 描述 |
| `riqisha` | String | 酉 | 日七煞 |
| `xishen` | String | 东北 | 喜神 |
| `yinguishen` | String | 西南 | 阴贵神 |
| `fushen` | String | 正北 | 福神 |
| `yuexiang` | String | 宵月 | 月相 |
| `yuekongwang` | String | 午未 | 月空亡 |
| `yangguishen` | String | 正北 | 阳贵神 |
| `yjgx` | String | 水泽节 | 易经卦象 |
| `liuyao` | String | 先胜 ― 平(上午吉，下午凶)… | 六曜 |
| `taisuiwei` | String | 正北 | 太岁位 |
## 吉时接入点（856-3）返回字段
返回体除 `msg`、`ret_code`、`ut` 外，含 12 个时辰对象：`zi`(子时)、`chou`(丑时)、`yin`(寅时)、`mao`(卯时)、`chen`(辰时)、`si`(巳时)、`wu`(午时)、`wei`(未时)、`shen`(申时)、`you`(酉时)、`xu`(戌时)、`hai`(亥时)。
每个时辰对象字段一致：
| 字段 | 类型 | 示例 | 说明 |
|------|------|------|------|
| `jixiong` | String | 司命(吉) / 白虎(凶) | 吉凶 |
| `jishen` | String | 司命天乙贵人 | 吉神 |
| `shijian` | String | 23:00:00-0:59:59 | 时间 |
| `xiongshen` | String | 日刑 | 凶神 |
| `shichong` | String | 冲马 | 时冲 |
| `shizhu` | String | 甲子 | 时柱 |
## FAQ
**Q1：字段名看不懂，有没有更长的描述？**
A：各接入点详情页的「返回参数」已给出逐字段说明；本文是按文档整理的速查版。
**Q2：wxcy（五行穿衣）有时是空字符串？**
A：文档示例中该字段即返回空，属正常情况，展示时做空值兜底即可。
**Q3：吉时的 ret_code 在文档里标注为 String，但示例是数字 0，该按哪个判断？**
A：以取值语义为准：`ret_code == 0`（或字符串 `"0"`）均表示成功，建议代码中做宽松比较（见 [错误码排查](https://www.showapi.com/guides/huangli-error-codes-856)）。
**Q4：能不能一次返回三个接入点的数据？**
A：不能。三个接入点是独立接口地址（856-2/856-3/856-4），需分别调用；组合场景见 [择日场景](https://www.showapi.com/guides/huangli-date-selection-856)。
## 相关能力 / 下一步阅读
- [黄历查询接入点详解：宜忌、冲煞、值神怎么用](https://www.showapi.com/guides/huangli-day-almanac-856) —— 856-2 字段的业务落地。
- [吉时查询接入点：如何给用户推荐当日吉时](https://www.showapi.com/guides/huangli-auspicious-hours-856) —— 856-3 十二时辰解析。
- [吉神凶煞查询接入点：财神喜神方位与择日应用](https://www.showapi.com/guides/huangli-deities-856) —— 856-4 神煞方位实战。
- **本系列共 11 篇**：查看[黄历运势指南总目录](https://www.showapi.com/guides/huangli-guides-856)
