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.
Every day that passed
| Date | Weekday | Day pillar | Officer | Spirit | Mansion | Score | Tier |
|---|
Days excluded
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)
| Condition | Structural definition |
|---|---|
| Month breaker | The day branch clashes the month branch (officer offset 6) |
| Year breaker | The day branch clashes the year branch of the wedding year |
| Clash with a natal day branch | The day branch of either partner’s birth day is clashed |
| Clash with a birth-year branch | The zodiac branch of either partner is clashed |
| Closing day | The officer is Bi, the closing seat (offset 11) |
Weighted terms
| Term | Weight | Reading |
|---|---|---|
| Officer: Ding / Cheng / Kai | +14 | Three officer days that sources call first choice |
| Officer: Chu / Zhi / Wei | +6 | Yellow-path days where sources split, mild positive |
| Officer: Shou | -4 | Black path, yet the classic verse assigns marriage to it |
| Officer: Jian / Man / Ping | -18 | Widely avoided for weddings |
| Day spirit on the yellow path | +8 | Colour of the day from the spirit cycle |
| Officer classified as yellow path | +5 | The other, independent colour system |
| Mansion favourable for marriage (10 of 28) | +12 | Jiao, Fang, Wei, Shi, Bi, Lou, Wei, Bi, Zhang, Zhen |
| Mansion taboo for marriage (13 of 28) | -14 | Di, Xin, Niu, Nu, Xu, Wei, Kui, Mao, Zi, Shen, Gui, Liu, Yi |
| Red Phoenix day / Heavenly Joy day | +9 | Anchored on the year branch; the two are opposite, so only one can hit |
| Heavenly Pardon day | +7 | Spring Wu Yin / Summer Jia Wu / Autumn Wu Shen / Winter Jia Zi |
| Six Harmony with a natal day branch | +9 | Counted once per partner |
| Three Harmony with a natal day branch | +6 | Counted once per partner |
| Six / Three Harmony with a year branch | +5 | Year-branch harmony (trine adds +3) |
| Harm / Punishment with a natal day branch | -5 | Harm -5, punishment -6 (a pair can be both, e.g. Si-Shen) |
| Lone Star / Widow Star day | -11 | Groom-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.
| Officer | For marriage | Weight | Note |
|---|---|---|---|
| 建 Jian | Widely avoided | -18 | Jian is the month-establishing day; most sources advise against weddings. |
| 除 Chu | Sources split | +6 | Chu removes the old; sources split between favourable and taboo for marriage. |
| 满 Man | Widely avoided | -18 | Man means fullness and overflow; most sources avoid it for weddings. |
| 平 Ping | Widely avoided | -18 | Ping is level and uneventful; most sources exclude it for weddings. |
| 定 Ding | First choice | +14 | Ding means settled and sworn; a first-choice officer for weddings. |
| 执 Zhi | Sources split | +6 | Zhi means holding fast; most sources allow weddings, some avoid it as a closing day. |
| 破 Po | Widely avoided | -18 | Po breaks the month; traditionally a major taboo (already excluded here). |
| 危 Wei | Sources split | +6 | Wei is a yellow-path day; most sources allow betrothal and marriage, some avoid it by name. |
| 成 Cheng | First choice | +14 | Cheng means completion; a first-choice officer for weddings. |
| 收 Shou | Sources split | -4 | Shou is a black-path day, yet the classic verse assigns marriage to it; both readings shown. |
| 开 Kai | First choice | +14 | Kai opens a new stage; a first-choice officer for weddings. |
| 闭 Bi | Widely avoided | -18 | Bi 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.
| Spirit | Colour | Weight | Reading |
|---|---|---|---|
| 青龙 Qing Long | Yellow path | +8 | Azure Dragon |
| 明堂 Ming Tang | Yellow path | +8 | Bright Hall |
| 天刑 Tian Xing | Black path | -8 | Heavenly Punishment |
| 朱雀 Zhu Que | Black path | -8 | Vermilion Bird |
| 金匮 Jin Kui | Yellow path | +8 | Golden Coffer |
| 天德 Tian De | Yellow path | +8 | Heavenly Virtue |
| 白虎 Bai Hu | Black path | -8 | White Tiger |
| 玉堂 Yu Tang | Yellow path | +8 | Jade Hall |
| 天牢 Tian Lao | Black path | -8 | Heavenly Prison |
| 玄武 Xuan Wu | Black path | -8 | Dark Warrior |
| 司命 Si Ming | Yellow path | +8 | Life Controller |
| 勾陈 Gou Chen | Black path | -8 | Curled Earth |
Starting rule (month branch to the Azure Dragon seat)
| Month branch | Azure 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.
| Mansion | Name | Luminary / beast | Rating | Marriage | Source note |
|---|---|---|---|---|---|
| 角 Jiao | Horn | 木 Azure Dragon | 吉 | Favourable | — |
| 亢 Kang | Neck | 金 Azure Dragon | 凶 | Disputed | Sources disagree: some list it as favourable for marriage, others call it inauspicious; the two readings are both published. |
| 氐 Di | Root | 土 Azure Dragon | 凶 | Taboo | — |
| 房 Fang | Room | 日 Azure Dragon | 吉 | Favourable | — |
| 心 Xin | Heart | 月 Azure Dragon | 凶 | Taboo | — |
| 尾 Wei | Tail | 火 Azure Dragon | 吉 | Favourable | — |
| 箕 Ji | Winnowing Basket | 水 Azure Dragon | 吉 | Disputed | Most sources rate the mansion auspicious but do not name marriage among its uses. |
| 斗 Dou | Dipper | 木 Black Tortoise | 吉 | Disputed | Most sources rate the mansion auspicious but do not name marriage among its uses. |
| 牛 Niu | Ox | 金 Black Tortoise | 凶 | Taboo | — |
| 女 Nu | Girl | 土 Black Tortoise | 凶 | Taboo | — |
| 虚 Xu | Emptiness | 日 Black Tortoise | 凶 | Taboo | — |
| 危 Wei | Rooftop | 月 Black Tortoise | 凶 | Taboo | — |
| 室 Shi | Encampment | 火 Black Tortoise | 吉 | Favourable | — |
| 壁 Bi | Wall | 水 Black Tortoise | 吉 | Favourable | — |
| 奎 Kui | Legs | 木 White Tiger | 平 | Taboo | — |
| 娄 Lou | Bond | 金 White Tiger | 吉 | Favourable | — |
| 胃 Wei | Stomach | 土 White Tiger | 平 | Favourable | — |
| 昴 Mao | Hairy Head | 日 White Tiger | 平 | Taboo | — |
| 毕 Bi | Net | 月 White Tiger | 吉 | Favourable | — |
| 觜 Zi | Turtle Beak | 火 White Tiger | 凶 | Taboo | — |
| 参 Shen | Three Stars | 水 White Tiger | 平 | Taboo | — |
| 井 Jing | Well | 木 Vermilion Bird | 平 | Disputed | Sources disagree: some list marriage as taboo, others treat the mansion as auspicious. |
| 鬼 Gui | Ghost | 金 Vermilion Bird | 凶 | Taboo | — |
| 柳 Liu | Willow | 土 Vermilion Bird | 凶 | Taboo | — |
| 星 Xing | Star | 日 Vermilion Bird | 平 | Disputed | Sources disagree: some list it as favourable for marriage, others as inauspicious. |
| 张 Zhang | Extended Net | 月 Vermilion Bird | 吉 | Favourable | — |
| 翼 Yi | Wings | 火 Vermilion Bird | 平 | Taboo | — |
| 轸 Zhen | Chariot | 水 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.