An Introduction to 《玉匣记》: A Folk Almanac of Auspicious Selection, Everyday Divination, and Folk Numerological Lore
An overview of the historical background, transmission, textual structure, and date-selection functions of 《玉匣记》, explaining why it became an important folk manual within the systems of auspicious dating and miscellaneous divination.
《玉匣记》, also commonly known as 《玉匣记通书》《增补玉匣记》《万全玉匣记》, is a widely circulated folk compendium in China for date selection, auspicious timing, and miscellaneous divination. Compared with 《协纪辨方书》, it lacks a strongly official editorial character. Instead, it resembles a long-used folk manual that has been continually supplemented and reprinted over time, functioning as an encyclopedic guide to practical numerological tradition in everyday life.
Its content is highly eclectic: it includes date-selection rules for marriage, travel, business openings, earth-moving, burial, and ritual offerings, as well as divinatory practices involving eye twitching, tinnitus, dream interpretation, cat reading, dog-omen matching, bone weight divination, prayer and propitiation rituals, and anti-evil dispelling methods. Precisely because of this “eclectic” character, 《玉匣记》 is especially practical in folk contexts. It does not only tell people which days are favorable or unfavorable; it also gathers a large body of ordinary-life signs, taboos, warding practices, and choice methods together in one place.
In adding the “Yuxiajji Auspicious Date” section to the site, my goal is not to present it as a mysterious authority, but to organize the rules found in this type of folk manual so readers can see how traditional date selection and folk divination actually operate in everyday life.
1. Historical Background of 《玉匣记》
The authorship tradition of 《玉匣记》 is complicated. The common explanation attributes it to Xun of Jin (traditionally identified as “Zhuo Xin Jun” in local lore). Some versions also invoke Zhuge Kongming, Guiguzi, Master Zhang, Li Chunfeng, Duke Zhou, and Yuan Tanggang as credited authorities. This is typical in traditional numerology texts: book titles and attributions often carry symbolic authority and do not necessarily match modern notions of single authorship and composition process.
From a textual perspective, 《玉匣记》 is better understood as a long-lived folk compendium tradition rather than a single work written by one person at one time. Through copying, print circulation, recollation, and supplementation, it absorbed various streams of fortune timing, omen interpretation, warding practices, and daily taboos, resulting in many variant editions.
Since the Ming and Qing periods, such handbooks have played an important role in everyday life. Marriage and funerary rites, moving households, construction, opening a shop, travel, ritual offerings and blessings—all these matters often required checking dates against the manual. 《玉匣记》 flourished in this cultural environment. Unlike official classics that aim for systematic doctrinal consistency, it emphasized “easy lookup, practical use, and broad coverage.”
For this reason, 《玉匣记》 should not be treated only as a date-selection text. It also functions as a social technology for managing uncertainty: when major life events arise, people consult auspicious and inauspicious days; when strange signs appear, they seek omen interpretation; when anxiety appears, they seek warding or ritual; when facing routine actions, they look for an acceptable timing and method.
2. What the Title “Yuxiaji” Means
The phrase “Yuxia” carries meanings of treasured preservation, secrecy, and transmission. Folk numerology texts often use similar naming patterns, presenting knowledge as teachings passed down from immortals, sages, or hidden canonical texts, thereby increasing perceived sanctity and authority.
1. “Yuxia” as Secrecy and Treasured Preservation
A “box” stores precious objects; a “jade box” carries connotations of value, purity, and mystique. Calling the material “Yuxiaji” suggests these rules of timing, omen reading, and ritual are treated as hidden essentials, preserved and then released only through transmission.
This naming fits the distribution logic of folk manuals: knowledge does not become trustable simply by being knowledge; it also needs a recognized source and sacred narrative to endure through generations.
2. “Ji” Indicates a Compiled Reference
The character “ji” is also important. It is not like “jing,” which stresses canonical certainty, nor like “lun,” which emphasizes theoretical argumentation. It is closer to recording, compilation, and reference filing.
That aligns well with the form of 《玉匣记》: rather than a purely theoretical treatise, it is a folk handbook that gathers various auspicious-date rules, taboos, omen tests, and miscellaneous techniques.
3. Basic Content of 《玉匣记》
There are many versions of 《玉匣记》, with differences in included material, order, volume count, and wording. Common editions usually center on date selection, auspicious and inauspicious rules, divine spirits and spirits’ influences, omen interpretation, and warding practices.
1. Auspicious and Inauspicious Date Guidance
This is the core and most website-relevant part of 《玉匣记》. It lists auspicious or inauspicious judgments for many activities, such as:
- Worship and ritual offerings
- Blessing and merit-making rites
- Marriage
- Travel
- Opening a business
- Earth-moving
- Construction
- Burial
- Entering a home
- Appointment and post placement
- Planting and farming
These topics are closely related to the common almanac, but 《玉匣记》 often includes more folk-oriented, detailed rules and scenarios closer to ordinary daily practice.
2. Deity/Spirit Factors and Daily Timing Rules
Date selection is inseparable from deity and spirit factors. 《玉匣记》 commonly includes various auspicious deities, malevolent influences, day classifications, calendrical taboos, directions, monthly restrictions, and daily prohibitions. Some rules seem to come from earlier calendrical and selection traditions; others likely represent later folk additions.
From a data-structuring perspective, this is both the most valuable and the most sensitive section. The same spirit factor may be defined differently across texts, and the same rule may vary in wording between versions. Careful comparison against multiple textual sources is necessary rather than relying on a single edition.
3. Everyday Omen Tests
A major difference between 《玉匣记》 and 《协纪辨方书》 is the large inclusion of everyday omen-reading material. Examples include eye twitching, tinnitus, facial heat, sneezing, dream divination, dog barking, and bird calls.
These passages reflect folk interpretations of bodily sensation, animal behavior, dreams, and incidental events. Modern readers may not adopt them wholesale, but they are highly useful for understanding how earlier communities interpreted signs, risk, and uncertainty.
4. Warding and Counteracting Malevolent Forces
Some versions also include prayers, disaster-deflection, exorcistic warding, taboos, space protection, and calming practices. These components have clear folk-religious coloring and overlap with Daoist ritual, popular belief, and sacrificial customs.
From a cultural perspective, this shows 《玉匣记》 is not only about “choosing dates”; it also offers a practical set of responses to misfortune, anxiety, and bad omens.
5. Miscellaneous Everyday Numerological Material
The “miscellaneous” in 《玉匣记》 extends to many practical subjects: cat omens, ritual dog adoption, bone-weights, fate divination, marriage taboos, and agricultural timing restrictions, among others. It resembles a folk toolbox for daily life: not aimed at constructing a rigorous academic system, but at serving practical use.
This is part of why it spread so easily in folk communities. Most people did not need to master complex theory; they needed a handbook they could consult quickly.
4. What Problems 《玉匣记》 Primarily Addresses
The function of 《玉匣记》 can be summarized in four categories.
1. Providing Date Guidance for Major Daily Affairs
Marriage, moving home, business opening, construction, travel, and burial are all matters in traditional society where one tries to avoid taboo days and choose favorable timing.
《玉匣记》 offers extensive lists of auspicious and inauspicious entries to support consultation in those cases. It may not be as structurally complete as official date-selection classics, but it is rich in scenarios, direct in language, and easy for folk use.
2. Supplying a Framework for Interpreting Folk Signs
Eye twitching, tinnitus, dreams, unusual animal behavior, and bodily sensations are generally treated as random phenomena by modern standards. In the traditional folk worldview, however, these often function as potential signals.
《玉匣记》 organizes these observations into entries that suggest what kinds of fortunes might correspond to particular signs. This framework may not align with modern science, but it reveals how ordinary communities historically processed uncertainty and anxiety.
3. Offering Warding, Harm-Repelling, and Avoidance Methods
When people judged a day, event, or sign as unlucky, the typical next step was not merely fear; it was to seek ways to mitigate. The ritual and avoidance content in 《玉匣记》 is a direct product of this practical psychological and folk-ritual need.
From a social-function view, these methods transform uncontrollable risk into actionable ritual procedures.
4. Forming a Folk Encyclopedic Knowledge Base
A major characteristic of 《玉匣记》 is its blending of date selection, omen interpretation, taboos, warding practices, and lived experience. It is not a modern taxonomic monograph, but it resembles a traditional “knowledge repository” for everyday life.
If one were to rebuild it on a modern website, these contents could be split into modules: date-selection rules, activity categories, spirit-factor algorithms, omen entries, folk interpretations, and textual collation. This makes a dispersed compendium much easier to search and understand.
5. Difference Between 《玉匣记》 and 《协纪辨方书》
Since my site covers both 《协纪辨方书》 and 《玉匣记》, it is useful to distinguish them.
1. One Is Official and System-Oriented; the Other Is Folk-Practical
《协纪辨方书》 is an auspicious-date classic assembled under official Qing institutional guidance, with emphasis on formalization, standardization, and the establishment of a coherent selection-system framework.
《玉匣记》, by contrast, is closer to a folk handbook and emphasizes broad coverage of everyday needs. It discusses not only date selection, but also miscellaneous divination, signs, warding, and practical taboos.
2. One Prioritizes Rule Analysis, the Other Entry Compilation
《协纪辨方书》 places greater weight on rule provenance and explanatory notes, making it suitable for studying selection theory and algorithmic structure.
《玉匣记》 functions more as a compiled index, useful for querying specific types of matters, signs, or taboos. Its theoretical rigor may be looser, but its folk material is richer.
3. One Suits a Core Date-Selection Engine, the Other a Cultural Extension Layer
For a strict auspicious-date rule engine, 《协纪辨方书》 is the better core reference.
If you want an auspicious-date tool to feel closer to folk tradition and everyday practice, 《玉匣记》 provides abundant supplementary material. Used together, they can preserve a formal rule core while still conveying lived folk usage.
6. Why 《玉匣记》 Fits Well for Website Features
Although 《玉匣记》 is mixed in content, that very eclectic nature suits digital structuring.
1. Many Discrete Entries, Ideal for Structuring
Most content in 《玉匣记》 can be decomposed into discrete entries: favorable/forbidden day, forbidden activity, sign auspiciousness, activity-type rule, or mitigation method. Each entry can be organized by title, conditions, explanation, source, scope, and cautions.
This converts well to databases, JSON files, and searchable pages.
2. Broad Scenarios, Ideal for User Queries
A site user may not know which spirit factor to check first, but likely knows the intended action: marriage, opening a business, travel, moving house, earth-moving, burial, ritual offerings, blessing rites, and so on.
The strength of 《玉匣记》 is precisely that it starts from action contexts and infers what to avoid, what to consult, and how to interpret results.
3. Suitable for Pairing with Modern Interpretation
Many entries in 《玉匣记》 cannot be treated as direct modern factual claims, but they can be presented as traditional culture, folk psychology, and esoteric knowledge.
A good site presentation can separate “original text,” “plain-language explanation,” “modern commentary,” and “usage boundaries.” In this way it avoids both dismissing tradition outright and presenting it as scientific fact.
7. Precautions When Reading and Using
《玉匣记》 has high folk-cultural value, but boundaries must be observed in reading and use.
1. Do Not Treat Attributed Authors as Verified History
Many versions state “by Master Xu Zhenjun” or similarly attribute to other ancient figures. A more careful formulation is: 《玉匣记》 is commonly attributed to Xun and was repeatedly supplemented in later periods, producing many versions. Do not state simplistically that Jin-dynasty Xun personally completed the entire work.
2. Do Not Treat All Versions as the Same Book
There are versions such as 《玉匣记》 and 《增补玉匣记》《万全玉匣记》《绘图玉匣记》 with additions, deletions, reordering, transcription errors, and later insertions. For site organization, it is best to state the edition used and preserve source provenance as much as possible.
3. Do Not Treat Folk Omen Reading as Scientific Conclusion
Eye twitching, tinnitus, dream reading, and animal omens belong to traditional folk interpretive systems. They can be examined as cultural material and organized as traditional omen entries, but they should not replace medical, psychological, legal, safety, or professional judgment.
4. Do Not Rely on a Single Line Item
Auspicious-date systems require holistic judgment. Reading a single “auspicious” or “inauspicious” line in isolation often misleads. For matters like marriage, burial, construction, and ground-breaking, one also needs to consider birth context, direction, hour, solar term, spirit factors, clashes, and combinations.
8. Conclusion: From Folk Almanac to Digital Knowledge Base
The value of 《玉匣记》 is not that it is as tidy as official classics, nor that every line can be directly accepted by modern readers. Its real value lies in preserving a large body of folk material on date selection, omen interpretation, taboos, and warding practices.
It reflects a complete traditional framework for interpreting marriage, funerary rites, construction, travel, illness, dream signs, and everyday uncertainty. Through it, we can see how these practices entered ordinary life rather than remaining only within fortune-tellers, geomancers, or official calendrical institutions.
I included “Yuxiaji Auspicious Date” on the site to break down, organize, cross-check, and interpret this type of folk compendium. It can complement 《协纪辨方书》: the former is rooted in folk life experience, the latter in official auspicious-date systems. Together, they provide a fuller picture of traditional date-selection culture.
Our site’s Auspicious Date Lookup Tool allows users to view daily solar terms, auspicious/inauspicious entries, and the Twelve Generals (Jiunchu), and is intended to be used alongside this article.
Frequently Asked Questions
How does this book’s date-selection method differ from modern almanacs?
Classical astrology selection generally emphasizes Five-Phase interactions, Heavenly Stems and Earthly Branchs, and spirit-factor systems; modern manuals tend to focus more on the Twelve Generals and daily almanac auspiciousness. The two are historically connected, but differ in methodological emphasis and granular choices.
Do I need to understand the Four Pillars before learning auspicious-date selection?
A foundation in Four Pillars helps with understanding stem-branch logic, but it is not required. Beginners can start with daily almanac taboos, the Twelve Generals, and basic disaster-direction concepts, then deepen gradually.
Where can I find the original text or annotated editions of this book?
Most traditional date-selection works are available digitally on platforms such as the Siku Quanshu at Wenyuange and Guoxue Master sites. This article is for introductory textual guidance only.
How should I use this for practical date lookup with tools?
You can use this site’s Auspicious Date Lookup Tool to check daily solar terms, Twelve Generals, and auspicious/inauspicious judgments for practical reference alongside the text.
References
Share