天衍奇門開放資料:節氣對照、局數表與整盤對照(CC0,可下載)
發布於
天衍奇門的排盤規則和驗證結果,都寫在排盤規則頁裡。這一頁把背後的資料整理成可以直接下載的檔案,方便研究者、開發者和其他軟體作者核對、引用,或者拿來測試自己的排盤程式。
所有檔案以 CC0 1.0(公有領域) 公開:不需要註冊、不留郵箱,可以複製、修改和商用,也不需要署名。
三份資料
| 檔案 | 內容 | 行數 |
|---|---|---|
| solar-terms-vs-hko-2026-2028.csv | 2026–2028 年 72 個節氣:香港天文臺公佈的時刻、天衍奇門引擎算出的時刻、相差分鐘數 | 72 |
| ju-number-table.csv | 拆補法局數表:24 節氣 × 上中下三元,註明陽遁或陰遁 | 24 |
| board-comparison-china95.csv | 56 個北京時間時刻與元亨利貞網(轉盤 + 拆補無閏法)的整盤對照:四柱、局數、值符值使、九宮每格的幹星門神 | 56 |
| qimen-open-data.json | 以上三份合在一起,附來源說明 | 152 |
CSV 為 UTF-8(帶 BOM,Excel 可直接開啟中文)。
每份資料怎麼讀
節氣對照。 hko_time_hkt 與 qimena_time_hkt 都是香港時間(UTC+8,和北京時間相同);diff_minutes_qimena_minus_hko 為正,表示我們的引擎比天文臺晚。三年 72 個節氣全部在 1 分鐘以內(天文臺只公佈到分鐘)。注意 qimena_time_hkt 來自我們引擎使用的預先算好的節氣時刻表(由 tyme4ts 生成),所以與天文臺吻合是預期的;獨立的核對是用另一個天文庫 astronomy-engine 比對錶中 1900–2100 年 4,824 個節氣,最大偏差 1.0 分鐘,平均 0.2 分鐘。香港天文臺的時刻來自英國航海曆局和美國海軍天文臺的資料,讀取日期為 2026-09-29。
局數表。 第一行冬至,之後依次到大雪;冬至至芒種為陽遁,夏至至大雪為陰遁。三元由當日符頭的地支決定:子午卯酉為上元,寅申巳亥為中元,辰戌醜未為下元。
整盤對照。 result 列為 identical 表示四柱、局數、值符值使以及八個外宮每一宮的天盤幹、地盤幹、九星、八門、八神都與對方完全一致;different 的行附有 first_differences(我們和對方各是什麼)和 note(原因)。56 個時刻中 16 個是節氣交界與特殊時刻,40 個是隨機奇數整點。結果:49 個完全一致,7 個不同,7 個差異的原因都在對方的節氣時刻或月柱規則(詳見排盤規則頁)。
使用時請注意
- 整盤對照用的是北京時間的鐘表時刻,不做真太陽時校正。 這和天衍奇門網頁上預設的排盤方式(按起局地經度校正)不同,對照時請按檔案裡寫明的方式起局。
- 只對照了一個網站。 不同流派的軟體(置閏法、飛盤法等)盤面不同,這不一定是誰算錯,見流派的選擇。
- 讀取時間是 2026 年 10 月。 對方網站今後可能更新規則,本表記錄的是當時的輸出。
想引用或復現
引用可以寫:天衍奇門開放資料(qimena.com/wiki/qimen-open-data/),2026-10-13,版本 1.0。想自己復現整盤對照的做法,把表裡任意一個時刻同時輸入你的程式和元亨利貞網的轉盤奇門(拆補無閏法)比較即可,一個時刻一個盤面,幾分鐘就能核對完。
如果你發現資料有誤,或者你用其他軟體得到了不同的結果,歡迎把軟體名稱、時間和差異發到 [email protected]。想看這些資料怎麼用在排盤上,可以試試免費 AI 排盤。
常見問題
這些資料可以隨便用嗎?
可以。三份資料都以 CC0 1.0 公開,等同放棄著作權,可以複製、修改、商用,不需要署名,也不需要聯絡我們。如果願意註明來源,寫“天衍奇門開放資料”即可。
怎麼用這份資料測試自己的排盤程式?
把你的程式在同樣的 56 個北京時間時刻起局,與整盤對照表裡的四柱和局數比較;節氣表可以用來檢驗你的節氣演算法,局數表可以核對拆補法的查表。注意對照時用北京時間的鐘表時刻,不做真太陽時校正。
資料是怎麼得來的?有沒有可能錯?
節氣時刻對照的是香港天文臺公佈的時刻,局數表是傳統口訣表,整盤對照是在元亨利貞網同一時刻起局後逐項比對。對照網站的結果是我們讀取的,不代表它始終如此。發現問題請發郵件到 [email protected],我們核對後更正並記入更正記錄。