Chinese Almanac (Huangli)

Huangli (黃曆) is a traditional Chinese almanac. This guide shows you how to read its calendar details and traditional activity notes.

Look up a Chinese calendar date

Gregorian date
Month calendarBrowse dates in the current month

Dates and hours use China Standard Time (UTC+8).

Method and sources · lunar-typescript 1.8.6

Find dates by activitySearch a date range and compare up to three days
Learn to read a Huangli entry →

How do you read a Huangli entry?

Start with the date and calendar labels. Then look for 宜 and 忌, which show how that edition classifies activities.

Calendar details

農曆日期 · Nónglì rìqī · lunar date
The lunar month and day, including any leap-month label.
干支 · Gānzhī · stems and branches
Which time unit the pair labels and the convention used.
節氣 · Jiéqì · solar terms
The named point in the seasonal cycle and any printed date or time reference.

Traditional activity notes

宜 · Yí · traditionally suitable
The activities the particular entry presents as suitable.
忌 · Jì · traditionally to avoid
The activities the particular entry presents as to be avoided.

This card explains the fields. It does not give an activity list for a specific date.

Why do almanac entries differ?

Editions can include different material or use different rules. When two entries disagree, check the edition, the date it uses and how it defines the activity. Converting a date to the lunar calendar tells you its calendar label. The edition supplies its activity notes.

Historical example · Dunhuang, 877 CE

The International Dunhuang Programme describes a woodblock-printed almanac with calendar rows, zodiac illustrations and traditional guidance. The different parts show how one publication could combine dates, symbols and guidance on the same page.

How is Huangli different from BaZi?

Huangli helps you read a date and the traditions associated with it. A BaZi chart starts with your birth details and shows your Four Pillars, Day Master and how the Five Elements relate in your chart.

Sources & further reading

How this daily almanac is calculated

MingShu uses the rule tables bundled with lunar-typescript 1.8.6. The selected Gregorian date is a civil day in UTC+8, from midnight to midnight. The year label changes at Lunar New Year, and the month label follows the library’s day-based solar-term convention. Activity lists use that same month convention. Hourly labels come from the library’s time rules for the selected civil date. Activity search checks the daily entries directly, including any all-activities warning, and presents the matches in date order. The published package does not identify a single historical edition behind all its rules. Other almanacs may give different activity lists for the same date.