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.
| Term | KASI published | SajuKids calculated | Difference |
|---|---|---|---|
| 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
- Delta-T after 2050 is an extrapolation; a birth date decades in the future carries a larger uncertainty, though still under a minute for the terms that matter.
- Historical time-zone data, especially before 1970, may be incomplete for individual localities. Verify older birth records against local records.
- City coordinates represent city centres. For an unlisted locality or a boundary-sensitive birth, manual longitude and the recorded UTC offset are available. City data: GeoNames cities15000, CC BY 4.0, downloaded 17 November 2026; not every village is included.
- The element weighting is one respected convention among several. Other practitioners weight hidden stems differently and will produce slightly different percentages.
Sources
- Korea Astronomy and Space Science Institute, almanac data (달력자료 / 월력요항), 2024-2026 — solar term instants and day pillars.
- Bretagnon, P. & Francou, G. (1988), VSOP87 planetary theory, as distributed in Meeus, Astronomical Algorithms, 2nd ed.
- Meeus, J., Astronomical Algorithms, 2nd ed. — nutation (ch. 22), solar coordinates (ch. 25), the equation of time (ch. 28).
- Espenak, F. & Meeus, J., Five Millennium Canon of Solar Eclipses — Delta-T polynomials.