Where Did the Chinese Almanac Come From? A Short History of Huangli

Before we get into anything else, the disclaimer the Daily Fortune tool shows under its title is also the right frame for this whole post: this is cultural reading, not prediction, and not advice. The Chinese almanac (黄历 huangli, also called 通书 tongshu or 通胜 tongsheng) has 3,000+ years of history behind it, and most of that history is more interesting than it is supernatural. This post walks through where it came from, what it actually contained, and how the simplified Daily Fortune tool relates to the tradition.

The earliest day selection: oracle bones (around 1200 BCE)

The oldest Chinese records of choosing one day over another for a specific activity are the oracle bone inscriptions from the late Shang dynasty, roughly 1200 BCE. Tens of thousands of these bones — mostly turtle plastrons and ox shoulder blades — have been excavated since the early 1900s, and a significant fraction record questions about timing. Should the king hunt on this day? Should the army move on the next? Will rain come within the ten-day week?

The bones were heated until they cracked; a diviner read the cracks; a scribe carved the question and the resulting reading into the surface. The questions are extremely practical. They are not asking about abstract destiny — they are asking about specific events on specific dates. The British Museum, the Academia Sinica in Taipei, and the National Museum of China in Beijing all hold significant oracle bone collections; if you want a single accessible overview in English, the Wikipedia article on oracle bones is reasonable. The relevant point for this post is that day-selection in China started as a practical question, framed around specific events on specific dates. Should we do this thing today? was the original prompt — not anything about cosmic destiny.

The Heavenly Stems and Earthly Branches

By the late Shang, the dating system that the Chinese almanac still uses was already in place: ten Heavenly Stems (天干: 甲乙丙丁戊己庚辛壬癸) combined with twelve Earthly Branches (地支: 子丑寅卯辰巳午未申酉戌亥). Each day, month, and year gets a two-character label from this combined cycle, which repeats every 60 units. The system is called 六十甲子 (the sexagenary cycle).

The stems and branches each have an elemental correspondence (Wood, Fire, Earth, Metal, Water), which is how the Five Elements got linked into day-selection. If today is a 甲子 day, the stem 甲 is Wood-yang and the branch 子 is Water-yang, which gives the day a particular elemental flavor. The Daily Fortune tool uses this exact lookup — the “Stem-Branch” field at the top of the result is the day’s two-character label in the 六十甲子 cycle.

The full table is on Baidu Baike’s page for 六十甲子. The system has been continuous from oracle-bone times to the present — any traditional Chinese almanac today and any Daily Fortune reading produced by this site are using the same dating notation Shang diviners used.

Han dynasty: the calendar gets formalized

The first imperial Chinese calendar to be widely promulgated and astronomically grounded was the Taichu Calendar (太初历), issued in 104 BCE under Emperor Wu of the Han. The calendar combined three things: a solar year (365.25 days, divided into the 24 solar terms covered in a separate post), a lunar month (29.5 days, the basis of the visible moon phases), and the sexagenary cycle.

Sima Qian’s Records of the Grand Historian (《史记》), finished around 94 BCE, includes a Treatise on the Calendar (历书) that describes the Taichu reforms in detail. The Han also formalized the link between calendar dates and the 24 solar terms, which is the framework underneath the Daily Fortune tool’s elemental reading for any given date.

What the Taichu Calendar did not yet include is the “auspicious activities” (宜) and “inauspicious activities” (忌) tables that became the defining feature of the popular almanac later. That layer came in the centuries after.

How yi-ji (宜/忌) got into the almanac

By the Tang dynasty (618–907), Chinese calendar specialists had developed two ancillary systems that became central to the almanac tradition. The first is the 建除十二神 (the Twelve Day Gods: 建除满平定执破危成收开闭), a rotating system that assigns one of twelve roles to each day. The second is the 二十八宿 (the Twenty-Eight Lunar Mansions), a way of mapping each day onto a specific section of the night sky.

Each of the twelve day gods and each of the twenty-eight mansions had a traditional association with certain activities — building a house, opening a business, traveling, weddings, funerals, hair-cutting, planting crops. By the Tang, court calendar offices were producing daily “suitable” and “unsuitable” lists for each date based on the combination of stem-branch, day god, and mansion. This is the origin of the modern almanac’s 宜 and 忌 columns.

The Song dynasty (960–1279) saw the first widely printed popular almanacs — the books that came to be called 通书 (“general book”) or, in Cantonese-speaking regions, 通胜 (auspiciously renamed to avoid the homophone with “losing”). These printed almanacs put a year’s worth of daily yi-ji readings into a single volume, sold cheaply, and were genuinely popular — archaeological finds of Song-era printed almanacs in tombs and temple caches show wide circulation.

The 1741 imperial standard

The most authoritative single source for the modern Chinese almanac is the Qinding Xieji Bianfang Shu (《钦定协纪辨方书》, “Imperially Authorized Book of Coordinating Sequences and Distinguishing Directions”), completed in 1741 under the Qianlong Emperor of the Qing dynasty. Compiled by a committee headed by Yinlu (允禄) and a number of court astronomers, it runs to 36 volumes and is the largest single attempt to standardize the rules of the Chinese almanac.

What the Xieji Bianfang Shu codified:

• The full table of stem-branch combinations and their elemental correspondences.
• The rules for assigning day-god and lunar-mansion to each date.
• The yi-ji table — every traditional activity, with the day-god and mansion combinations that favored or disfavored it.
• The directional system (东南西北 plus the four corner directions, each with elemental association).
• The corrections for solar terms, which shift the elemental flavor of the day.

Most modern Chinese almanac apps and websites trace their daily readings back to the 1741 standard, sometimes with later additions. The Daily Fortune tool on this site uses a simplified version of the same rules — the elemental reading and the stem-branch are pulled straight from this framework, and the yi-ji style descriptions are written in the same tradition.

What the tool keeps from the tradition

The Daily Fortune tool is a simplified, web-friendly version of the almanac. It keeps the following pieces of the classical framework:

• Stem-Branch. The day’s two-character label in the sexagenary cycle, calculated from the date.
• Element and Direction. Derived from the stem-branch and from the current solar term.
• Lucky color and number. Soft additions based on the element of the day — not part of the classical almanac, but consistent with the elemental color theory used elsewhere on this site.
• Yi / Ji (suitable / unsuitable). A short list, written in the spirit of the classical yi-ji column but simplified for a modern reader.
• Overall, Career, Love, Wealth, Health. Brief paragraphs in the style of newspaper horoscope columns — explicitly cultural-entertainment language, not actuarial predictions.

What the tool leaves out, and why that matters

The simplification is significant. A traditional almanac consultation, done well, includes:

• The full day-god (建除) and lunar-mansion (二十八宿) lookup, not just the elemental flavor.
• The interaction between the day and the person’s own birth chart (八字). A traditional almanac user would compare the day’s stem-branch to their own to see whether the day is friendly or unfriendly to them specifically.
• The hour-by-hour breakdown within the day. Classical almanacs include twelve two-hour windows, each with its own yi-ji.
• Adjustments for unusual celestial events — eclipses, planetary conjunctions, and so on.

The tool gives you the elemental flavor of the day plus a stylized yi-ji summary. It is a meaningful slice of the tradition; it is not the whole tradition. If you want the full version, any reputable Chinese almanac (the printed 老黄历, the 通胜, the digital editions of Xieji Bianfang Shu) goes much deeper.

The honest framing

Three things worth saying clearly, in case the post so far has not been clear enough:

1. The almanac is a cultural framework, not a scientific or predictive instrument. The Daily Fortune tool sits in that same category. It is offered for cultural interest and as a small daily reading prompt, not as a basis for medical, financial, legal, or life-changing decisions.
2. Even within the tradition, the almanac was treated as one input among many. The Qing court records show emperors consulting the almanac and then consulting their advisors, doctors, and ministers. The almanac was never the final word.
3. The simplified version this site offers is one step further removed. It is best used the way many people use a newspaper horoscope: as a brief, gentle prompt that may or may not match your day, with no obligation to take it seriously.

If you want a practical guide to reading the tool’s output without taking it too seriously, see the companion post: How to Use Your Daily Fortune Reading.

If you want to go further

A few starting points, in increasing depth:

• For a quick overview in English: Wikipedia’s article on the Chinese calendar is a good starting point; the section on the sexagenary cycle is the most relevant.
• For the modern popular almanac: any 老黄历 at a Chinese-language bookstore, or any of the established mainland and Hong Kong online almanacs. Baidu Baike on 黄历 has a useful Chinese-language summary.
• For the academic-level source: the Qinding Xieji Bianfang Shu (《钦定协纪辨方书》), 1741, available in modern reprints from Zhonghua Shuju (中华书局) and several digital editions through Chinese academic libraries.
• For the oracle-bone origins: David Keightley’s Sources of Shang History (University of California Press, 1978) is still the standard English-language scholarly treatment.

And if you want a daily reading from the simplified version of this 3,200-year tradition: Daily Fortune →. For how to actually use the reading you get, see the companion post.

One more thing

The most useful aspect of the almanac, in my experience, is not its predictions. It is the way it puts a small punctuation mark on each day — a brief moment of pause where you look up what the day is supposed to be carrying, and then go about your business. The tradition has done this for 3,200 years. The Daily Fortune tool is a small modern version of that pause. Take it lightly, with the same affection my grandparents took their 老黄历.

Try Daily Fortune →

— Want to keep reading? See How to Use Your Daily Fortune Reading next.