Open data
The ten heavenly stems
The ten heavenly stems with the five-element attribution and yin-yang polarity of each.
10 rows · 8 columns · version 1.1.1, last changed 2026-09-30
| id | thu_tu | can | ngu_hanh | ngu_hanh_en | am_duong | nguon | ghi_chu |
|---|---|---|---|---|---|---|---|
| 1 | 1 | Giáp | Mộc | Wood | Dương | quy-uoc-truyen-thong | |
| 2 | 2 | Ất | Mộc | Wood | Âm | quy-uoc-truyen-thong | |
| 3 | 3 | Bính | Hỏa | Fire | Dương | quy-uoc-truyen-thong | |
| 4 | 4 | Đinh | Hỏa | Fire | Âm | quy-uoc-truyen-thong | |
| 5 | 5 | Mậu | Thổ | Earth | Dương | quy-uoc-truyen-thong | |
| 6 | 6 | Kỷ | Thổ | Earth | Âm | quy-uoc-truyen-thong | |
| 7 | 7 | Canh | Kim | Metal | Dương | quy-uoc-truyen-thong | |
| 8 | 8 | Tân | Kim | Metal | Âm | quy-uoc-truyen-thong | |
| 9 | 9 | Nhâm | Thủy | Water | Dương | quy-uoc-truyen-thong | |
| 10 | 10 | Quý | Thủy | Water | Âm | quy-uoc-truyen-thong |
What the columns mean
id(string)- Stable row identifier, unchanged across versions
thu_tu(int)- Position in the cycle of 10, Giáp is 1 and Quý is 10
can(string)- Heavenly Stem name
ngu_hanh(string)- Five Elements of the stem
ngu_hanh_en(string)- Five Elements of the stem, in English
am_duong(string)- Yin or Yang
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
- 10 rows, 8 columns
- Schema hash
6c726102539a14d0…sha256 of each column's name and type
Download this exact release
- 10-thien-can.csv · 549 B · sha256
b2bd2bab1e74bc6f… - 10-thien-can.json · 1.9 KB · sha256
8be15dd6cacc78c8… - 10-thien-can.meta.json · 16.2 KB · sha256
baded74d71e19c7a…
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
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,can,ngu_hanh,ngu_hanh_en,am_duong
Cite this dataset
Nhật Nguyệt (2026). The ten heavenly stems (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/10-thien-can
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
- Compatibility matrix of the 12 earthly branches
- The twelve 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)
