Home / How Our Calculators Work
How our calculators work
The problem with most fortune-telling tools online isn't accuracy — it's that you have no idea what they actually did. This page publishes every rule we use, where the data comes from, and where it stops. Results depend only on what you type in: there is no randomness anywhere. The same input always gives the same output, on any device, any day.
Contents
1. The Four Pillars (BaZi)
Each pillar — year, month, day, hour — is one heavenly stem paired with one earthly branch. All four switch on different boundaries, which is exactly where most calculators go wrong.
Year pillar: split at Li Chun, not at Chinese New Year
The year pillar changes at Li Chun (Start of Spring, around 4 February). In 2026 Li Chun falls on 4 February, so someone born on 3 February still belongs to the previous year (Yi-Si), and 4 February onward is Bing-Wu. Cutting the year at 1 January or at Chinese New Year shifts a whole year for anyone born before Li Chun.
Month pillar: split at the twelve "Jie", not at the 1st of the month
Month boundaries are the twelve major solar terms — Li Chun, Jing Zhe, Qing Ming, Li Xia, Mang Zhong, Xiao Shu, Li Qiu, Bai Lu, Han Lu, Li Dong, Da Xue, Xiao Han. Not the first day of the calendar month, and not the mid-terms. The month branch comes from the term; the month stem is derived from the year stem by the standard Wu Hu Dun rule.
Day pillar: computed from the Julian Day Number
No lookup table, no iteration. The day pillar comes straight from the JDN:
Valid across 1900–2099 with no calendar data needed, and leap years take care of themselves.
Hour pillar: early Zi, no day rollover
23:00–00:59 counts as Zi hour of the same day — we use the early-Zi convention, so the date does not roll over at midnight during Zi. The hour branch is fixed by the two-hour slot; the hour stem is derived from the day stem by the Wu Shu Dun rule. If you don't know your birth hour, the first three pillars are unaffected.
lunar_python across 1900–2099 — 198 years × 12 months × 28 days × 12 hour-slots,
798,336 samples — with zero differences. Front-end and back-end implementations were separately
cross-checked on 84,000 samples, also zero differences.
2. Lunar calendar and solar terms
Lunar conversion covers 1900–2099. Month lengths and leap months are stored in a compact integer table (low bits carry the leap month, the rest a bitmap of long and short months); a leap month follows the month of the same number.
Your Chinese zodiac animal is set by the lunar year, which changes at Chinese New Year — not on 1 January. Someone born on 20 January 1990 is a Snake; born 5 February 1990, a Horse. Two weeks apart, different animals.
3. Jianchu twelve gods and daily do's and don'ts
The "auspicious / inauspicious" lists you see on a Chinese almanac aren't arbitrary. We use the Jianchu system: the day's presiding god comes from the relationship between the month branch and the day branch.
k indexes the twelve gods in order — Jian, Chu, Man, Ping, Ding, Zhi, Po, Wei, Cheng, Shou, Kai, Bi — and each carries a fixed pair of suitable and unsuitable activities:
| God | Suitable | Avoid |
|---|---|---|
| Jian | Travel, take office, pray, seek offspring | Groundbreaking, well digging, boating |
| Chu | Cleaning, medical treatment, travel | Seeking money, opening business |
| Man | Rituals, prayer, opening, contracts | Medicine, planting |
| Ping | Repairs, road work, marriage | Digging channels, planting |
| Ding | Rituals, agreements, engagement, building | Lawsuits, travel |
| Zhi | Capturing, building, marriage | Opening, travel, relocation |
| Po | Demolition, medical treatment | Marriage, opening, groundbreaking |
| Wei | Bed placement, rituals | Heights, boating, travel |
| Cheng | Marriage, opening, schooling, building, trade | Lawsuits, disputes |
| Shou | Collecting payment, capturing, adding members | Opening, travel, burial |
| Kai | Prayer, opening, schooling, building | Burial, water release |
| Bi | Burial, grave repair, embankment | Opening, travel, medical treatment |
4. Wealth and Joy directions
Both are looked up from the day's heavenly stem only. Your zodiac sign and birth hour don't enter into it.
| Day stem | Wealth (Cai Shen) | Joy (Xi Shen) |
|---|---|---|
| Jia | Northeast | Northeast |
| Yi | Northeast | Northwest |
| Bing | West | Southwest |
| Ding | West | South |
| Wu | North | Southeast |
| Ji | North | Northeast |
| Geng | East | Northwest |
| Xin | East | Southwest |
| Ren | South | South |
| Gui | South | Southeast |
5. Kua number (East / West group)
The Kua number drives Eight Mansions feng shui. The year used is the Li Chun year — before Li Chun, use the previous year:
The eight directional ratings follow from the trigram's fixed star distribution: Fu Wei, Sheng Qi, Yan Nian and Tian Yi are favourable; Wu Gui, Jue Ming, Huo Hai and Liu Sha are unfavourable.
6. Flying Stars (annual)
The star that occupies the centre palace for a given year:
From there the stars fly through the nine palaces along the Lo Shu path, giving each direction its annual reading. This is the annual cycle only — it does not include monthly stars or a full mountain-water flying star chart.
7. Peach Blossom (romance direction)
Derived from the three-harmony branch groups, computed once for the year branch and once for the day branch:
| Harmony group | Peach Blossom branch | Direction |
|---|---|---|
| Shen · Zi · Chen (Water) | You | West |
| Yin · Wu · Xu (Fire) | Mao | East |
| Si · You · Chou (Metal) | Wu | South |
| Hai · Mao · Wei (Wood) | Zi | North |
When the year branch and day branch point to the same direction the signal is concentrated; when they differ, outside opportunity and inner preference are pulling different ways.
8. Wealth star (Ten Gods)
In the Ten Gods framework, "wealth" is the element the Day Master controls. Whether that wealth helps you depends on whether you can carry it:
- Strong Day Master: same-element + generating counts ≥ 4 — able to carry wealth
- Weak Day Master: fewer than 4 — carrying capacity is limited
Combined with how often the wealth element appears in the chart, this gives four readings: strong with abundant wealth (pursue income actively, scale up), strong with thin wealth (open new channels rather than waiting), weak with abundant wealth (consolidate first, avoid leverage), weak with thin wealth (hold the main line and control spending).
9. Lucky colours and directions
We reuse the same strong/weak test, then pick the element to favour:
- Strong: favour the element you generate — drain the excess
- Weak: favour your own element — support the Day Master directly
That element then maps to a colour family, a direction and set of numbers. This is an element-level steer; we don't tell you which object to buy.
10. Annual fortune and daily luck
Annual reading
We build the chart for today and compare your day branch against today's year branch and day branch. The relationship comes back as one of: same branch, six-harmony, three-harmony, six-clash, six-harm, punishment, self-punishment, or neutral. Harmony favours agreements and partnership; clash signals movement and change; harm tends to bite in details and communication; punishment flares around rules and arguments.
Daily luck
Your animal is fixed by the lunar year. The daily tier is then built from two real rules, and the page prints the arithmetic:
Those weights are ours — they are not handed down in any classic. That's exactly why they're printed on the page: you can decide whether you agree with them.
11. Name analysis (Wu Ge)
The Five Patterns method counts Kangxi strokes, not simplified-form strokes. Where the numbers come from:
- Stroke counts derive from the
kRSUnicodefield in the official Unicode Unihan database, resolved against the 214 Kangxi radicals; where a character has multiple readings we take the largest count - Simplified-to-traditional conversion uses OpenCC's
STCharacters.txt. We deliberately avoid Unihan'skTraditionalVariant, which mixes in variant forms and produces wrong stroke counts - The five patterns — Heaven, Human, Earth, Outer, Total — combine stroke counts by fixed rules
- Each resulting number maps to one of the 81 numeric interpretations; the San Cai configuration reads the elemental relationship between the Heaven, Human and Earth patterns
12. BaZi compatibility
Three layers, weighted in order:
- Day branch (Spouse Palace) — the core layer: six-harmony, three-harmony, six-clash, six-harm, punishment or self-punishment between the two day branches
- Day Master elements — how the two day stems generate, control, match or ignore each other
- Hour and year branches — a supporting layer covering the descendants palace and shared roots
The three combine into a 0–100 score with a written reading. The score describes how the two charts sit together inside a traditional framework; it does not predict whether a marriage works.
Anchors you can verify
Check these against any reference tool you trust. If they don't match, we're the ones who are wrong — tell us.
| Date · time | Four Pillars | Lunar date |
|---|---|---|
| 1949-10-01 · 15:00 | Ji-Chou · Gui-You · Jia-Zi · Ren-Shen | 8th month, day 10 |
| 2000-01-01 · 12:00 | Ji-Mao · Bing-Zi · Wu-Wu · Wu-Wu | 11th month, day 25 |
| 2024-02-10 · 12:00 | Jia-Chen · Bing-Yin · Jia-Chen · Geng-Wu | 1st month, day 1 |
| 2025-01-29 · 12:00 | Jia-Chen · Ding-Chou · Wu-Xu · Wu-Wu | 1st month, day 1 |
| 2026-02-17 · 12:00 | Bing-Wu · Geng-Yin · Ren-Xu · Bing-Wu | 1st month, day 1 |
Limits, and what we don't do
- Year range: 1900–2099. Outside that we return nothing rather than a plausible-looking answer.
- No randomness: results depend only on input. The entertainment quizzes under /en/test/ use a deterministic hash of your input, so the same input always gives the same output — but they're entertainment, not a reading.
- No unverifiable statistics: we won't invent numbers like "how many people in the country share your name". Nobody has that data, and a made-up figure that looks reasonable is worse than none.
- No specific-event predictions: we give tendencies and structural readings, not "you will meet someone next March".
- Schools disagree, and that's normal: auspicious tables, star systems and useful-god selection all differ between traditions. We say which one we follow so you can judge whether to accept it.
FAQ
Why does the year start at Li Chun instead of Chinese New Year?
BaZi uses the sexagenary (stem-branch) calendar, whose year begins at Start of Spring. Chinese New Year is the first day of the first lunar month — a lunisolar calendar. The two year boundaries are simply different, and BaZi follows Li Chun. It's also the single most common source of charting errors.
I don't know my birth hour. Can I still get a chart?
Yes. The hour only sets the hour pillar; year, month and day are unaffected — and the day pillar, which represents you and your spouse, is the most important of the four. We default the hour and the reading leans toward overall tendency.
Other sites give me a different chart. Which is right?
Test them against the anchor table above. Most disagreements come from three places: cutting the year at Chinese New Year, cutting the month at mid-terms instead of major terms, and truncating the solar-term crossing to the hour. We follow the sexagenary rules and round the crossing hour up.
Where do the scores come from?
Compatibility, daily luck and name scores are scoring tables we defined from traditional rules — they are not fixed verdicts handed down in classical texts. The weights are published on this page so you can decide whether you accept them. We'd rather be checkable than look authoritative.
If this is just for fun, why bother being rigorous?
Because "roughly computed" and "computed by stated rules" give you completely different things. With the first you can only believe it or not. With the second you can check it, argue with it, and compare it against what a human practitioner tells you.
Want these readings applied to your actual floor plan and schedule? Bring your chart and ask a practitioner.
Book a Consultation