Methodology

How the chart is calculated, and how we know it is right

No library, no API, no lookup table of birthdays: the solar terms are calculated from an ephemeris and the day pillar from a Julian day count. Here is every step, and the check against the published Korean almanac.

1. The birth instant

The date and time you enter are converted to UTC using the zone’s standard offset and the daylight-saving rule in force on that date in that city. Searchable GeoNames cities supply an IANA time-zone identifier and longitude. Your browser’s time-zone database applies the rules for the birth date, including historical daylight saving. Update your browser for recent rule changes. Missing or repeated clock times require the recorded UTC offset through manual entry.

Optionally, the time is corrected to true solar time: four minutes per degree of longitude away from the zone meridian, plus the equation of time (apparent minus mean solar time). Those corrections are shown in minutes on the result card so the arithmetic is visible.

2. The solar terms

The Sun’s apparent geocentric longitude is computed from the VSOP87 theory for Earth’s heliocentric position (123 terms, truncated where the amplitude falls below 10⁻⁷ radians), plus nutation in longitude from the IAU 1980 series and annual aberration. Delta-T is applied with the Espenak-Meeus polynomials to convert between dynamical and universal time.

Each of the 24 terms is then found by Newton iteration on the condition that the apparent longitude equals its fifteen-degree multiple. The year pillar turns at 315 degrees (lichun), the month pillar at each of the twelve odd terms.

3. The day pillar

The civil date of the birth — after any solar-time correction — is converted to an integer Julian day number, and the sixty-day cycle is read from it. One convention must be chosen: whether the day turns at midnight or at 23:00, the start of the Rat hour. Both are offered; the calculator defaults to midnight, which is what modern Korean almanacs print.

4. The hour pillar

Two-hour branches, with the Rat hour spanning 23:00 to 01:00, and the Five Rats rule for the stem. With an unknown birth time the hour pillar is omitted rather than guessed, and the site says so on every card it produces.

5. The five elements

Each stem counts as one unit. Each branch is split across its hidden stems by the traditional weights (for example 寅 as 甲 60, 丙 25, 戊 15) and the month branch is multiplied by 1.5 because it carries the season. The result is normalised to percentages that always add to 100.

“Support” is the share of the day master’s own element plus the element that generates it. It is a deliberate simplification of a much more elaborate traditional strength calculation, and it is labelled as a simplification wherever it appears.

6. The ten gods

Every other character is labelled relative to the day master by element and polarity: companion, rival, eating god, hurting officer, direct and indirect wealth, direct and indirect officer, direct and indirect resource. We show these labels on the result card but do not build the parenting report from them, because the vocabulary is alienating and the report reads better from the day master and the balance.

Validation against the Korean almanac

The engine is checked against the solar-term instants published by the Korea Astronomy and Space Science Institute (KASI) and against day pillars printed in the same tables. Across 72 published term instants in 2024, 2025 and 2026, the largest difference is 38.4 seconds (2026 Summer Solstice), with a mean bias of -7.0 seconds — inside the minute resolution the almanac itself publishes.

2026 solar terms: published by KASI, calculated here (both in Korean Standard Time)
TermKASI publishedSajuKids calculatedDifference
Minor Cold 小寒 2026-01-05 17:23 2026-01-05 17:22:58 -1s
Major Cold 大寒 2026-01-20 10:45 2026-01-20 10:44:46 -13s
Start of Spring 立春 2026-02-04 05:02 2026-02-04 05:01:58 -2s
Rain Water 雨水 2026-02-19 00:52 2026-02-19 00:51:44 -15s
Awakening of Insects 驚蟄 2026-03-05 22:59 2026-03-05 22:58:47 -12s
Spring Equinox 春分 2026-03-20 23:46 2026-03-20 23:45:46 -14s
Clear and Bright 淸明 2026-04-05 03:40 2026-04-05 03:39:50 -10s
Grain Rain 穀雨 2026-04-20 10:39 2026-04-20 10:38:59 -1s
Start of Summer 立夏 2026-05-05 20:49 2026-05-05 20:48:36 -23s
Grain Buds 小滿 2026-05-21 09:37 2026-05-21 09:36:37 -23s
Grain in Ear 芒種 2026-06-06 00:48 2026-06-06 00:48:13 +13s
Summer Solstice 夏至 2026-06-21 17:25 2026-06-21 17:24:21 -38s
Minor Heat 小暑 2026-07-07 10:57 2026-07-07 10:56:50 -10s
Major Heat 大暑 2026-07-23 04:13 2026-07-23 04:12:58 -2s
Start of Autumn 立秋 2026-08-07 20:43 2026-08-07 20:42:38 -22s
End of Heat 處暑 2026-08-23 11:19 2026-08-23 11:18:41 -19s
White Dew 白露 2026-09-07 23:41 2026-09-07 23:41:08 +9s
Autumn Equinox 秋分 2026-09-23 09:05 2026-09-23 09:05:05 +6s
Cold Dew 寒露 2026-10-08 15:29 2026-10-08 15:29:10 +10s
Frost's Descent 霜降 2026-10-23 18:38 2026-10-23 18:37:49 -11s
Start of Winter 立冬 2026-11-07 18:52 2026-11-07 18:51:55 -5s
Minor Snow 小雪 2026-11-22 16:23 2026-11-22 16:23:12 +12s
Major Snow 大雪 2026-12-07 11:53 2026-12-07 11:52:22 -37s
Winter Solstice 冬至 2026-12-22 05:50 2026-12-22 05:50:05 +6s

Day pillars are checked against 24 dates from the KASI lunar tables and two complete charts published by independent Korean almanac sites. The tests in the repository assert all of it, including lichun boundaries to the minute, true solar time, the unknown-time path and the parent-child chemistry rules.

Known limits

Sources