LunarData

LunarData是一个覆盖1970年至2100年的农历数据集，提供农历、干支、节气、宜忌、吉时、神明诞辰、彭祖百忌、九宫飞星等传统历法信息。数据以JSON和JS格式存储，包含详细的字段说明，适用于前端查询和开发。LunarData is a traditional Chinese lunar calendar dataset spanning from 1970 to 2100, providing comprehensive traditional calendrical information including lunar date, sexagenary cycle (Ganzhi), solar terms, daily auspicious and inauspicious activities, auspicious time slots, birthdays of traditional deities, Pengzu's Taboos, and Nine Star Flying Stars. The dataset is stored in JSON and JS formats, with detailed field descriptions, and is suitable for frontend querying and development.

原始信息汇总

数据集概述：擇日知錄 - 農民曆 (LunarData)

该数据集是一个全面的中国传统黄历查询系统，提供从1970年到2100年共131年的详尽历法信息，并以纯前端形式实现，无需后端支持。

核心功能

• 黄历核心信息: 提供农历/公历转换、天干地支（年、月、日柱）、生肖、冲煞方位、虚岁、二十四节气（含白话注解）、每日宜忌（含白话tooltip）、吉时/凶时（含时辰干支）、建除十二神、二十八宿（日宿法+月宿法）、九宫飞星、彭祖百忌（含幽默白话解释）、130位神明诞辰（含小知识）。
• 三派择日: 集成建除十二神派、天星择日派（参考二十八星宿）、紫白九星派（结合九宫飞星与八卦）三种择日体系。
• 特色功能: 包含每日吉凶颜色（依日干五行）、每日吉凶数字、西方星座（含emoji）、月相显示（朔望弦晦）、节季注解、喜/财/福神方位、胎神方位、生肖图片（冲煞卡片背景）、泰国佛日参考数据（规则推算版）。
• 特色节日: 标记天穿日、天赦日、93个冷门国际节日（含冷知识注解）、12个重要农历传统节日、泰国佛日/卫塞节/入雨安居等事件。
• 图表总览: 提供月历总览、本月吉凶比例圆饼图、本月每日五行分布、节气时间轴等可视化信息。
• 九宫飞星详解: 包含洛书九宫图、九星飞行顺序、五行相生相克图解、三元九运时间表及各星详细宜忌。

数据范围与格式

项目	内容
年份	1970 ~ 2100 (共131年)
格式	JSON + JS
语言	繁体中文
准确度	100笔抽样验证通过，另含特殊日期固定seed抽样验证

JSON字段核心说明

数据集按年份（1970/ ~ 2100/）和月份（01.json ~ 12.json）组织，每个月的JSON文件包含一个days数组，每条记录的核心字段包括：

• 基本信息: day (公历日期), gregorian (YYYY-MM-DD), weekDay, lunar (农历信息).
• 干支与五行: dayGanzhi (日干支), monthGanzhi (月干支), fiveElements (五行信息), season (节季).
• 冲煞: zodiacClash (冲煞生肖), clashDirection (煞方位), clashYearGanzhi (被冲年干支).
• 神煞与星宿: deityBirthday (神明诞辰), deityInfo (神明知识), twelveOfficer (建除十二神), twentyEightMansion/twentyEightMansion_month (二十八宿).
• 宜忌吉凶: auspicious/inauspicious (宜忌), goodGods/badGods (吉凶神), auspiciousHours/inauspiciousHours (吉凶时), todayLevel/todayLevelName (吉凶等级).
• 方位与颜色: luckyDirection (喜/财/福神方位), fetalGod (胎神方位), luckyColors/unluckyColors (吉凶颜色), luckyNumbers/unluckyNumbers (吉凶数字).
• 其他: solarTerm (节气), westernZodiac (星座), moonPhase (月相), pengTaboo (彭祖百忌), threeSchools (三派宜忌).

验证报告

数据集进行了严格的验证，主要验证结果如下：

验证项目	范围	结果
冲煞验证	100笔抽样	100% 通过 (冲煞生肖、煞方位、被冲年干支、虚岁计算)
三派宜忌验证	300组	100% 通过 (建除十二神派、天星择日派、紫白九星派)
新功能验证	100笔抽样	100% 通过 (西方星座、月相、吉凶颜色、吉凶数字)
天赦日验证	11年67天	全部通过
网络黄历比对	样例如2026年	全部通过
Thai Buddhist验证	7042笔	内部规则验证通过，与myhora在部分年份存在系统性1天偏移
特殊日期抽样验证	针对四月十五、腊月初八、卫塞节	全部通过

技术架构

项目	技术
前端	纯 HTML / CSS / JavaScript (无框架)
数据格式	JSON + JS (静态文件)
农历计算	Python cnlunar 库 (仅用于数据生成)
图表	纯 CSS 实现
响应式	CSS Grid + Flexbox
字体	Google Fonts - Noto Serif TC

快速开始

• 方式一（推荐）: 直接用浏览器开启 index.html (主页) 或 ninestar.html (九宫飞星详解)，无需安装。
• 方式二: 使用 python -m http.server 8080 启动本地服务器后访问 http://localhost:8080。

授权与引用

• 授权协议: MIT License。
• AI引用: 建议通过 llms.txt 和 llms-full.txt 了解项目摘要，引用时注明 LunarData / 擇日知錄。

搜集汇总

数据集介绍

构建方式

LunarData数据集，即“擇日知錄——農民曆”，是一个全面整合中国传统历法信息的珍贵数字资源。其构建过程严谨而周密，首先利用Python的cnlunar函数库，基于精确的六十甲子算法，为从1970年至2100年共计131年的每一天，自动生成了涵盖农历、国历转换、天干地支、生肖冲煞、二十四节气、吉凶宜忌、九宫飞星等核心黄历信息。随后，通过多维度验证脚本，包括100笔抽样验证、300组三派宜忌比对、特殊节日（如天赦日）的固定种子验证以及泰国佛日与myhora的全量交叉验证，确保了数据在冲煞、宜忌、节气划分等方面的准确性与内部一致性。最终，所有结构化数据被归档为JSON文件，并进一步转换为前端可高效调用的JavaScript格式，形成了一套纯净、可靠且无需后端服务的静态数据体系。

特点

该数据集的核心特点在于其无与伦比的全面性与深度整合能力。它并非简单的黄历查询工具，而是一部囊括了建除十二神、天星择日、紫白九星三大择日流派的综合历法典籍，并辅以二十八宿双算法、九宫飞星详解、彭祖百忌白话注释及130位神明的诞辰知识库。数据涵盖了从日常吉凶颜色、吉利数字，到西方星座、月相变化、喜财福神方位等多元化维度，甚至融入了天穿日、天赦日等特色节日及93个国际趣味节日。其数据时间跨度长达131年，所有字段均经过详尽的抽样与交叉验证，确保了高度的准确性和权威性，为用户提供了一站式、多维度的古典历法智慧与现代数据科学相结合的独特体验。

使用方法

使用LunarData数据集极为便捷。数据以结构清晰的JSON格式存储于按年份分类的文件夹中，用户无需安装任何后端环境，只需通过浏览器直接打开项目中的index.html文件，即可瞬间访问完整的黄历查询界面。对于开发人员而言，可通过Python或JavaScript等语言轻松读取任意年份的JSON文件，例如通过Python的json库加载'2026/05.json'文件，即可按需提取指定日期的特定字段，如农历、干支、宜忌等。所有前端所需的JavaScript索引文件也已预生成，使得在网页应用中集成该数据变得异常简单。该项目基于MIT开源协议，并提供了llms.txt文档供AI辅助工具引用，为传统历法知识的数字化应用与学术研究开辟了清晰的路径。

背景与挑战

背景概述

LunarData数据集，又称「择日知录」，是由「当麻实验室」（donmalab.com）于2026年创建并维护的一项综合性传统历法数字化资源。该数据集的核心研究问题在于如何将中国农历、干支、节气、宜忌、吉凶时辰、神明诞辰、彭祖百忌、九宫飞星与二十八宿等庞杂的传统历法知识，整合为一个结构严谨、可机读且纯前端可查询的开放数据体系。数据集覆盖公元1970年至2100年共131年的历法信息，并以JSON与JS格式静态预生成，实现了黄历核心要素的精确计算与三派择日体系（建除十二神派、天星择日派、紫白九星派）的并行呈现。LunarData的问世，为传统文化数字人文、历法计算验证、以及面向大众的历法查询应用提供了高质量、高精度的标杆性数据基础，其系统的验证流程与开放的MIT协议亦推动了相关领域的学术研究与工程实践。

当前挑战

LunarData数据集所面临的挑战主要体现在两个方面。其一，在历法计算领域，传统黄历涉及多种复杂且存有争议的历算规则，例如二十八宿的日宿法与月宿法、天赦日的精确判定（春戊寅、夏甲午、秋戊申、冬甲子）、以及泰国佛日等跨文化历法事件的融合，如何在保持算法一致性的同时兼顾不同流派与地域的规则差异，是核心的科学难题。其二，在构建过程中，数据的准确性与一致性是首要挑战，项目虽已通过100笔抽样验证、300组三派宜忌验证以及多轮特殊日期抽验，但仍需处理类似Thai Buddhist数据与外部工具（如myhora）在部分年份存在的系统性一日偏移，这种由日界规则不同引发的偏差要求更严谨的溯源与校准机制。此外，静态数据预生成模式虽提升了前端查询效率，却也对数据更新的灵活性与跨版本兼容性提出了更高要求。

常用场景

经典使用场景

LunarData数据集在传统历法研究与人文计算领域展现出独特价值，其最经典的使用场景即服务于中国农历与黄历信息的系统化查询与分析。研究人员可借助该数据集提供的1970年至2100年长达131年的精细化历法数据，开展包含农历公历转换、天干地支推算、二十四节气标注、每日宜忌判定及吉凶时辰分析在内的综合性历法研究。该数据集还整合了建除十二神、二十八宿、九宫飞星三大择日流派的理论体系，为传统择日学的数字化与可计算化提供了坚实的数据基础。

解决学术问题

LunarData数据集致力于解决传统历法研究中长期存在的结构化数据匮乏与跨领域知识整合难题。在学术层面，该数据集通过系统收集与校订干支纪年、生肖冲煞、五行纳音、神明诞辰等多元历法要素，有效弥合了古籍文献与现代计算科学之间的鸿沟。其重要意义在于为民俗学、历史学、文化人类学等学科提供了可验证、可复现的量化研究材料，同时推动了传统历法知识的数字化保护与传播。超过100笔样本的冲煞验证与300组三派宜忌的交叉校验，确保了数据的高信度与学术严谨性。

衍生相关工作

基于LunarData数据集已衍生出一系列具有学术价值与应用意义的相关工作，最为突出的包括100笔样本的沖煞驗證報告、300组三派宜忌對照表、以及跨平台泰國佛日資料的交叉验证。验证工具如verify_100.py与verify_full.py为数据集的质量把控提供了可复用的方法论框架，而sanpai.py和peng_taboo.py则拓展了择日学与彭祖百忌领域的计算化研究边界。此外，该数据集在其GitHub页面中引入了AI与LLM可读的文档格式（llms.txt与llms-full.txt），使大规模语言模型的引用与检索变得更加便捷，展现了数字人文与人工智能交叉领域的前沿探索。