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 DragonFavourable
KangNeck金 Azure DragonDisputedSources disagree: some list it as favourable for marriage, others call it inauspicious; the two readings are both published.
DiRoot土 Azure DragonTaboo
FangRoom日 Azure DragonFavourable
XinHeart月 Azure DragonTaboo
WeiTail火 Azure DragonFavourable
JiWinnowing Basket水 Azure DragonDisputedMost sources rate the mansion auspicious but do not name marriage among its uses.
DouDipper木 Black TortoiseDisputedMost sources rate the mansion auspicious but do not name marriage among its uses.
NiuOx金 Black TortoiseTaboo
NuGirl土 Black TortoiseTaboo
XuEmptiness日 Black TortoiseTaboo
WeiRooftop月 Black TortoiseTaboo
ShiEncampment火 Black TortoiseFavourable
BiWall水 Black TortoiseFavourable
KuiLegs木 White TigerTaboo
LouBond金 White TigerFavourable
WeiStomach土 White TigerFavourable
MaoHairy Head日 White TigerTaboo
BiNet月 White TigerFavourable
ZiTurtle Beak火 White TigerTaboo
ShenThree Stars水 White TigerTaboo
JingWell木 Vermilion BirdDisputedSources disagree: some list marriage as taboo, others treat the mansion as auspicious.
GuiGhost金 Vermilion BirdTaboo
LiuWillow土 Vermilion BirdTaboo
XingStar日 Vermilion BirdDisputedSources disagree: some list it as favourable for marriage, others as inauspicious.
ZhangExtended Net月 Vermilion BirdFavourable
YiWings火 Vermilion BirdTaboo
ZhenChariot水 Vermilion BirdFavourable

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

School differences (stated, not silently picked)

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