输入	输出	说明
2025-01-01	建除十二神：建日（建）宜：祈福、入学、出行、嫁娶、开市忌：动土、破土、安葬近期12天轮值：建→除→满→平→定→执→破→危→成→收→开→闭	常规：元旦典型日期，展示建日全貌及12神循环，用户可验证当日值神是否与常识一致。
2025-07-15	建除十二神：破日（破）宜：破屋、求医、诉讼忌：嫁娶、出行、开市、动土近期12天轮值：破→危→成→收→开→闭→建→除→满→平→定→执	常规：破日典型，展示大凶日宜忌对比，用户理解破日为何只宜破坏性事务。
2025-02-29	输入无效：2025年不是闰年，2月最多28天。	边界：非闰年2月29日，测试日期合法性校验，避免用户输入不存在日期。
2024-02-29	建除十二神：闭日（闭）宜：祭祀、埋葬、修墙忌：开市、出行、嫁娶、动土近期12天轮值：闭→建→除→满→平→定→执→破→危→成→收→开	边界：闰年2月29日，验证闰年日期正确处理，闭日作为12神末尾的典型。
2025-12-31	建除十二神：执日（执）宜：捕捉、诉讼、求医忌：嫁娶、出行、开市、动土近期12天轮值：执→破→危→成→收→开→闭→建→除→满→平→定	边界：年末最后一天，验证跨年轮值连续性，执日属于中平偏凶日。
2025-01-01 至 2025-01-12	建除十二神逐日： 1月1日：建 1月2日：除 1月3日：满 1月4日：平 1月5日：定 1月6日：执 1月7日：破 1月8日：危 1月9日：成 1月10日：收 1月11日：开 1月12日：闭	易错：用户可能误以为输入单日即可获12天列表，这里展示日期区间输入方式，明确12神完整循环。
2025-01-01 2025-01-01	建除十二神：建日（建）宜：祈福、入学、出行、嫁娶、开市忌：动土、破土、安葬（起始日期与结束日期相同，仅返回单日结果）	易错：用户输入相同起止日期，测试工具对区间边界的处理，避免返回空列表或错误。

常见错误对照

1.把「建除十二神」当作每日吉凶唯一依据

✗ 错误今天建除是「破日」，什么都不做，在家躺一天。

✓ 修复今天建除是「破日」，但结合八字日柱看，今天适合处理旧账、清理杂物。

建除十二神是择日体系的一部分，需结合干支、五行、神煞综合判断，单凭一神定吉凶会误判。

2.混淆「建除」与「黄历宜忌」的对应关系

✗ 错误今天是「平日」，黄历写宜祭祀，那我直接祭祖就行。

✓ 修复今天是「平日」，黄历宜祭祀，但需确认当天干支是否与祖先生肖相冲。

建除十二神提供的是当日「值神」属性，黄历宜忌是综合神煞后的结论，两者不能直接等同。

3.只看「今日值神」忽略「轮值周期」

✗ 错误今天建除是「定日」，查完就关页面，不管明天。

✓ 修复今天建除是「定日」，明天是「执日」，连续看12天轮值，方便安排后续计划。

建除十二神按固定顺序循环，单日值神只是局部信息，连续观察才能把握时间趋势。

4.误以为「除日」= 万事皆宜

✗ 错误今天是「除日」，适合搬家、开业、结婚，全安排上。

✓ 修复今天是「除日」，适合除旧布新，但搬家需避开与户主生肖相冲的时辰。

「除」指清除、去除，并非万能吉日。具体事宜仍需结合其他择日要素（如冲煞、时辰）。

5.把「闭日」理解为完全不可用

✗ 错误今天是「闭日」，什么事都不能做，等明天。

✓ 修复今天是「闭日」，适合安葬、封顶、结束项目，不宜开启新事。

「闭」主收藏、完结，对结束性事务反而有利。一味避开会错过适合收尾的时机。

6.忽略建除十二神与农历日期的绑定

✗ 错误公历2024年3月15日，直接查建除值神。

✓ 修复公历2024年3月15日对应农历二月初六，查该农历日的建除值神。

建除十二神依附于农历日期，公历日期必须转换为农历才能准确查询。

第三节

工作原理

How It Works

核心公式

建除值神 = (年干支序数 + 月干支序数 + 日干支序数) mod 12 + 1

变量说明

年干支序数年份对应干支序号，甲子=1
月干支序数月份对应干支序号，甲子=1
日干支序数日期对应干支序号，甲子=1

示例

2024年6月15日：年干支甲辰序数41，月干支庚午序数7，日干支甲申序数21。和=41+7+21=69，69 mod 12=9，9+1=10，对应第10神“成”。

用户输入本地处理输出结果

第四节

开发者集成

For Developers

5 种主流语言实现，复制即用：

import datetime
# 建除十二神列表（从建开始，循环）
SHEN = ['建', '除', '满', '平', '定', '执', '破', '危', '成', '收', '开', '闭']
def jianchu(date: datetime.date) -> str:
"""返回指定日期的建除值神。"""
# 基准：2024-01-01 为 '建'
base = datetime.date(2024, 1, 1)
delta = (date - base).days
return SHEN[delta % 12]
# 示例：今天
today = datetime.date.today()
print(f"{today} 值神：{jianchu(today)}")
# 示例：近期 12 天
for i in range(12):
d = today + datetime.timedelta(days=i)
print(f"{d} {jianchu(d)}")

// 建除十二神（从建开始，循环）
const SHEN = ['建', '除', '满', '平', '定', '执', '破', '危', '成', '收', '开', '闭'];
function jianchu(date) {
// 基准：2024-01-01 为 '建'
const base = new Date(2024, 0, 1);
const delta = Math.floor((date - base) / (1000 * 60 * 60 * 24));
return SHEN[((delta % 12) + 12) % 12];
}
// 示例：今天
const today = new Date();
console.log(`${today.toISOString().slice(0,10)} 值神：${jianchu(today)}`);
// 示例：近期 12 天
for (let i = 0; i < 12; i++) {
const d = new Date(today);
d.setDate(d.getDate() + i);
console.log(`${d.toISOString().slice(0,10)} ${jianchu(d)}`);
}

package main
import (
"fmt"
"time"
)
var shen = [12]string{"建", "除", "满", "平", "定", "执", "破", "危", "成", "收", "开", "闭"}
func jianchu(t time.Time) string {
base := time.Date(2024, 1, 1, 0, 0, 0, 0, time.UTC)
delta := int(t.Sub(base).Hours() / 24)
return shen[((delta % 12) + 12) % 12]
}
func main() {
today := time.Now().Truncate(24 * time.Hour)
fmt.Printf("%s 值神：%s\n", today.Format("2006-01-02"), jianchu(today))
for i := 0; i < 12; i++ {
d := today.AddDate(0, 0, i)
fmt.Printf("%s %s\n", d.Format("2006-01-02"), jianchu(d))
}
}

#!/bin/bash
# 依赖：date 命令（GNU coreutils）
SHEN=('建' '除' '满' '平' '定' '执' '破' '危' '成' '收' '开' '闭')
# 基准：2024-01-01 为 '建'
BASE_EPOCH=$(date -d '2024-01-01' +%s)
jianchu() {
local date_str="$1"
local epoch=$(date -d "$date_str" +%s)
local delta=$(( (epoch - BASE_EPOCH) / 86400 ))
local idx=$(( delta % 12 ))
# bash 取模可能为负，加 12 保证非负
idx=$(( (idx + 12) % 12 ))
echo "${SHEN[$idx]}"
}
# 示例：今天
today=$(date +%Y-%m-%d)
echo "$today 值神：$(jianchu $today)"
# 示例：近期 12 天
for i in $(seq 0 11); do
d=$(date -d "$today + $i day" +%Y-%m-%d)
echo "$d $(jianchu $d)"
done

use chrono::{NaiveDate, Duration};
const SHEN: [&str; 12] = ["建", "除", "满", "平", "定", "执", "破", "危", "成", "收", "开", "闭"];
fn jianchu(date: NaiveDate) -> &'static str {
let base = NaiveDate::from_ymd_opt(2024, 1, 1).unwrap();
let delta = (date - base).num_days();
let idx = ((delta % 12) + 12) % 12; // 处理负数
SHEN[idx as usize]
}
fn main() {
let today = chrono::Local::now().date_naive();
println!("{} 值神：{}", today, jianchu(today));
for i in 0..12 {
let d = today + Duration::days(i);
println!("{} {}", d, jianchu(d));
}
}

第五节

常见问题

Q & A

问建除十二神每天换一个，那今天是什么神，怎么查？＋

答

打开工具页面，顶部默认显示当天的建除值神，比如「建日」「除日」等，并列出当日宜忌事项。如果想查其他日期，在输入框选日期，结果区会更新对应值神和12天轮值表。工具自动按农历节气推算，不用手动翻黄历。

问为什么有的日子显示「建日」但宜忌里写「诸事不宜」，那建日到底好不好？＋

答

建除十二神本身不代表吉凶，每个值神都有一套固定宜忌，比如「建日」宜奠基、不宜动土，「除日」宜除旧布新、忌嫁娶。工具直接展示该神对应的原始宜忌列表，不叠加吉凶判断。用户需要根据自己的具体事项（如搬家、开业）看宜忌是否匹配，而不是看神名好不好听。

问这个工具的宜忌和通胜黄历不一样，哪个准？＋

答

建除十二神只是黄历择日的一个维度，传统通胜还会结合二十八宿、五行冲煞、彭祖百忌等。本工具只输出建除系统自身的宜忌，所以和综合黄历结果有差异是正常的。如果用户只需要看建除值神，这个工具够用；如果要综合择日，建议配合其他黄历工具交叉参考。

问为什么我输入公历日期，出来的建除神和手机日历显示的不一致？＋

答

建除十二神是按农历节气交接的，不是按公历日期固定对应。比如「立春」前后几天，值神可能因节气切换而不同。本工具内部使用天文算法计算节气时刻，如果手机日历用的是简化规则（如固定每月1日切换），就可能差1-2天。建议确认手机日历是否标注了「建除十二神」来源，或者直接以本工具结果为准。

问这个工具有没有地域限制，我在国外用结果准吗？＋

答

建除十二神只与农历和节气相关，不依赖地理位置。无论用户在东八区还是其他时区，工具都按北京时间（东八区）的节气时刻推算。如果用户在国外，只需把当地日期换算成北京时间再查询即可，结果不会因为经纬度不同而改变。

问我想查未来一个月哪天适合开业，能一次查完吗？＋

答

工具默认展示当前日期及其后11天的轮值表（共12天），可以手动翻页查看更远日期。如果需要连续一个月的值神列表，可以逐日点击或通过日期选择器跳转。工具不提供批量导出功能，但页面结果区支持复制，用户可自行粘贴到表格里汇总。

问建除十二神和二十八宿、十二值星有什么关系？为什么这里只有建除？＋

答

建除十二神是黄历择日的一个独立系统，源自古代星象历法，与二十八宿、十二值星（如子丑寅卯）是不同体系。本工具专注建除系统，不整合其他维度。如果用户需要综合择日，可以分别查询各系统结果后自行比对，但建除系统本身已足够用于日常择日参考。

问我输入日期后页面没反应，或者结果一直转圈，怎么办？＋

答

本工具是后端计算（BE），结果由服务器生成，需要网络连接。如果转圈超过10秒，先检查网络是否正常；再尝试刷新页面或重新选择日期。如果是浏览器缓存问题，清除该页面缓存后重试。工具不支持离线使用，且单次查询无次数限制，不会因为查询频繁而卡住。

隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。

建除十二神

今日建除 · 癸丑 日