The book this site is named after

The Chinese almanac: what a tong shu is, and how to read a page

A Chinese almanac is a book that prints every day of the coming lunar year and, under each date, a verdict on it. The date layer is astronomy: the lunar month and day, the year, month and day as pairs of characters, the solar terms and the festivals. The verdict layer is older than the book and stranger than the date: a day officer, a day spirit, a short list of things the day is good for and a short list it is not, and an animal the day clashes with. The mainland calls it the huangli, the yellow calendar; Hong Kong and Southeast Asia call it the tong shu or, for reasons explained below, the book of winning. It is the object this site is named after, and the calendar inside it is the one our converter runs on.

Hands turn a thin, light-filled page of a thick, red-covered Chinese almanac on a dark wooden desk in early morning light, the print softened to a blur, with a cup of tea beside it.
One year, one page per day, and a red cover. Illustration, not a photograph of a specific book.

Six names for one book

The first obstacle to looking the thing up is that it has half a dozen names, and each one is a small piece of history. Two of them are pronounced the same and written differently; one was changed by a pun; one was changed by an emperor's name.

Name Literally Why
Huangli yellow calendar From the color of the paper the state editions were bound in. The everyday word in the mainland.
Huangli (imperial) imperial calendar A different first character, same sound: the calendar was issued in the emperor’s name, and the two spellings have been swapped for each other for centuries.
Tongshu the comprehensive book The private, annotated editions that specialists produced on top of the state calendar. The word in Hong Kong, Taiwan and Southeast Asia.
Tongsheng the book of winning Cantonese: the word for book sounds like the word for lose, so the almanac was renamed to win. The name you will see in Hong Kong shops.
Shixian shu book of the seasons’ laws The Qing official title. It had been Shixian li, the seasons’ calendar, until the Qianlong emperor came to the throne bearing the personal name Hongli, and the character had to be avoided.
Nongmin li farmers’ calendar The Taiwan name, and a false friend: it makes the book sound like the Old Farmer’s Almanac, which it does not resemble.

The emperor's name is the best of these. The Qing court issued its calendar every year on the first day of the tenth lunar month under the title Shixian li. When the Qianlong emperor succeeded in 1735, his personal name was Hongli, and the second character of it was the character for calendar. A subject may not write the sovereign's name, so the calendar became the Shixian shu, the book of the seasons' laws, and stayed a book rather than a calendar for the rest of the dynasty. The site you are reading, 玉历, yu li, uses the character he took out of circulation. The about page explains the rest of the name.

The pun is Cantonese. Tong shu ends in the word for book, which in Cantonese sounds like the word for lose, and a book you consult before a wedding or a business opening cannot be called the book of losing. So it is the book of winning, tong sheng, and that is the word on the cover in a Hong Kong stationer's.

The name-taboo renaming, the tenth-month issue date, and the Cantonese renaming: Chinese Wikipedia, Huangli, which cites the standard histories; we did not locate the Qing edict itself.

Older than paper

In December 1975, in a Qin tomb at Shuihudi in Hubei, archaeologists found the library of a county clerk named Xi, over eleven hundred bamboo slips, buried with him in a grave that his own chronicle dates to no earlier than 217 BC. Among them were two texts the excavators called daybooks: 166 slips by his head and 257 by his feet, sorting days into those suited and unsuited to marriage, travel, building and burial. That is the verdict layer of the almanac, and it predates paper and printing.

The twelve words that still head the verdict on every leaf are in a text from 139 BC. The Huainanzi, in its chapter on the patterns of heaven, runs through the twelve branches and assigns each a word: the third branch is Establish, the fourth Remove, then Full, Level, and so on through Break, Danger and Complete to Open and Close, with a note on what each group governs. In the sentence just before it, the same text places the Vermilion Bird, the Hooked Array, the Dark Warrior, the White Tiger and the Azure Dragon around the sky. Those five are, with seven others, the day spirits of the modern almanac. Both rows of the leaf you can buy this year were on the page two thousand one hundred years ago.

Then the almanac met printing, and printing met the state. The Old Book of Tang records that on a day in the twelfth month of 835, a few weeks after the Sweet Dew Incident had left the palace full of executed ministers, the court found time to order that no prefecture might privately keep printing blocks for calendars. The calendar was the emperor's to issue; it said when the year began and what each day was for, and a private printer selling it early was selling the emperor's authority. It is the earliest order regulating printing on record in China, and it is about the almanac. By 1328 the Yuan state was printing over three million copies a year of its own.

The verdict layer was finally standardized in 1739, when the Qianlong emperor, the same one whose name changed the book's title, ordered a compendium on day selection. The Xieji Bianfang Shu ran to thirty-six volumes, threw out the contradictory spirits and folk rules that had accumulated, and became the rulebook that every private almanac house has reprinted, under its own shop name, ever since.

Shuihudi: Chinese Wikipedia on the find, 1,155 slips and 80 fragments, the two daybooks of 166 and 257 slips, the chronicle ending in 217 BC. Day-officers and beasts: Huainanzi, Tianwen, read on Wikisource. The 835 order: Old Book of Tang, juan 17b, twelfth month of Taihe 9, read on Wikisource. 1328 and the 1739 compendium: Chinese Wikipedia, Huangli and Xieji Bianfang Shu.

How to read a page

Here is the top of a leaf for the day this page was published, with the values our engine computes for it. A printed almanac would set the same lines in a dense grid with the characters; we give them in English, in the order a Chinese reader scans them.

Specimen leaf

Sunday, September 13, 2026

3rd day of the 8th lunar month, 2026

Year
Bing Wu · Fire Horse
Month
Ding You
Day
Geng Yin · Metal Tiger
Day officer
Hold
Clashes with
Monkey
Sha direction
north
Suitable / avoid
Not printed here; see below for why.

Three things to notice. The year, month and day lines are the top three pillars of a bazi chart, character for character; the almanac and the fortune-teller are reading the same clock. The day officer is the Huainanzi rule applied: the day whose branch matches the month's branch is Establish, and the other eleven follow in order. And the clash line is one of the six clashes of the branches: the day's branch has one opposite, and the animal of that opposite is the one the almanac warns. The sha direction follows from the same branch by a fixed table.

The full leaf runs a dozen lines. This is what each one says and where it comes from.

Line What it says Where it comes from
The date, three ways Gregorian date; lunar month and day; and the year, month and day each as a stem-and-branch pair. Astronomy. Identical to our converter and to the top three pillars of a bazi chart.
Day officer One of twelve words: Establish, Remove, Full, Level, Settle, Hold, Break, Danger, Complete, Gather, Open, Close. The Huainanzi, 139 BC, which fixes the sequence by branch.
Day spirit One of twelve spirits; six mark a yellow-path (auspicious) day, six a black-path day. The same tradition. Five of the twelve are the directional beasts, already listed in the Huainanzi.
Suitable (yi) Activities the day favors: marriage, travel, moving in, breaking ground, opening a business, burial, sacrifice. Day-selection doctrine, codified for the Qing court in 1739 and reprinted by private almanac houses.
Avoid (ji) Activities the day disfavors, from the same list. Same source. This is the row two almanacs most often disagree on.
Clash and sha The animal whose branch clashes with the day, and a compass direction to keep your back from. The six clashes of the branches. Our branch-relations page walks through them.
Auspicious hours Which of the twelve double-hours are favorable. Hour-branch against day-branch, by the same rules.
Fetus spirit Where in the house the protector of an unborn child sits today; do not hammer, drill or move furniture there. Folk almanac tradition. Reported, not endorsed.
Peng Zu’s hundred taboos Two lines of what not to do on a day with this stem and this branch. A late folk rhyme attached to the legendary long-lived Peng Zu. Reported, not endorsed.
Wealth and joy directions Which way the god of wealth and the god of joy sit today. Stem-of-day tables in the same day-selection literature.
Lunar mansion Which of the twenty-eight mansions the Moon occupies. Ancient astronomy; on a modern leaf it is a cycle, not an observation.
Solar term Printed on the day a term begins, with its clock time. Astronomy. Our solar-terms page computes them.

The two lists are the lines people actually use, and they are marked with two characters you will learn to spot on any leaf: , yi, suitable, and , ji, avoid. The vocabulary under them is a fixed set of a few dozen activities, most of them the big irreversible ones: marrying, moving house, breaking ground, opening for business, setting the bed, burying the dead, and traveling. A modern reader with none of the beliefs still uses the two lists the way you might use a horoscope: not to decide, but to check, and to have something to say to a grandmother who will ask.

Two layers, and only one of them is a calendar

The date layer is astronomy. The lunar month begins on the dark moon, the solar terms sit at fifteen-degree steps of the sun's path, and in modern China both are computed by the Purple Mountain Observatory under a national standard, which is what our calendar converter implements. Every almanac on every shelf agrees with every other almanac on this layer, because they have no choice.

The verdict layer is doctrine. It descends from the daybooks and the Huainanzi, was codified in 1739, and is applied by each publishing house with its own emphases, which is why two almanacs bought in the same shop can mark the same day suitable for marriage in one and silent on it in the other. That disagreement is not a flaw in one of them. It is what the verdict layer is: an interpretation printed in the grammar of a fact.

It is also why the specimen above leaves those two lines blank. We compute the date layer, because it can be computed and because we would rather you checked our lunar date against a printed almanac and found them identical. We do not print a verdict, because a verdict without the doctrine behind it is a horoscope, and we are not in that business. If you want the verdict, buy the book; it costs about as much as a coffee, it has been printed in the millions since the fourteenth century, and it is worth owning for the tables at the back alone.

The Purple Mountain Observatory's role and the national standard: see the converter's how we convert section.

Why the English-speaking world has only a farmer's almanac

The word almanac lands, for an English reader, on one book: the Old Farmer's Almanac, founded in 1792 by Robert B. Thomas, the oldest continuously published periodical in North America, with its long-range weather forecasts from a formula kept in a black tin box in New Hampshire, its planting tables, its tides and sunrises. It is a fine object, and it is a different kind of book. It predicts. A Chinese almanac predicts nothing. It classifies. It does not tell you whether it will rain on your wedding day; it tells you whether the day is one for weddings.

The Taiwan name for the Chinese book, the farmers' calendar, makes the confusion worse by making the two sound like cousins. They share a reader, since a farmer needs the solar terms and the solar terms are in both, and they share almost nothing else. The nearest thing English ever had to the verdict layer was the medieval almanac's list of good and bad days for bloodletting, and English gave that up around the time it gave up bloodletting. Chinese kept the days and dropped the leeches.

1792, Robert B. Thomas, weather formula, planting tables: Wikipedia, Old Farmer's Almanac. The bloodletting-days comparison is our own and is offered as a comparison, not a history.

Keep going

Common questions

What is a Chinese almanac?

A yearly book that prints every day of the lunar year with two layers of information. The first is the calendar itself: the lunar date, the year, month and day as stem-and-branch pairs, the solar terms and the festivals. The second is a judgment about the day: a day officer and a day spirit, a list of activities the day is suitable for and a list it is not, the animal the day clashes with and a direction to avoid. It is known as the huangli or, in Hong Kong and Southeast Asia, the tongshu or tongsheng.

What does tong shu mean?

Tongshu means the comprehensive book, the book that goes through everything, and it is the name of the privately published almanacs that added day-selection notes, charms and reference tables to the official calendar. In Cantonese-speaking places it became tongsheng, the book of winning, because the word for book sounds like the word for losing and nobody wanted to buy a book of losing. Both names refer to the same object the mainland calls a huangli.

How do you read a Chinese almanac page?

Find the date first, printed three ways: Gregorian, lunar, and as stem-and-branch pairs for the year, month and day. Then read the two lists: suitable and avoid, usually marked with the characters yi and ji. Then the clash line, which names an animal; if it is your birth-year animal, the tradition says to skip the big decisions that day. The rest of the page, the auspicious hours, the fetus spirit, the wealth direction, is reference material you consult only when you need it.

Is the Chinese almanac the same as the lunar calendar?

The calendar inside it is. The lunar date on an almanac leaf and the lunar date from a converter are computed from the same astronomy, and in modern China both follow the Purple Mountain Observatory. The almanac then adds a second layer that no calendar contains: the judgment about what each day is good for. Two almanacs from different publishers will always agree on the date and may disagree on the judgment.

How old is the Chinese almanac?

Older than paper. Daybooks that sort days into suitable and unsuitable for marriage, travel and building were found in 1975 in a Qin official’s tomb at Shuihudi, on bamboo slips, in a burial no earlier than 217 BC. The twelve day-officers still printed on every leaf are laid out in the Huainanzi of 139 BC. Printed calendars were common enough by 835 for the Tang court to ban private printing blocks, and the Yuan state printed over three million copies in 1328.

Why is it called a farmer’s almanac in Taiwan?

Because farmers were the readers who needed the solar terms, which tell you when to plant and which the lunar months alone cannot. The name is a false friend in English, where the Old Farmer’s Almanac is a weather-and-planting annual with a secret forecasting formula. The Chinese book forecasts nothing. It classifies days, and the classification comes from a doctrine of day selection, not from a barometer.

Sources

The Huainanzi and the Old Book of Tang were read directly in the Chinese. The dates and names that rest on the Chinese encyclopedia entries are marked as such in the notes under each section.

Stay in the loop.

Chinese mythology, the zodiac, and the meaning behind names and symbols, rooted in the classics and read back to you. No spam. Unsubscribe anytime.