Wedding Date Picker — Every Day Scored by Rule

Give the engine two birth dates and a window and it computes, day by day: the officer of the day, the day spirit, the ruling mansion of the 28, red phoenix and heavenly joy days, and every clash, harmony, harm and punishment against both partners. Five hard conditions first, then a weighted sum in which every term is printed with the reading that fired it.

Find candidate dates

The birth hour only enters through the natal day branch, and only for births between 23:00 and midnight (this engine switches the day at the zi hour); noon is fine otherwise. Dates are treated as Beijing civil time. A run covers up to 800 days.

The rules: five hard conditions plus fifteen weighted terms

A day that fails a hard condition is out, with no score; the rest are summed by weight. The score starts at 60, adds favourable terms, subtracts the others, and is clamped to 0–100; tiers are cut at 85 / 70 / 55. The weights are ours, and they are all listed below — you can reject them and read the per-term output instead.

Hard exclusions (any hit disqualifies)

ConditionStructural definition
Month breakerThe day branch clashes the month branch (officer offset 6)
Year breakerThe day branch clashes the year branch of the wedding year
Clash with a natal day branchThe day branch of either partner’s birth day is clashed
Clash with a birth-year branchThe zodiac branch of either partner is clashed
Closing dayThe officer is Bi, the closing seat (offset 11)

Weighted terms

TermWeightReading
Officer: Ding / Cheng / Kai+14Three officer days that sources call first choice
Officer: Chu / Zhi / Wei+6Yellow-path days where sources split, mild positive
Officer: Shou-4Black path, yet the classic verse assigns marriage to it
Officer: Jian / Man / Ping-18Widely avoided for weddings
Day spirit on the yellow path+8Colour of the day from the spirit cycle
Officer classified as yellow path+5The other, independent colour system
Mansion favourable for marriage (10 of 28)+12Jiao, Fang, Wei, Shi, Bi, Lou, Wei, Bi, Zhang, Zhen
Mansion taboo for marriage (13 of 28)-14Di, Xin, Niu, Nu, Xu, Wei, Kui, Mao, Zi, Shen, Gui, Liu, Yi
Red Phoenix day / Heavenly Joy day+9Anchored on the year branch; the two are opposite, so only one can hit
Heavenly Pardon day+7Spring Wu Yin / Summer Jia Wu / Autumn Wu Shen / Winter Jia Zi
Six Harmony with a natal day branch+9Counted once per partner
Three Harmony with a natal day branch+6Counted once per partner
Six / Three Harmony with a year branch+5Year-branch harmony (trine adds +3)
Harm / Punishment with a natal day branch-5Harm -5, punishment -6 (a pair can be both, e.g. Si-Shen)
Lone Star / Widow Star day-11Groom-Lone and bride-Widow carry the main weight; the reverse pairs weigh -4

The twelve officers against marriage

The twelve officers come from one formula: the month branch is the Jian seat, and the offset to the day branch is the officer (offset 6 being the break day that clashes the month). Almanacs do not agree on which of the twelve suit a wedding; the rows marked disputed are exactly where they differ, and the weight follows the majority reading.

OfficerFor marriageWeightNote
建 JianWidely avoided-18Jian is the month-establishing day; most sources advise against weddings.
除 ChuSources split+6Chu removes the old; sources split between favourable and taboo for marriage.
满 ManWidely avoided-18Man means fullness and overflow; most sources avoid it for weddings.
平 PingWidely avoided-18Ping is level and uneventful; most sources exclude it for weddings.
定 DingFirst choice+14Ding means settled and sworn; a first-choice officer for weddings.
执 ZhiSources split+6Zhi means holding fast; most sources allow weddings, some avoid it as a closing day.
破 PoWidely avoided-18Po breaks the month; traditionally a major taboo (already excluded here).
危 WeiSources split+6Wei is a yellow-path day; most sources allow betrothal and marriage, some avoid it by name.
成 ChengFirst choice+14Cheng means completion; a first-choice officer for weddings.
收 ShouSources split-4Shou is a black-path day, yet the classic verse assigns marriage to it; both readings shown.
开 KaiFirst choice+14Kai opens a new stage; a first-choice officer for weddings.
闭 BiWidely avoided-18Bi closes; unsuitable for starting anything, a major taboo (already excluded here).

The twelve day spirits: a second colour system

The twelve spirits cycle in a fixed order whose start is set by the month branch, from the mnemonic “Yin and Shen months start at Zi, Mao and You at Yin, Chen and Xu at Chen, Si and Hai at Wu, Zi and Wu at Shen, Chou and Wei at Xu” — equivalent to the closed form: spirit index = (day branch + 4 − 2 × month branch) mod 12. This page reconciles against the calendar library over 900 consecutive days with zero mismatches.

SpiritColourWeightReading
青龙 Qing LongYellow path+8Azure Dragon
明堂 Ming TangYellow path+8Bright Hall
天刑 Tian XingBlack path-8Heavenly Punishment
朱雀 Zhu QueBlack path-8Vermilion Bird
金匮 Jin KuiYellow path+8Golden Coffer
天德 Tian DeYellow path+8Heavenly Virtue
白虎 Bai HuBlack path-8White Tiger
玉堂 Yu TangYellow path+8Jade Hall
天牢 Tian LaoBlack path-8Heavenly Prison
玄武 Xuan WuBlack path-8Dark Warrior
司命 Si MingYellow path+8Life Controller
勾陈 Gou ChenBlack path-8Curled Earth

Starting rule (month branch to the Azure Dragon seat)

Month branchAzure Dragon seat (index 0)
寅 Yin / 申 Shen子 Zi
卯 Mao / 酉 You寅 Yin
辰 Chen / 戌 Xu辰 Chen
巳 Si / 亥 Hai午 Wu
子 Zi / 午 Wu申 Shen
丑 Chou / 未 Wei戌 Xu

The two colour systems are two independent cycles: across all 144 month-branch by day-branch combinations they agree on only 72 — exactly 50.0 percent. So “today is a yellow-path day” is a statement that has to name its system first. This page computes both and flags, for every day, whether they agreed.

The 28 mansions against marriage

One mansion rules one day, cycling every 28 days: this page derives the ruling mansion as (Julian day number + 11) mod 28 and reconciles with the calendar library over 900 consecutive days with zero mismatches. Both the seven luminaries (wood, metal, earth, sun, moon, fire, water) and the four beasts (one per group of seven) are derived from the index rather than copied, and the test cross-checks them character by character against an external per-mansion table.

MansionNameLuminary / beastRatingMarriageSource note
角 JiaoHorn木 Azure Dragon吉Favourable—
亢 KangNeck金 Azure Dragon凶DisputedSources disagree: some list it as favourable for marriage, others call it inauspicious; the two readings are both published.
氐 DiRoot土 Azure Dragon凶Taboo—
房 FangRoom日 Azure Dragon吉Favourable—
心 XinHeart月 Azure Dragon凶Taboo—
尾 WeiTail火 Azure Dragon吉Favourable—
箕 JiWinnowing Basket水 Azure Dragon吉DisputedMost sources rate the mansion auspicious but do not name marriage among its uses.
斗 DouDipper木 Black Tortoise吉DisputedMost sources rate the mansion auspicious but do not name marriage among its uses.
牛 NiuOx金 Black Tortoise凶Taboo—
女 NuGirl土 Black Tortoise凶Taboo—
虚 XuEmptiness日 Black Tortoise凶Taboo—
危 WeiRooftop月 Black Tortoise凶Taboo—
室 ShiEncampment火 Black Tortoise吉Favourable—
壁 BiWall水 Black Tortoise吉Favourable—
奎 KuiLegs木 White Tiger平Taboo—
娄 LouBond金 White Tiger吉Favourable—
胃 WeiStomach土 White Tiger平Favourable—
昴 MaoHairy Head日 White Tiger平Taboo—
毕 BiNet月 White Tiger吉Favourable—
觜 ZiTurtle Beak火 White Tiger凶Taboo—
参 ShenThree Stars水 White Tiger平Taboo—
井 JingWell木 Vermilion Bird平DisputedSources disagree: some list marriage as taboo, others treat the mansion as auspicious.
鬼 GuiGhost金 Vermilion Bird凶Taboo—
柳 LiuWillow土 Vermilion Bird凶Taboo—
星 XingStar日 Vermilion Bird平DisputedSources disagree: some list it as favourable for marriage, others as inauspicious.
张 ZhangExtended Net月 Vermilion Bird吉Favourable—
翼 YiWings火 Vermilion Bird平Taboo—
轸 ZhenChariot水 Vermilion Bird吉Favourable—

Our mansion ratings agree with the calendar library on 21 of 28; the seven disagreements are exactly the ones marked mixed above, i.e. the seven where the sources conflict. Leaving disagreements visible is the point.

Known limits

  • Four separations and four severances are not implemented — Traditional selection rules out the day before each equinox and solstice (the four separations) and the day before each season-start (the four severances). Computing them needs a table of all 24 solar-term instants, and there is no astronomy library in the browser — this site only ships the Start of Spring table used for the year pillar. The gap is stated rather than papered over.
  • Schools not implemented — The marriage hall diagram, the couple’s “great months”, bride-specific taboo days and mansion-hour pairings each form their own system; none is folded into the score here.
  • Not a prediction — What this page outputs is the property of a date under a published rule set — not a prediction about a marriage, and not advice.

School differences (stated, not silently picked)

  • Which officers suit a wedding — Almanacs differ on which officers suit a wedding: Ding, Cheng and Kai are widely listed first, Jian, Man, Ping, Po and Bi widely avoided, while Chu, Zhi, Wei and Shou are disputed — Shou most of all, since the classic verse assigns marriage to it while the black-path reading advises against it.
  • Two colour systems — The officer method and the day-spirit method are independent cycles agreeing on 72 of 144 combinations (50.0 percent).
  • Mansions and marriage — Five of the 28 mansions have conflicting sources (Kang, Ji, Dou, Jing, Xing); they are marked disputed, carry weight 0, and are not silently resolved.
  • Lone and widow stars — The main reading is that a groom fears the lone star and a bride the widow star; those carry the main weight here, while the reverse pairs are shown with a lower weight.

FAQ

How does this page pick a wedding date?
Five hard conditions exclude a day outright: month breaker, year breaker, a clash with either partner’s natal day branch, a clash with either birth-year branch, and the closing officer day. Surviving days are then scored on fifteen terms: the twelve officers, the twelve day spirits, the officer colour system, the 28 mansions, red phoenix and heavenly joy days, the heavenly pardon day, six and three harmony with both partners, harm and punishment, and the lone and widow stars. The score starts at 60, adds the favourable terms and subtracts the rest, clamped to 0–100.
Why a score instead of a plain auspicious or inauspicious verdict?
Because the verdict itself is not agreed on between schools and almanacs. The whole weight table is on this page, and every result lists the terms that fired. You can disagree with our weights and still see every input — which is the difference from an almanac that states a verdict with no derivation.
What is a break day, and why is it excluded outright?
One structural line defines it: the day whose branch clashes the month branch — offset 6 in the twelve-officer cycle, the seat named Break. If the day branch clashes the year branch instead, that is a year breaker. Traditional date selection treats both as major taboos, so this page excludes them rather than scoring them.
Why are there two colour systems for the day, and why do they often disagree?
They are two independent cycles. One is built on the twelve officers (the verse: Jian, Man, Ping, Shou are black; Chu, Wei, Ding, Zhi are yellow; Cheng and Kai are usable; Bi and Po stand alone). The other is the twelve day spirits, whose starting rule is Yin and Shen months start at Zi, Mao and You at Yin, Chen and Xu at Chen, Si and Hai at Wu, Zi and Wu at Shen, Chou and Wei at Xu. Across all 144 month-branch by day-branch combinations the two agree on only 72 — exactly 50.0 percent, i.e. statistically independent. This page computes and shows both, and marks whether they agreed on the day you are looking at.
Is a top pick here the same as an almanac’s suitable-for-marriage day?
No. Almanac advice is derived from its own shen-sha combinations; this page publishes a rule list instead. In a full-year 2026 run, 28 of the 69 days we rated 70 or higher (40.6 percent) carried a marriage-favourable tag in the calendar library we reconcile against, versus a 34.2 percent baseline across all 365 days — a mild positive tilt, not the same thing. We show the rules and the gap rather than pretending two systems agree.

Reference