Two kinds of content
Calendar calculation: Gregorian to lunar dates, solar terms, stem-branch pairs, moon phase. Traditional rule tables: day officers, clash, suitable and avoid. The first has an astronomical basis and was checked; the second is traditional lore looked up from tables.
Lunar dates
Day one of a lunar month is the day of the new moon; new moons and solar terms are timed at 120° east (UTC+8), as the Chinese national standard GB/T 33661-2017 lays down. This site computes them with tyme4ts.
Check: of 2,474 lunar month starts in the Hong Kong Observatory tables for 1901 to 2100, 2,473 match. The one that differs is the new moon of late September 2057, within a minute of midnight.
Solar terms
The "current term" is the latest one dated today or earlier, on a UTC+8 calendar. Check results are on the BaZi method page.
Stems and branches
The day pair is an unbroken count. Year and month pairs follow BaZi: the year from the Start of Spring, the month from twelve terms. Between Chinese New Year and the Start of Spring the year pair can therefore differ from the name of the lunar year. That is two ways of naming years, not an error.
"Today"
The page reads your device's clock, converts to Malaysia time (Kuala Lumpur) and takes that date. Any other day can be chosen.
Where the officers and lists come from
The day officers follow the rule on the introduction page; this site re-derived them by program and they match the library.
The suitable and avoid lists are taken straight from tables inside tyme4ts. The library does not say which classic they follow, and this site has not checked them against the 协纪辨方书 or any printed almanac. They are shown in Chinese, as given, for cultural interest only.
Sources
- GB/T 33661-2017, Calculation and promulgation of the Chinese calendar.
- Hong Kong Observatory: calendar conversion tables 1901 to 2100; solar-term dates and times.
- 钦定协纪辨方书 (Qing, Qianlong reign). Cited as background only.
- Shuihudi Qin bamboo slips, 日书.
- tyme4ts 1.5.6 by 6tail, MIT licence.
Versions
Almanac engine 0.1.0 (November 2026): first version, 1901 to 2099.