Reading the Chinese Almanac (Huangli): What a Tongshu Page Actually Tells You

If you have ever watched a Chinese family argue gently over which Saturday to hold a wedding, there is a good chance someone in the room was holding a thin paper booklet, or thumbing a phone app, and saying "that day isn't good." The thing they were checking is the huangli (黄历), also called the tongshu (通书) — the Chinese almanac. It has been printed in roughly the same format for centuries, and hundreds of millions of people still glance at it before booking anything that feels important.

This post is for the curious outsider. I will walk through what a single almanac day actually contains, show you how to read one, and be honest about what it is and is not.

What the almanac is, in one breath

The huangli is a daily calendar. Each day gets its own small block of information rather than a single number. That block traditionally carries four things worth understanding first:

the lunar date — the Chinese agricultural-calendar date, which drifts against the Gregorian (Western) date and resets at each new moon;
the day's suitable (宜, yi) and avoid (忌, ji) activities — short lists of things tradition considers a good or bad fit for that specific day;
the zodiac clash (冲, chong) — which of the twelve Chinese zodiac animals is "clashed" by the day;
the nearest solar term (节气, jieqi) — one of the 24 seasonal markers that split the year, such as the start of spring or the summer solstice.

Around those four, a full page piles on more: the year, month, day and hour pillars in the sexagenary (干支) cycle, an auspicious-or-not rating for each of the day's twelve double-hours, and a few lines of folk verse. But if you remember only the lunar date, the yi/ji lists, the clash, and the solar term, you can read almost any almanac page and follow what a Chinese reader sees in it.

The heart of it: suitable and avoid

The part people actually consult is the yi/ji pair. Yi (宜) lists activities the day favors. Ji (忌) lists activities to hold off on. These are not invented per day by a person — they come out of mechanical cycles. One is the Twelve Day Officers (建除十二神), a twelve-step rhythm that tags each day with an archetype like "establish," "remove," or "balance." Another is the 28 lunar mansions, a 28-day wheel of stars, each paired with an activity leaning. A third is the sexagenary day cycle, which carries old activity warnings. Stack the three and you get a day's character.

The activities themselves are concrete and domestic: getting married, moving house, opening a business, traveling, signing contracts, burials, even haircuts and bathing. That domesticity is the whole point. The almanac was a farmer's and a householder's tool, not a philosopher's.

A worked example

Say you open the almanac for a candidate moving day and the day reads like this:

Lunar date: eighth month, day 14
Suitable (宜): moving house, travel, opening a business, signing contracts
Avoid (忌): burials, breaking ground for construction
Clash (冲): clashes the Rat (冲鼠)
Solar term: three days after White Dew (白露)

How a traditional reader takes this: moving house sits in the suitable column, so the day is broadly fine for a move. But notice the clash line — "clashes the Rat" means anyone in the household born in a Year of the Rat is advised to keep a low profile that day rather than be the one carrying the first box across the threshold. The avoid column has nothing about moving, so there is no direct conflict. The verdict: a reasonable moving day, with a note to let the Rat-born family member sit the ceremony part out. If your grandmother keeps a paper tongshu, it will say the same thing for that date, because both are reading the same cycles.

How families actually use it

The classic use is date picking, called 择日 (zeri). Weddings are the headline case: couples line up a few candidate dates and quietly drop the ones the almanac frowns on, partly out of belief and partly because it heads off an objection from the older generation before it starts. Moving day is the next most common, then business openings — where people go a step further and pick not just the day but the lucky double-hour for cutting the ribbon. Travel and funeral dates round out the short list of things people check most.

I am not a believer myself. But I grew up watching my aunt run her finger down the printed page before settling any family date, and I will admit the phrase "I checked the almanac" ends an argument faster than any logical case I could make. There is something quietly useful about a shared reference everyone already trusts — it turns "whoever is loudest wins" into "let the tradition decide," and the elders feel heard. That social function, more than any forecast, is why the tradition is still alive.

The honest caveat

Here is the part that matters most for an outsider: the huangli is cultural heritage, not science. The yi/ji lists are a thousand-year composite of folk practice, farming wisdom, and classical cosmology. They are not a tested predictor of outcomes, and no study shows that weddings on "auspicious" days last longer or businesses opened on lucky hours earn more. Treat the almanac the way you would treat a saint's day on a Christian liturgical calendar, or a "lucky number" in any culture — a piece of context that carries meaning for the people who hold it, not a forecast you should plan your life around.

The healthy way to use it, even within Chinese families, is as a soft input. If a date is perfect for everyone's schedule but the almanac marks it "avoid," that is worth a second's thought, not an automatic veto. The clash line trips up newcomers too: your own zodiac animal "clashes" with some day roughly twice a month, so a clash is a routine note, not a catastrophe.

Try reading one yourself

The easiest way to understand the almanac is to read a real day. You can pull up any date from 1900 to 2100 with the Chinese Lunar Almanac tool — it lays out the lunar date, the suitable and avoid lists, the clash, the solar term, and the hour-by-hour chart exactly as a printed tongshu would, and it states the for-cultural-interest caveat right at the top before showing anything.

If you only want the calendar conversion without the fortune-telling layer — just the Chinese agricultural date for a given Western date — the Lunar Calendar Converter does that one job cleanly. Between the two, you can read a full almanac day and check the underlying date math, and decide for yourself how much weight, if any, the suitable-and-avoid lists deserve.

Made by Toolora · Updated 2026-06-13