销售经理要去外地见客户，公司行政订了两间备选房：一间 1208，一间 1216。他平时比较在意数字风水，但手头没有万年历。用本工具查两间房号对应的今日九星方位——1208 落在九紫火星位（西南），主喜庆姻缘，但出差谈业务不适用；1216 落在六白武曲金星位（西北），主贵人提携、财运提升。果断选了 1216，入住后客户当场签了意向书。

叁

合伙人签约看时辰

两个朋友准备合伙开餐饮店，选在周三下午去工商局签协议。其中一人查了当日九星为七赤破军金星，属凶星，主口舌是非、破财。但当天是唯一能预约的时间，改不了日期。用本工具细看七赤金星的具体宜忌：发现其吉时应为「酉时」（17-19 点），方位在正西。两人把签约时间从下午 2 点改到 5 点半，并特意选了正西方向的窗口座位。签约过程顺利，后续经营也未出现合伙纠纷。

肆

搬家入宅选吉位

一对夫妻买了二手房，搬家日期定在周末。搬家师傅问家具放哪个房间，两人拿不准主卧床头朝哪。用本工具查当日九星：二黑巨门土星飞临正南，属病符星，主疾病；三碧禄存木星飞临正东，属蚩尤星，主官非。而九紫火星飞临正北，属喜星，主姻缘和睦。两人决定把主卧床放在正北房间，床头朝北，搬家后夫妻关系明显缓和。

伍

店铺开业选促销日

奶茶店主计划在月底做一次大型促销活动，但月底那周有三天可选：周一、周三、周五。店长用本工具查这三天的九星：周一为一白水星，属吉，主利财运，但方位在正南（店铺大门朝南），对应；周三为四绿文曲星，属吉，主文昌，但奶茶店不靠文化；周五为八白左辅星，属大吉，主正财，方位在东北（店铺收银台在东北）。最终选周五，当天营业额比平时翻了 3 倍。

对比矩阵

维度	本工具	竞品 A（万年历App）	传统方法（手工查历书）
查询速度	秒级返回，无需等待	需加载App或网页，有广告延迟	翻书查阅，耗时数分钟
数据完整性	今日九星 + 9星曜方位/五行/八卦/吉凶宜忌一次展示	仅显示当日九星，无详细星曜属性	需自行推算或查找多本历书
隐私	纯浏览器处理，数据不上传服务器	需联网，数据经服务器	无隐私问题，完全离线
离线可用	页面加载后完全离线可用	需联网使用	始终离线
操作复杂度	打开即用，无需输入	需打开App、点击多个入口	需熟悉历书编排规则
更新频率	自动按系统时间更新	每日更新，但需联网同步	需购买新历书或手动推算

第二节

使用指南

Getting Started

使用步骤

1在日期选择器中点击或输入目标日期，页面立即显示该日对应的值年、值月、值日、值时九星
2点击任意一颗星曜名称（如一白水星），展开该星的五行、八卦、方位及当日吉凶宜忌详情
3勾选「显示方位图」复选框，页面以九宫格形式展示九星在当日各方位分布，鼠标悬停查看具体星曜
4点击「导出」按钮将当前查询结果（含日期、九星列表、宜忌）保存为 CSV 文件，供本地存档或对比

输入输出示例

输入	输出	说明
2025-10-01	日九星：六白武曲星（金）—— 西北方，乾卦，宜求财、开市、嫁娶	常规：典型日期查询，展示日九星完整输出（星曜、五行、方位、卦象、宜忌）
2025-10-01 12:00	时九星：九紫右弼星（火）—— 南方，离卦，宜祭祀、祈福、修造	常规：带具体时刻查询时九星，验证时间精度（小时级）
2025-10-01 23:30	时九星：一白水星（水）—— 北方，坎卦，宜嫁娶、交易、安床	边界：跨日子时（23:00-01:00）的时九星归属，验证子时是否归入当日或次日
2025-02-29	错误提示：2025年不是闰年，2月最多28天	边界：非法日期（非闰年2月29日），验证输入校验逻辑
2025-13-01	错误提示：月份必须在1-12之间	边界：月份超出范围，验证前端/后端对月份边界的处理
2025-10-01 25:00	错误提示：小时必须在0-23之间	易错：用户常输入24小时制外的数值（如25点），需明确提示范围
2025-10-01 12:60	错误提示：分钟必须在0-59之间	易错：分钟超出范围，验证分钟校验是否独立于小时
2025-10-01 00:00	时九星：一白水星（水）—— 北方，坎卦，宜嫁娶、交易、安床	易错：午夜0点属于当日第一个时辰（子时），验证与23:00-23:59的时九星是否不同

常见错误对照

1.混淆「今日九星」与「本命星」

✗ 错误查今日九星结果是一白水星，就认为自己的本命星是一白水星。

✓ 修复今日九星是当日值星，与个人出生年份的本命星无关；本命星需按年命推算。

九星查询分「值年」「值月」「值日」「值时」四种，页面默认显示的是当日值星，不是个人命盘星。

2.把「方位」当作物理位置而非时空方位

✗ 错误今日九星一白在正北，就认为自己在正北方向能得吉。

✓ 修复

一白水星在正北，指该星曜的卦位是坎（正北），并非当日吉方；吉凶宜忌需结合当日九星与用事方位综合判断。

九星方位是八卦方位（坎/坤/震等），不是当日「吉利方位」。真正择日用事要看「飞星盘」中星曜落宫。

3.忽略「五行」与「宜忌」的联动关系

✗ 错误今日九星为六白金星，宜「开业」，就盲目开业，不顾自己八字忌金。

✓ 修复先看六白金星五行属金，再查个人八字是否喜金；若忌金，则当日不宜做与金相关之事。

九星宜忌是通用参考，个人用事必须结合自身八字喜忌，否则星曜吉也可能反成凶。

4.把「九紫火星」的「火」当作火灾预兆

✗ 错误今日九紫火星当值，认为家里容易失火。

✓ 修复九紫火星五行属火，代表喜庆、桃花、文书，不是火灾。

九星名称中的五行是星曜属性，不是自然现象。九紫火星在择日学中主喜事，如嫁娶、入宅。

5.用「今日九星」代替「择日吉凶」

✗ 错误今日九星为八白土星（大吉），就认为今天做什么都吉利。

✓ 修复八白土星当日值星大吉，但具体事项（如动土、安葬）仍需看该事项的专用宜忌。

九星值日只是择日体系中的一环，还需结合干支、建除、二十八宿等，不能单凭九星定吉凶。

6.把「八卦」与「方位」一一对应死记

✗ 错误九紫火星在离卦，离卦代表南方，就认为九紫火星永远在南方。

✓ 修复九紫火星的卦位是离（南方），但飞星盘中的实际落宫会随年月日时变化，不一定在南方。

九星的「八卦方位」是固定本宫，但飞星运行时星曜会飞到不同宫位，本宫不等于当前方位。

7.忽略「吉凶宜忌」的时效性

✗ 错误查到今日九星宜「嫁娶」，就认为全天任何时辰都适合嫁娶。

✓ 修复宜「嫁娶」指当日整体适宜，具体时辰还需结合时辰九星、冲煞等。

九星值日只定日层面吉凶，时辰层面有「时家九星」「时家奇门」等更细规则，不能以日概时。

第三节

工作原理

How It Works

核心公式

年九星 = (年数 + 6) mod 9，结果 0 对应九紫火星

变量说明

年数公历年份，如 2025
年九星0–8 对应九紫至八白土星

示例

2025 年：年九星 = (2025 + 6) mod 9 = 2031 mod 9 = 6。6 对应七赤金星（破军星），为当年值年星，主口舌破财，宜静不宜动。

用户输入查表/推导输出结果

第四节

开发者集成

For Developers

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

import datetime
# 紫白九星：根据日干支推算当日九星（一白至九紫）
# 算法：日干支数 mod 9，余数对应星曜（1=一白，2=二黑，...，9=九紫）
def day_ganzhi_index(year, month, day):
# 计算日干支序号（0~59），使用蔡勒公式变体
if month < 3:
month += 12
year -= 1
a = year // 100
b = a // 4
c = 2 - a + b
d = int(365.25 * (year + 4716))
e = int(30.6001 * (month + 1))
jd = d + e + day + c - 1524.5
# 日干支序号 = (JD - 11) % 60
return int((jd - 11) % 60)
def jiuxing_today():
today = datetime.date.today()
idx = day_ganzhi_index(today.year, today.month, today.day)
# 日干支序号 mod 9，0 对应九紫
star_num = (idx % 9) or 9
stars = {
1: '一白水星', 2: '二黑土星', 3: '三碧木星',
4: '四绿木星', 5: '五黄土星', 6: '六白金星',
7: '七赤金星', 8: '八白土星', 9: '九紫火星'
}
return stars[star_num]
print(jiuxing_today()) # 例：三碧木星（取决于运行日期）

// 浏览器或 Node.js 中计算当日紫白九星
// 使用日干支序号 mod 9 映射星曜
function dayGanzhiIndex(year, month, day) {
// 计算儒略日，再转日干支序号
if (month < 3) { month += 12; year -= 1; }
const a = Math.floor(year / 100);
const b = Math.floor(a / 4);
const c = 2 - a + b;
const d = Math.floor(365.25 * (year + 4716));
const e = Math.floor(30.6001 * (month + 1));
const jd = d + e + day + c - 1524.5;
return Math.floor((jd - 11) % 60);
}
function jiuxingToday() {
const now = new Date();
const idx = dayGanzhiIndex(now.getFullYear(), now.getMonth() + 1, now.getDate());
const starNum = (idx % 9) || 9; // 余0对应九紫
const stars = {
1: '一白水星', 2: '二黑土星', 3: '三碧木星',
4: '四绿木星', 5: '五黄土星', 6: '六白金星',
7: '七赤金星', 8: '八白土星', 9: '九紫火星'
};
return stars[starNum];
}
console.log(jiuxingToday()); // 例：四绿木星

package main
import (
"fmt"
"time"
)
// 计算日干支序号（0~59）
func dayGanzhiIndex(year, month, day int) int {
if month < 3 {
month += 12
year--
}
a := year / 100
b := a / 4
c := 2 - a + b
d := int(365.25 * float64(year+4716))
e := int(30.6001 * float64(month+1))
jd := d + e + day + c - 1524
return (jd - 11) % 60
}
func jiuxingToday() string {
now := time.Now()
idx := dayGanzhiIndex(now.Year(), int(now.Month()), now.Day())
starNum := idx % 9
if starNum == 0 {
starNum = 9
}
stars := map[int]string{
1: "一白水星", 2: "二黑土星", 3: "三碧木星",
4: "四绿木星", 5: "五黄土星", 6: "六白金星",
7: "七赤金星", 8: "八白土星", 9: "九紫火星",
}
return stars[starNum]
}
func main() {
fmt.Println(jiuxingToday()) // 例：五黄土星
}

#!/bin/bash
# 使用 date 和简单算术计算当日紫白九星（依赖 bc）
# 日干支序号 = (JD - 11) % 60，再 mod 9 得星曜
year=$(date +%Y)
month=$(date +%m)
day=$(date +%d)
# 蔡勒公式变体计算儒略日
if [ $month -lt 3 ]; then
month=$((month + 12))
year=$((year - 1))
fi
a=$((year / 100))
b=$((a / 4))
c=$((2 - a + b))
d=$(echo "365.25 * ($year + 4716)" | bc | cut -d. -f1)
e=$(echo "30.6001 * ($month + 1)" | bc | cut -d. -f1)
jd=$((d + e + day + c - 1524))
idx=$(((jd - 11) % 60))
star_num=$((idx % 9))
[ $star_num -eq 0 ] && star_num=9
case $star_num in
1) star="一白水星";;
2) star="二黑土星";;
3) star="三碧木星";;
4) star="四绿木星";;
5) star="五黄土星";;
6) star="六白金星";;
7) star="七赤金星";;
8) star="八白土星";;
9) star="九紫火星";;
esac
echo $star # 例：六白金星

第五节

常见问题

Q & A

问查出来的九星方位是今天的还是现在的？＋

答

默认显示当前日期的九星方位。如果需要在特定日子做决策（比如搬家、开业），可以在页面上手动选择日期，工具会重新计算那一天的九星分布。方位以正北为0度，顺时针计算，结果中会同时显示八卦宫位（如坎宫、离宫）和度数范围，方便结合罗盘或手机指南针定位。

问九星的吉凶宜忌是固定的还是每天变的？＋

答

每颗星曜的五行、八卦属性是固定的，但每天的吉凶宜忌会随着它飞临的宫位（方位）变化。比如五黄廉贞星（戊己土）本身是凶星，但飞临不同宫位时凶的程度和应验事项不同。工具给出的宜忌（如忌动土、宜嫁娶）综合了星曜本性和当日飞宫的生克关系，不是简单套模板。

问为什么查出来的结果和通胜（老黄历）上的九星不一样？＋

答

可能存在两个原因。一是起算规则不同：本工具使用标准的「紫白飞星」算法，以每年立春为年星起点，每月节气为月星起点；部分老黄历使用简化的「三元九运」排法，二者在年星和月星上可能差一位。二是日期范围不同：有些老黄历只显示「日九星」，而本工具同时提供年、月、日、时四柱九星，需要确认对比的是同一层级。

问时九星怎么算的？每个时辰都要自己选吗？＋

答

时九星按「日上起时」规则自动推算，不需要手动选时辰。工具根据当前日期推算出当日的时柱起点（甲子时），然后按顺序排出当天12个时辰（子时到亥时）各自的九星。结果列表会标注每个时辰的起止时间（如子时 23:00-00:59），直接看当前时辰或计划时辰对应的星曜即可。

问查出来的「宜嫁娶」是指当天还是那个时辰那个方位？＋

答

宜忌标注在日九星和时九星两个层面都有。日九星的宜忌适用于当天全天，时九星的宜忌只适用于该时辰（两小时）。比如日九星显示「宜嫁娶」，时九星显示「忌嫁娶」，则优先以时辰为准——建议在当天选一个时九星也「宜嫁娶」的时辰进行。方位则独立于时间，指当天该星曜所在宫位，嫁娶时避开凶星方位即可。

问输入日期后为什么有些宫位显示「无星」？＋

答

紫白九星排盘时，九颗星会按固定顺序飞入九个宫位，每个宫位必定会落一颗星，不会出现空宫。如果看到「无星」或空白，可能是以下原因：1）输入了无效日期（如未来太远或格式错误）；2）浏览器兼容问题导致计算结果未加载。可以尝试刷新页面或更换浏览器，如果问题持续，请反馈具体日期以便排查。

问手机上看方位准不准？需要手机支持什么传感器？＋

答

本工具查询的是理论九星方位（基于八卦二十四山），不调用手机传感器。结果中的方位是固定的地理方位关系（如一白水星在正北），你需要自己用手机指南针或罗盘确定实际方向。部分手机指南针受金属干扰或未校准，建议在室外空旷处校准后再对照工具给出的宫位度数。

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

九星查询

紫白九星完整查询

什么是紫白九星？

相关查询

关于本工具

使用场景

新房装修择日动工

出差订酒店选房号

合伙人签约看时辰

搬家入宅选吉位

店铺开业选促销日

对比矩阵

使用指南

使用步骤

输入输出示例

常见错误对照

工作原理

核心公式

变量说明

示例

开发者集成

常见问题

相关工具

太岁查询

纳音五行

彭祖百忌

二十八星宿

八字排盘

五行查询