The Huangli: A Reader's Guide to the Chinese Almanac

What a huangli is

A huangli is a traditional Chinese almanac: a calendar with an opinion. Underneath sits the Chinese lunisolar calendar — months that follow the moon, kept in step with the sun by an occasional leap month, with twenty-four solar-term markers tracing the sun's progress through the year. On top of that timekeeping, the almanac layers guidance about the quality of each day: what the day is considered suitable for, what it is not, which zodiac sign it presses on, what kind of character it carries.

The book goes by several names. In Mandarin it is the huangli, or the tongshu (通书 tōngshū) — roughly, "the book of everything." In Cantonese-speaking places it is the Tung Shing (通勝), a deliberate renaming: in Cantonese, the word for "book" sounds like the word for "lose," and nobody wanted a book of good days with a losing name, so it became the "book of victories" instead. The same Mandarin sound can also be written 皇历 huánglì, "imperial calendar" — a quiet reminder of who once had the right to issue it.

What separates an almanac from a plain calendar is that layer of day quality. Your phone's calendar tells you what day it is; a huangli tells you what kind of day it is. The claim underneath is older than any one method of making it: that time has texture, that days are not interchangeable blanks. Whether you take the printed verdicts as instruction or as a mirror is up to you — and it is the question this whole guide keeps circling back to.

A short history

For most of Chinese history, the calendar was not a commodity but a prerogative. Computing the year — when it began, where the leap month fell, how the days aligned with the traditional cycles — was the work of imperial astronomers, and issuing the result was an act of sovereignty. To adopt a dynasty's calendar was to acknowledge its rule. The office responsible in the last dynasties, the Bureau of Astronomy (钦天监 Qīntiānjiān), sat close to the throne for a reason.

Demand always ran ahead of supply. Among the earliest surviving pieces of Chinese woodblock printing are almanac pages from the ninth century, and records from that same era preserve official complaints that pirated calendars were reaching the market before the authorized edition appeared. The almanac is often described as one of the most frequently printed books in history, and the structure of the claim is easy to believe: printed annually, obsolete annually by design, and bought again every year for well over a thousand years.

When the imperial era ended in 1912, the state calendar went with it — but the popular almanac did not. Commercial editions, above all the Hong Kong Tung Shing, still published every year, carried the tradition forward, thickened over the decades with everything from telegraph-code tables to moral primers depending on the edition. The latest format shift is simply the smallest one yet: the suitable-and-avoid lines now ship inside calendar apps on millions of phones, consulted with a thumb on the way to work — which is roughly how the paper page was always consulted too: briefly, and first thing.

How to read a modern huangli page

Open a huangli — paper or app — to today, and you will find a dense little grid. Editions differ, but four elements do most of the work:

• The yi (宜 yí) and ji (忌 jì) columns. "Suitable" and "avoid" — the almanac's most famous feature. Under 宜 you might find entries like marriage (嫁娶 jiàqǔ), opening a business (开市 kāishì), moving into a home (入宅 rùzhái), or setting out on a journey (出行 chūxíng); under 忌, perhaps breaking ground (动土 dòngtǔ) or signing contracts (立券 lìquàn). These verdicts are the end product of the layered systems described below — our guide to auspicious days unpacks how they are reached.
• The day officer. Each day takes one of twelve rotating characters — Establish, Remove, Full, Balance, and so on — from the cycle known as the twelve day officers (建除十二神 jiànchú shí'èr shén). The officer sets the day's general temperament: some days are for starting, some for clearing, some for closing. We walk through the whole rotation in the twelve day officers.
• The zodiac clash. Every day carries one of the twelve earthly branches, each matched to a zodiac animal — and the sign sitting directly opposite the day's animal is said to be clashed (冲 chōng). If today clashes with your sign, tradition advises keeping major undertakings modest. What that means — and what it does not — is the subject of zodiac clashes.
• The solar term. The page also locates you within the twenty-four solar terms (节气 jiéqì), the sun-based season markers — points like the Start of Spring (立春 Lìchūn) and the winter solstice (冬至 Dōngzhì) — that give the lunisolar year its agricultural spine. See the solar terms for the full cycle.

Alongside these you may see the day written in the sixty-unit stems-and-branches cycle (干支 gānzhī), favorable directions, and often a row of auspicious hours — the day divided into twelve two-hour stretches (时辰 shíchen), each marked favorable or otherwise, for occasions where the timing runs finer than the date. But the four elements above are enough to read the page the way most people actually read it: a glance, a note of the day's character, and on with the morning.

What the huangli means today

The huangli's living use is concentrated at thresholds. Ask around almost any Chinese-speaking family and the pattern is consistent: the almanac comes out when a date must be chosen — a wedding, a business opening, a move, a groundbreaking. Choosing such a date has its own name, 择日 zérì, "selecting the day," and in many families it is less a private habit than a social one: an elder will check, whether or not the couple thought to ask.

The phrase people are choosing toward is 黄道吉日 huángdào jírì — an auspicious day, literally a lucky day on the "yellow path," an old name for the sun's course through the sky. Wedding venues in Chinese-speaking cities know these dates well; favorable days fill early, and the most favorable ones cluster ceremonies the way Saturdays do elsewhere.

Around that core sit softer uses. Some people glance at the day page the way others skim a horoscope — lightly, daily, half-seriously. Some consult it only under pressure, when a decision feels too large to take unaided. And for many people in the diaspora it is chiefly an inheritance — the thick book on a grandmother's shelf, the reason a moving date was suddenly non-negotiable — that later becomes a doorway into the system underneath. Learning to read the page for yourself is, among other things, a way of reading the people who taught you to check it.

Rhythm, not rule

So how should you hold a book that labels days good and bad? Honestly — and lightly. The huangli's verdicts are not measurements; they are the output of interpretive traditions whose real gift is structural. The almanac assumes that days differ, that timing matters, and that acting deliberately beats acting automatically. You can accept all three of those premises without believing that any date controls any outcome. That is the reading this guide takes — the almanac as a mirror for attention rather than a forecast to obey — and it matches how the book is actually used: consulted, weighed, and then folded into a decision that stays yours.

Held that way, the huangli becomes less a rulebook than a daily question: what is today for? A day marked for clearing invites you to notice what needs clearing. A clash day is a decent excuse to be gentler with yourself than usual. That is the same gesture as watching the moon — which is why lunar practice sits so naturally beside almanac reading; our guide to moon rituals traces the rhythm from the other side. It is also, we would argue, the same gesture as drawing a daily card — a case we make in full in huangli and tarot.

The one reading we would warn against is fear. An almanac consulted anxiously — every errand checked against the avoid column, every clash day braced for — turns a rhythm into a cage, and that inverts the point of the whole tradition. The huangli was meant to make days feel distinct. If it starts making them feel dangerous, put it down for a while; it will still be there, printing itself anew every year, when you are ready to read it as a rhythm again.

A place to keep the habit

If what draws you to the huangli is the pause more than the prescription, that pause is easy to keep. Mystical Sparkle's free daily card draw and reflection journal are built around the same one-page-a-day shape, and Sparkle Pro includes Huangli-inspired daily reflections along with a monthly Almanac Letter that reads the month's rhythm the way this page reads a single day. However you keep the habit — paper almanac, phone app, journal, or all three — the practice stays the same size: one look at the day, before the day looks at you.

Questions, answered plainly

Is the huangli the same as the Chinese lunar calendar?

No, though they travel together. The Chinese calendar is a lunisolar timekeeping system — it tells you the date, the month, and the festivals. A huangli is an almanac printed on top of that calendar: it adds a layer of day-quality guidance, such as the suitable and avoid columns, the day officer, and the zodiac clash. Every huangli contains the calendar; the calendar does not contain the huangli.

What is the difference between the huangli and the Tung Shing?

Mostly region and name. Huangli is the common Mandarin name; tongshu, "the book of everything," is another; Tung Shing is the Cantonese name used in Hong Kong and much of the diaspora. Cantonese speakers renamed the book because "book" sounds like "lose" in Cantonese, so it became the "book of victories" instead. Editions differ in extras and layout, but the core day-page apparatus is shared.

How does a huangli decide which days are auspicious?

By stacking several traditional cycles. The day's place in the sixty-unit stems-and-branches cycle, its officer in the twelve-day rotation, the stars and spirits traditionally assigned to it, and its zodiac clash are weighed together into the familiar suitable and avoid columns. Because compilers weigh those layers differently, two editions can disagree about the same day — a useful reminder that you are reading an interpretive tradition, not a measurement.

Do people still use the huangli today?

Widely. Printed almanacs still sell every year — the Hong Kong Tung Shing remains an annual fixture — and the suitable and avoid lines now appear inside popular calendar apps. Daily use is often casual, but for weddings, business openings, and moving days, consulting the almanac remains a mainstream custom in many Chinese-speaking families, both at home and across the diaspora.