天衍奇門開放資料:節氣對照、局數表與整盤對照(CC0,可下載)

發布於

天衍奇門的排盤規則和驗證結果,都寫在排盤規則頁裡。這一頁把背後的資料整理成可以直接下載的檔案,方便研究者、開發者和其他軟體作者核對、引用,或者拿來測試自己的排盤程式。

所有檔案以 CC0 1.0(公有領域) 公開:不需要註冊、不留郵箱,可以複製、修改和商用,也不需要署名。

三份資料

檔案內容行數
solar-terms-vs-hko-2026-2028.csv2026–2028 年 72 個節氣:香港天文臺公佈的時刻、天衍奇門引擎算出的時刻、相差分鐘數72
ju-number-table.csv拆補法局數表:24 節氣 × 上中下三元,註明陽遁或陰遁24
board-comparison-china95.csv56 個北京時間時刻與元亨利貞網(轉盤 + 拆補無閏法)的整盤對照:四柱、局數、值符值使、九宮每格的幹星門神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],我們核對後更正並記入更正記錄。