算法与数据来源
本站每一栏是怎么算出来的、数据从哪来、哪些地方各家会不一样。
页面上的内容是怎么来的
每日黄历页不是从某个接口取回来的,而是由一段程序现算的:给它一个日期,它算出这一天的全部栏目。程序分三部分。
- 历法:公历转农历、节气、年月日干支,由开源库 tyme4ts 按天文算法推算。
- 按规则排的栏目:建除十二值星、黄道黑道十二神、冲煞、时辰吉凶、二十八宿、喜神财神等方位、胎神、彭祖百忌、纳音。这些只取决于干支,规则是公开的。
- 查表的栏目:宜、忌、吉神、凶煞。这是一张按"月支 × 日干支"共 720 格的表,开源库自带。
哪些栏目各家一致
我们把本站的引擎和另一个开源库(lunar-javascript)逐日对比了 1900 年到 2100 年共 73414 天。农历日期、年干支、日干支、冲煞、星宿、方位、胎神,没有一天不同。
有差别的只有 10 天,分属五个节气:1912 年小雪、1913 年秋分、1917 年大雪、1927 年白露、1928 年夏至。这五个节气的交节时刻非常接近零点,两个库算出来的日期差一天。其中大雪和白露是分月的"节",所以 1917 年 12 月 7 日和 1927 年 9 月 8 日这两天,月份和随之而变的建除、值神、宜忌也不同。这 10 天的页面上有提示。
这两个库出自同一位作者,所以上面的对比不能算完全独立。我们另外拿香港天文台的"公历与农历日期对照表"逐日对了一遍,1901 年到 2100 年共 73049 天,比的是农历日期和节气落在哪一天。不同的只有两处:
- 2057 年农历九月:天文台把九月初一定在 9 月 28 日,本站算在 9 月 29 日,所以 9 月 28 日到 10 月 27 日这 30 天,本站的农历日比天文台晚一天。天文台在表的说明里提示,这个朔离零点太近,几十年后的计算误差足以让日期差一天。
- 1979 年大寒:天文台在 1 月 21 日,本站在 1 月 20 日。
上面两个库有分歧的那 10 天,天文台的表都与本站一致。这 32 天的页面上有提示。干支、冲煞这些栏目天文台的表里没有,仍只有两个库互相对照。
本站的口径
| 问题 | 本站的做法 |
|---|---|
| 时区 | 一律按北京时间,不随你所在的地方变 |
| 一天从几点开始 | 零点。晚上 11 点换日是八字排盘的做法,黄历不用 |
| 交节当天算哪个月 | 整天算新的月份 |
| 年什么时候换 | 农历年和生肖按春节换;干支年按立春换。两者不同时页面上会说明 |
| 年份范围 | 1900 年到 2100 年 |
背景知识见二十四节气与"月"的两种算法。
宜忌用的是哪一套
宜忌没有官方标准。本站主栏用的是"通行版":市面上主流万年历共用的那张 720 格的表。我们取了一个主流日历产品 274 天的线上数据来对比,把白话还原成传统术语以后,宜完全相同的有 229 天,忌完全相同的有 251 天。所以你在这里看到的宜忌,和在别处看到的基本一致。
这张表整理自历代通书,具体出自哪一家已经说不清;开源库的文档只写着数据来自第三方网站。它不是由某个已知的算法生成的。详见为什么各家黄历的宜忌不一样。
本站综合评级
页面上"大吉、吉、平、凶"四档是本站自己定的参考,不是古书里的概念。它把两个各家算法一致的栏目合起来看,公式如下,你可以自己验算。
| 档 | 条件 | 四年样本里的占比 |
|---|---|---|
| 大吉 | 黄道日,且值星是除、危、定、执、成、开 | 23.3% |
| 吉 | 其余黄道日 | 18.1% |
| 平 | 黑道日,但值星是除、危、定、执、成、开 | 23.1% |
| 凶 | 其余黑道日,或下面任一条 | 35.5% |
一律归凶的情形:值星为破(月破日);四离(春分、夏至、秋分、冬至的前一天);四绝(立春、立夏、立秋、立冬的前一天);当日宜栏或忌栏注"诸事不宜"。
值星的取舍依据民间口诀"建满平收黑,除危定执黄,成开皆可用,闭破不相当"。除"诸事不宜"这一条外,评级不看宜忌,所以评级高不等于某件具体的事宜办。要办某件事,请看"宜"里有没有它、"忌"里有没有它,以及这天冲不冲当事人的生肖。择吉日页就是按这个办法列的。
古法推演(试验版)
每日页上还有一栏"古法推演"。它不查表,而是按清代官修的《钦定协纪辨方书》的规则逐日推演:先排出当天的吉神凶煞,汇总各神所宜所忌,再按"宜忌等第"裁决冲突。它与通行版并列显示,不参与综合评级。两套都有结论的"事项 × 日"里,约三成结论相反。原理见宜忌是怎么推出来的。
本栏以开源库 cnlunar 0.2.5 的移植为基线(逐日对过账),按原书订正了一批神煞的排法、宜忌清单和铺注条例,并照卷十补上了参考实现没有做的几类规则:止忌某事馀皆不忌、与德合并犹忌、与某某并则不忌、与某神并则另宜某事、"遇德"按每一行点名的德神判断、月厌条点名的特定干支,以及上朔、晦日、四离四绝、二分二至等特殊日。无禄日、兵禁和岁薄、逐阵、阳错、阴错"从厌所忌"的部分还没有做,"宜忌等第表"也没有对照影印本核实;只核对过 2020–2031 年。
目前共有 40 条按原书所作的订正和补充,每一条都在本地的四库全书本原文里找到了明文,并由程序核对过引句所在的卷和行。这一栏标"试验版",是因为还有几类规则原文的读法没有定,原书的"宜忌等第表"也没有对照影印本核实。
范围与提醒
- 通行版各栏在 1900–2100 年范围内与另一个库逐日对过。古法推演只逐日核对过 2020–2031 年,范围之外的日期照常显示,但页面上会注明。
- 福神方位有两种流派,本站两种都列。胎神、吉神凶煞各家的名目也不尽相同。
- 本站的知识文章和词典目前是初稿,尚未逐条核对,页面顶部有提示。
- 黄历是民俗文化。本站只介绍传统上怎么说、怎么算、出自哪里,不替你做决定。就医、法律、投资等事,请以专业人士的意见为准。见黄历可信吗。