How We Check
This site makes two kinds of statements and keeps them apart. Calendar facts come from official tables and are checked by machine. Traditions are written in our own words and always labelled. Here is how each is handled.
Official date taken from official tables · Tradition a traditional belief, in our own words, not a prediction
Calendar facts Official date
Every Lunar New Year date, lunar month, leap month and solar term on this site comes from the Hong Kong Observatory's Gregorian-Lunar Calendar Conversion Table, which covers 1901 to 2100.[HKO] We keep an archived copy of all 200 yearly tables in English and in Chinese. A script reads them and refuses to build the site if any of these checks fails:Lunar New Year: Also called Chinese New Year. It is the first day of the Chinese year. Its date moves each year, always between 21 January and 20 February, because Chinese months follow the moon.Lunar month: A month that starts at a new moon and lasts 29 or 30 days.Leap month: An extra month, added about every three years so the calendar stays in step with the seasons.Solar term: One of 24 points on the sun's yearly path, about 15 days apart. The solstices and equinoxes are four of them.Gregorian: The everyday Western calendar.HKO: The Hong Kong Observatory, the Hong Kong government's observatory. Its official tables give every date on this site.
- The animals follow their 12-year order, and every year's stem-branch name matches the 60-year cycle.Stem-branch name: A year's traditional two-part Chinese name. The first part, the stem, is one of 10 labels and gives the element. The second, the branch, is one of 12 labels and gives the animal.60-year cycle: The animals repeat every 12 years and the elements every 10, so the same pairing, such as Fire Horse, comes back only after 60 years.
- Every Lunar New Year falls between 21 January and 20 February, and every Lichun between 3 and 5 February.Lichun: "Start of spring", a date in early February. Chinese birth-chart astrology starts the zodiac year here.
- Each year has exactly 24 solar terms in the right order.
- Every lunar month has 29 or 30 days, months follow in order, and a lunar year has at most one leap month.
- All 73 leap months read from the English tables match the leap months marked 閏 in the Chinese tables.
No date is typed by hand. Pages take every date from the checked data, and a final check fails the build if a full date appears anywhere it wasn't drawn from the data.
Conventions Tradition
Some things are fixed conventions of the system rather than dates: which stem carries which element, which branch is which animal, the names of the solar terms, the hours of each branch, the monthly hexagrams and the NaYin names. They're stored once as tables, used everywhere from there, and reviewed as a set.Element: One of five qualities in Chinese tradition: wood, fire, earth, metal and water. Each year has one, and it changes every two years.Hexagrams: A figure of six stacked lines, solid or broken. The I Ching, the ancient Chinese "Book of Changes", is built around 64 of them.NaYin: An old system that gives each pair of years a poetic image, such as "Gold in the Sea". It is separate from the year's element.
Traditions Tradition
What an animal stands for, the personality traits linked with it, the meaning of the elements, the traditional relationships between signs: these are cultural beliefs, not facts about you. We write them in our own words, label them "Tradition", and never phrase them as predictions. You won't find horoscopes, luck scores or lucky numbers here.
Review status
A person reviews each set of facts before it's published. Until then the site is a preview and the facts are marked "pending review".
| Set | Status |
|---|---|
| Year table, lunar months and solar terms parsed from the archived HKO tables (scripts/build-data.mjs), plus a spot-check sample | Reviewed 2026-11-18 |
| Fixed tables in src/lib/cal.mjs: stem→element, branch→animal/element/direction/hours, solar-term names, monthly hexagrams, trigram directions, branch relationships, NaYin namesTrigram: A figure of three stacked lines, solid or broken. The eight of them stand for basic forces of nature. | Reviewed 2026-11-18 |
| Trend-analysis rules (src/lib/trend.mjs) and the meaning of each result (content/meanings.json), design P2 | Reviewed 2026-11-18 |
| Hand-written tradition text in content/*.json | Reviewed 2026-11-18 |
| Plain-English explanations shared by every page: content/glossary.json and content/snippets.json (design P1) | Reviewed 2026-11-18 |
Sources
- Hong Kong Observatory (Government of the Hong Kong SAR), Gregorian-Lunar Calendar Conversion Table, 1901–2100. www.hko.gov.hk · archived 2026-11-18. Every Lunar New Year date and the start of each lunar month, including leap months. Also the 24 season markers of each year, and each year's traditional Chinese name.
How we check: our method · all sources