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
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
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.
- 6tail · Calendar library and traditional rule tables
- WashU Libraries · Almanac editions and regional names
- Taiwan Ministry of Education · Tong Shu terminology
- International Dunhuang Programme · The 877 CE almanac
- Hong Kong Observatory · Chinese calendar conventions
- Hong Kong Observatory · Gregorian–lunar conversion and solar-term dates
- Explore the Chinese zodiac