If there is one book that has shaped daily life in China more than any other, it is the Huangli (黄历, huáng lì) — the Chinese almanac. For nearly two thousand years, this humble publication has told farmers when to plant, couples when to marry, merchants when to open shop, and families when to move house, bury their dead, or set out on a journey. Long before the internet, the almanac was the universal reference of the Chinese world, printed annually in the millions and consulted for decisions both momentous and ordinary.

The Huangli is not simply a calendar. It is a daily map of auspicious (宜, yí) and inauspicious (忌, jì) activities, woven together from the sexagenary cycle, the 28 lunar mansions, the 12 Day Officers, the Five Elements, and dozens of other cycles. To read it is to participate in a tradition that once guided emperors and still guides modern brides and businessmen. This guide introduces the structure of the Huangli, its key components, and how it is used in China today.

What Is the Huangli? Names and Origins

The Huangli is known by several names. Huangli (黄历), "Imperial Calendar," recalls the time when the calendar was an imperial prerogative — the emperor, as Son of Heaven, was responsible for "granting the calendar" (颁历, bān lì) to the people, and only the court astronomer's bureau was permitted to compute and publish it. Tong Shu (通书, tōng shū), "All-Purpose Book," is the common name in southern China, Hong Kong, and Southeast Asia; in Cantonese the word for "book" (书, syu) sounds like "lose" (输), so the almanac is often euphemistically called Tong Sheng (通胜, tōng shèng), "All-Win," to ensure good fortune.

The calendar's roots go back to the Han dynasty (206 BCE–220 CE), when the imperial astronomical bureau began issuing calendars that paired astronomical data with divinatory content. The form we recognize today — with daily entries listing auspicious and inauspicious activities, the day's spirit and mansion, and the day officer — crystallized in the Tang and Song dynasties. By the Ming and Qing, every county in China had its almanac, and the printing of the Tong Shu was a major annual industry.

The most famous compiler of the modern era is Grandmaster Li (李宪堂, Lǐ Xiàntáng), whose Hong Kong-based Uncle Tong Shu (蔡伯励, Choi Park-lai) — properly the Wing Sing Tong almanac — remains the standard reference in southern China, consulted even by Hong Kong's government for the timing of public events. The traditional center of almanac compilation, however, remains the lineages descended from the Qing imperial astronomical bureau.

The Anatomy of a Huangli Entry

A single day's entry in the Huangli contains a remarkable density of information. A typical page or screen lists:

Reading all of this together, one can determine not only whether a given day is good for, say, signing a contract, but also which two-hour window is best, which direction to face, and which participants (by zodiac) should be present or absent.

The 12 Day Officers (建除十二神)

Among the most important daily indicators are the 12 Day Officers (建除十二神, jiàn chú shí èr shén), also called the Twelve Establishing-and-Removing Spirits. Each day is governed by one of these twelve officers, which cycle in a fixed order matched to the zodiac animals of the day and month. Each officer defines the day's overall character — whether it is suited for beginnings, completions, removals, or rest:

Each officer is further modified by the day's element, mansion, and conflicts. A "Success" day with favorable elements and a benign mansion is the most sought-after; a "Break" day is generally avoided for anything but demolition. Together, the twelve officers provide the day's backbone — its "temperament," so to speak.

The 28 Mansions (二十八宿)

Each day is also governed by one of the 28 Lunar Mansions (二十八宿, èr shí bā xiù), the Chinese equivalent of the lunar zodiac. These are the 28 divisions of the sky through which the Moon passes in its monthly orbit, named after figures from Chinese mythology (the Horn, the Neck, the Root, the Room, the Heart, the Tail, and so on). Each mansion has a fixed character — auspicious, inauspicious, or mixed — and the day's mansion refines the reading given by the Day Officer. A "Success" day that also falls on an auspicious mansion is doubly favored; a "Success" day on a hostile mansion loses some of its power.

The 28 Mansions also connect the daily almanac to the larger Chinese star system, which divides the heavens into four great symbolic animals — the Azure Dragon of the East, the Vermilion Bird of the South, the White Tiger of the West, and the Black Tortoise of the North — each presiding over seven mansions.

Conflicts and Avoidances

A critical practical use of the Huangli is to identify days that clash (冲, chōng) with specific zodiac animals. Every day's Earthly Branch conflicts with the branch six positions away in the zodiac — the "opposite" animal. A Rat day (子) clashes with the Horse (午); an Ox day (丑) clashes with the Goat (未); and so on. If you are a Horse, a Rat day is your "clash day," and the almanac will warn you to avoid major initiatives, important signings, or long journeys.

A subtler concern is the evil direction (煞方) of the day, which rotates through the cardinal directions. A major activity — breaking ground, moving, even sitting at one's desk — should ideally not face the day's evil direction. Wedding processions traditionally avoid turning toward it.

Daily Hexagrams and Auguries

Some editions of the Huangli — especially the more elaborate Tong Shu of Hong Kong and Taiwan — go further, attaching a daily hexagram (每日一卦) from the I Ching to each day. The hexagram for the day offers a poetic and philosophical commentary on the day's character, drawn from the same source as the sexagenary cycle. A day governed by Hexagram 14, Da You (Great Possession), suggests abundance and visibility; a day of Hexagram 23, Bo (Splitting Apart), warns of decline and counsels conservation. For the philosophically inclined, the daily hexagram turns the almanac into a daily I Ching meditation.

How Modern Chinese People Use the Almanac

Despite the spread of the Gregorian calendar and secular modernity, the Huangli remains remarkably alive in the Chinese-speaking world. Its uses today cluster around life's major transitions:

Weddings (嫁娶)

The single most common use. Couples consult the almanac — often with both sets of parents and a master — to choose a date that is auspicious for marriage, does not clash with either partner's zodiac, and ideally aligns with a "Success" or "Open" day. Auspicious wedding dates are in such demand in Hong Kong and Taiwan that venues and photographers book out months in advance for the best dates, while the inauspicious dates sit empty.

Moving House (搬家 / 移徙)

Moving into a new home on a "Break" or "Close" day is considered inauspicious; an "Open" or "Establish" day is preferred. Families also choose an auspicious hour to physically carry the first item (often a rice jar or a statue of a deity) into the new home, marking the formal occupation.

Opening a Business (开市)

Shops, restaurants, and companies consult the almanac for their grand opening date and the precise hour to cut the ribbon. An auspicious opening is believed to set the tone for years of prosperity; an inauspicious one invites difficulty. This is taken seriously even by large modern corporations in Hong Kong and Singapore.

Breaking Ground and Construction (动土)

Before construction begins on a building — or even before a major renovation — the almanac is consulted for a suitable "breaking ground" day, and a small ritual is often performed to appease the local earth god. The direction of the work also matters, given the day's evil direction.

Funerals and Burials (安葬)

Funeral timing is among the most carefully consulted. A burial on an inauspicious day is feared to bring misfortune to the descendants; the almanac (often with a Feng Shui master) determines both the day and the orientation of the grave.

Travel and Signing (出行 / 立券)

For important journeys or the signing of major contracts, the almanac indicates favorable days and hours. Business people have been known to delay signing a contract by a day or two to land on a "Defining" or "Success" day, and to choose the hour accordingly.

Reading the Huangli Wisely

The traditional Chinese view of the Huangli is not fatalistic. The almanac does not determine what will happen; it indicates what kind of energy a day carries, so that one can act in harmony with it. An inauspicious day is not a sentence — it is simply a day better suited to rest, contemplation, or "removal" than to bold new beginnings. Conversely, an auspicious day is not a guarantee of success — it offers favorable wind, but one must still raise the sail.

The deepest wisdom of the Huangli may be its quiet insistence that timing matters. In a culture that often prizes speed and constant action, the almanac reminds us that there are days to build and days to rest, days to open and days to close, days to advance and days to consolidate. To consult the Huangli is to rejoin, however lightly, an ancient conversation about the rhythms of time — and perhaps to make better choices within them.

📝 Key Terms

黄历 huáng lì The Huangli — the Chinese imperial almanac, the universal daily reference for auspicious timing.
通胜 tōng shèng "All-Win" — the Cantonese name for the almanac (Tong Shu), renamed to avoid the unlucky sound of "book/lose."
宜·忌 yí · jì Auspicious (recommended) and inauspicious (avoided) activities for a given day.
建除十二神 jiàn chú shí èr shén The 12 Day Officers — the twelve spirits governing the character of each day.
二十八宿 èr shí bā xiù The 28 Lunar Mansions — divisions of the sky through which the Moon passes, each with its own character.
冲 chōng Clash — when the day's zodiac branch conflicts with another (often the opposite animal), warning those born under it to be cautious.
吉时 jí shí Auspicious hours — the favorable two-hour periods within a day for important actions.

🎉 Did You Know?

  • In Cantonese, the almanac is called Tong Sheng (通胜), "All-Win," because the original name Tong Shu (通书) sounds like "All-Lose" — too inauspicious for a book about auspicious timing.
  • The most prestigious almanac in Hong Kong is compiled by the Wing Sing Tong, founded by the late Grandmaster Choi Park-lai, and is consulted even by government departments for the timing of public ceremonies.
  • Auspicious wedding dates are in such demand in Hong Kong and Taiwan that venues and photographers book out months ahead for top dates, while inauspicious dates sit empty.
  • The Huangli's daily "宜" and "忌" lists draw from a fixed vocabulary of about 50 traditional activities — from 嫁娶 (marriage) to 破屋 (demolishing a house) — many of which still guide modern decisions.
  • The 28 Lunar Mansions of the Huangli are the same system that divides the Chinese sky into four symbolic animals: Azure Dragon, Vermilion Bird, White Tiger, and Black Tortoise.