The twelve earthly branches

What the columns mean

id (string)

Stable row identifier, unchanged across versions

thu_tu (int)

Position in the cycle of 12, Tý is 1 and Hợi is 12

chi (string)

Earthly Branch name

con_giap (string)

Earthly branch animal, using Vietnamese naming

ngu_hanh (string)

Five elements of the branch

ngu_hanh_en (string)

Five elements of the branch, in English

khung_gio (string)

Two hour range in the day corresponding to the branch, Vietnam time

nguon (string)

Kind of source for this row, one or more parts separated by semicolons, each being tinh-toan (computed by the engine), quy-uoc-truyen-thong, quy-uoc-he-hien-dai (convention of a tradition or of a modern system), van-ban (with the work after a colon) or bien-tap (with details); static details are also in the metadata nguon_chi_tiet, and the two largest datasets give them only there; which column belongs to which part is given by each column's loai_bang_chung in the metadata

ghi_chu (string)

Where the schools disagree on this row; empty when they do not

Release

Data release ID

2026.10.27-cd6fca71 · manifest.json

Dataset version

1.1.1

Dataset last changed

2026-09-30The date in the release ID is when the most recently changed dataset of the whole release changed. This dataset has not changed since the date above, so it keeps its version and is still part of this release.

Generated

2026-10-27 08:07 UTC

Rows

12 rows, 9 columns

Schema hash

a1cb39bcc7a2a82f…Copysha256 of each column's name and type

Download this exact release

• 12-dia-chi.csv · 836 B · sha256 ab5435e4fa841633…Copy
• 12-dia-chi.json · 2.7 KB · sha256 f53d117b8517246b…Copy
• 12-dia-chi.meta.json · 17.7 KB · sha256 b1616789526dfbe1…Copy

The “CSV for Excel” button at the top serves a copy with a BOM, so its hash differs from the CSV here.

Changes

Version 1.1.1 (2026-09-30), type documentation: Metadata adds source_ids (source register nguon-thu-tich.csv), rule_ids (rule register quy-tac.json), danh_muc_tu_vung_nguon (the eight kinds of the nguon column with their English equivalents), a per-column epistemic_status and danh_muc_epistemic_status; the data is unchanged byte for byte.

Changelog of every dataset (CHANGELOG on GitHub)

Method

This dataset goes through no calendar model.

Engine version of the release: 2.0.0.

Verification

Invariants checked on the released file itself:

• con_giap is fully determined by chi
• ngu_hanh is fully determined by chi
• khung_gio is fully determined by chi

Evidence types in this dataset, and how far each can be checked:

• C. Convention of a tradition or of a modern system: correct by that convention, neither true nor false in an empirical sense; where schools differ is recorded in the diem-bat-dong-giua-cac-phai dataset.

Provenance

A lookup table copied from the source texts or systems named in nguon_thu_tich and the nguon column.

• C. Convention of a tradition or of a modern system: thu_tu, chi, con_giap, ngu_hanh, ngu_hanh_en, khung_gio

Cite this dataset

Nhật Nguyệt (2026). The twelve earthly branches (version 1.1.1, data release 2026.10.27-cd6fca71) [Data set]. CC BY 4.0. DOI 10.5281/zenodo.23009396. https://nhatnguyet.org/en/bang/12-dia-chiCopy

The concept DOI always resolves to the latest release. Zenodo mints a DOI for each release after it is published, and the next release records it in the manifest.

Licence and limitations

Released under CC BY 4.0: reuse commercially, adapt freely, attribution is all that is asked.

Source: Nhật Nguyệt (nhatnguyet.org), CC BY 4.0

This dataset records cultural and calendrical conventions, not scientific claims. It is suitable for cultural research, NLP, and calendar applications. It is not intended for predicting events, evaluating people, or making decisions that affect anyone.

Other reference tables

• The ten heavenly stems
• Compatibility matrix of the 12 earthly branches
• The twelve day officers (Thap Nhi Truc)
• The 22 Major Arcana of the Tarot
• The 24 solar terms
• The 56 Minor Arcana cards
• Sexagenary cycle table (60 Hoa Giap)
• The 64 hexagrams of the I Ching
• The nine presiding stars (Cuu Dieu)
• Zodiac sign boundaries year by year, 1950 to 2050
• Retrieval evaluation set for Vietnamese folk belief and calendar
• Letter to number tables, Pythagorean and Chaldean
• Kua number and Bat Trach directions
• Where the schools disagree
• Auspicious hours across the sixty-day stem-branch cycle
• The sixty stem-branch pairs crossed: sounds, harmony, clash and element relation
• Questions and answers on Vietnamese offering rites
• Things to avoid and practical notes for Vietnamese offering rites
• Vietnamese festivals mapped to solar dates, 2026 to 2030
• Festivals and folk beliefs of the 54 ethnic groups of Vietnam
• Vietnamese festivals, seasonal feasts and public holidays
• Vietnamese ritual offerings
• Vietnamese lunisolar calendar, 1900 to 2100
• Types of Vietnamese offering rites
• Start moments of the 24 solar terms, 1900 to 2100
• Folk inauspicious days mapped onto solar dates, 2026 to 2035
• Vietnamese offering procedures
• Daily hexagram by the Gua Qi method, 1900 to 2100
• Tam Tai, Kim Lau and Hoang Oc by birth year and year in question
• Order of the sixty Gua Qi hexagrams
• Segments of the three Lo Ban rules
• Vietnamese offering prayers (văn cúng)

See every reference table