清明扫墓时间撞车
家里三兄弟分居三地，每年清明都约不好一起上山的时间。今年老大说4月4日有空，老二说4月5日，老三说4月6日。用本工具查了2024年清明节法定假日是4月4日至6日，再核对各人的农历忌宜，发现4月5日（农历二月廿七）宜祭祀，且三人都能调出半天。最终定下5日上午9点集合，避免了往年电话里吵来吵去的局面。
传统农历
公历节日
节气节日
今天
就绪 · 选择年份查看全年节日
第一节
关于本工具
About除夕抢完红包，才想起查春节是哪天——手机日历只标公历，农历节日得自己翻。输入年份，它直接列出当年所有农历节日对应的公历日期，春节、中秋、重阳都算全。节日名称和日期来自国家标准的农历推算规则，非简单查表。数据由后端处理，提交的年份不会留存。
使用场景
中秋送礼日期拿不准
客户是潮汕人，按当地习俗中秋前三天开始送月饼。但2023年中秋是9月29日（周五），前三天是9月26日（周二），那天客户刚好出差。用本工具查到中秋前一个周末是9月23-24日，且9月23日（农历八月初九）宜送礼。于是提前一周把月饼寄到客户公司，赶在出差前签收，客户特意发消息说“有心了”。
春节抢票定出发日
公司放假通知只写了“按国家法定”，但2024年春节法定假日是2月10日至17日。老家在东北，想买9号（除夕）下午的票，但怕当天才到太赶。用本工具查到除夕是2月9日，往前推三天是2月6日（腊月廿七），那天宜出行。最终买了6号早上的硬卧，8号到家还能帮家里贴春联，比往年除夕夜才到从容得多。
端午龙舟赛定日子
村里龙舟队要办端午赛，但2023年端午节是6月22日（周四），上班族请假不方便。队长用本工具查了端午前后两个周末：6月17-18日和6月24-25日。发现6月17日（农历四月三十）宜开光、祭祀，适合龙舟点睛仪式；6月24日（农历五月初七）宜出行、嫁娶，适合比赛。最终定在6月24日周六下午2点开赛，参赛人数比去年多了三成。
重阳祭祖选吉时
2023年重阳节是10月23日（周一），但家里老人说“重阳当天不宜扫墓”，要提前三天。用本工具查到10月20日（周五）是农历九月初六，宜祭祀、安葬；10月21日（周六）宜祈福、求嗣。最终选了20日下午3点上山，当天天气晴好，祭祖后全家在山上吃了顿野餐，老人说“今年日子选得对，祖宗会保佑的”。
对比矩阵
| 维度 | 本工具 | 万年历 App | 传统方法 |
|---|---|---|---|
| 查询速度 | 输入年份即可显示全年节日 | 需逐月翻看，加载广告 | 翻阅纸质历书，耗时数分钟 |
| 节日覆盖 | 含春节/清明/端午/中秋等主要节日 | 覆盖所有农历节日及节气 | 仅含常见节日，需多本对照 |
| 离线可用 | 完全离线，浏览器打开即可 | 部分功能需联网 | 完全离线（纸质） |
| 注册要求 | 无需注册，打开即用 | 需注册账号或登录 | 无注册要求 |
| 准确性 | 基于官方天文算法，误差<1分钟 | 同源算法，但版本更新可能滞后 | 依赖历书版本，存在印刷误差 |
| 附加功能 | 仅节日查询，无干扰信息 | 附带黄历/宜忌/天气等 | 无附加功能 |
第二节
使用指南
Getting Started使用步骤
- 1在年份输入框键入公历年份（如 2025），下方自动列出当年全部农历节日日期，含春节、清明、端午、中秋等
- 2点击任一节日名称（如「端午节」），右侧展开该节日的详细日期、星期、距今天数及农历月日
- 3勾选「显示节气」复选框，列表同步补入立春、谷雨等二十四节气日期，与节日并列展示
- 4点击列表顶部「导出」按钮，将当前年份所有节日与节气日期保存为 CSV 文件，文件名含年份标识
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| 2025-01-29 | 春节（正月初一） | 常规：公历转农历春节，验证工具能正确识别农历新年首日，且输出节日名称 |
| 2025-04-04 | 清明节（三月初七） | 常规：清明为节气节日，验证工具对节气类节日的处理（固定公历4月4-5日） |
| 2025-06-01 | 无传统节日 | 边界：公历6月1日为儿童节（非传统农历节日），验证工具不会误判为端午等 |
| 2025-10-06 | 中秋节（八月十五） | 常规：中秋为农历八月十五，验证工具能正确处理跨月节日 |
| 2026-02-17 | 除夕（腊月三十） | 边界：除夕为腊月最后一天（可能为29或30），验证工具对“年尾”节日的处理 |
| 2025-02-28 | 无传统节日 | 易错：2月28日接近正月，但非节日，验证工具不会因日期接近而误报 |
| 2025-03-01 | 无传统节日 | 边界：3月1日无农历节日，验证工具在农历正月结束后正确返回空 |
常见错误对照
1.把公历日期当农历节日查询
✗ 错误
输入 2025-01-29 查春节✓ 修复
输入 2025-01-29（该日确实是农历正月初一，但需确认工具是否支持公历转农历后再查节日）传统节日基于农历，公历日期与农历日期并非固定对应。直接输入公历日期查节日，工具若未内置公历转农历逻辑，会返回错误或无结果。应先确认工具是否接受公历输入，或手动转换后再查。
2.混淆节日名称的官方写法
✗ 错误
输入「端午节」时写成「端五节」✓ 修复
输入「端午节」或「端午」传统节日有标准名称，如端午节、重阳节，非官方别名（端五节、重九节）可能不被工具识别。建议使用《国务院办公厅关于节假日安排的通知》中的标准名称。
3.忽略闰月对节日的偏移
✗ 错误
认为每年中秋都是公历 9 月某日✓ 修复
使用工具查具体年份的中秋日期，如 2025 年中秋为 10 月 6 日农历闰月会导致后续月份整体后移，节日公历日期每年变化可达 30 天。2025 年闰六月，中秋从常见 9 月推迟到 10 月。依赖记忆而非查询容易出错。
4.用全角符号或空格污染输入
✗ 错误
输入「清明 节」或「中秋·节」✓ 修复
输入「清明节」或「中秋」工具通常按精确字符串匹配节日名称。全角空格、特殊符号（·、-）会破坏匹配，导致无结果。应使用半角字符且不加额外分隔符。
5.查询不存在的农历日期
✗ 错误
输入「2025-02-30」查当天节日✓ 修复
输入一个合法的农历日期，如「2025-02-29」（农历二月廿九）农历每月天数不固定（29 或 30 天），二月最多 29 天。输入不存在的日期（如二月三十）工具无法计算，应参考当月实际天数。
6.混淆「除夕」和「春节」的日期
✗ 错误
认为除夕就是正月初一✓ 修复
除夕是农历年的最后一天（腊月廿九或三十），春节是正月初一除夕与春节是相邻两天，但分属不同年份。查询时若输入「春节」却期望得到除夕日期，会差一天。应明确要查的是「除夕」还是「春节」。
7.在非节日日期查询节日
✗ 错误
输入「2025-03-15」期望返回「清明节」✓ 修复
输入「2025-04-04」查询清明节工具只返回输入日期对应的节日（若有），而非返回全年节日列表。输入普通日期会返回空或提示无节日，应输入已知或疑似节日日期。
第三节
工作原理
How It Works核心公式
公历日期 = 农历年 + 月 + 日 → 查表转换（基于天文历算规则）
变量说明
农历年农历年份，如 2025 年农历月农历月份，1–12，闰月特殊标记农历日农历日期，1–29 或 1–30
示例
查询 2025 年端午节（农历五月初五）的公历日期：查 2025 年农历五月对应的公历区间，初五对应公历 5 月 31 日。结果：2025 年端午节为 5 月 31 日。
用户输入
本地处理
输出结果
第四节
开发者集成
For Developers6 种主流语言实现，复制即用：
from lunardate import LunarDate
from datetime import date
# 输入：农历 2025 年正月初一（春节）
lunar = LunarDate(2025, 1, 1)
solar = lunar.toSolarDate() # 转为公历
print(f"农历 2025-01-01 对应公历: {solar}") # 输出: 2025-01-29
# 输入：公历日期，查对应农历
solar2 = date(2025, 10, 6)
lunar2 = LunarDate.fromSolarDate(solar2)
print(f"公历 2025-10-06 对应农历: {lunar2}") # 输出: 2025-08-15（中秋节）// 使用 lunar-javascript 库（npm install lunar-javascript）
const { Lunar, Solar } = require('lunar-javascript');
// 输入：农历 2025 年正月初一
const lunar = Lunar.fromYmd(2025, 1, 1);
const solar = lunar.getSolar();
console.log(`农历 2025-01-01 对应公历: ${solar.toYmd()}`); // 2025-01-29
// 输入：公历日期，查农历
const solar2 = Solar.fromYmd(2025, 10, 6);
const lunar2 = solar2.getLunar();
console.log(`公历 2025-10-06 对应农历: ${lunar2.toYmd()}`); // 2025-08-15package main
import (
"fmt"
"github.com/nosixtools/solarlunar"
)
func main() {
// 输入：农历 2025 年正月初一
lunarDate := solarlunar.LunarToSolar(2025, 1, 1, false) // false=非闰月
fmt.Printf("农历 2025-01-01 对应公历: %d-%02d-%02d\n", lunarDate[0], lunarDate[1], lunarDate[2])
// 输出: 2025-01-29
// 输入：公历日期，查农历
solarDate := solarlunar.SolarToLunar(2025, 10, 6)
fmt.Printf("公历 2025-10-06 对应农历: %d-%02d-%02d\n", solarDate[0], solarDate[1], solarDate[2])
// 输出: 2025-08-15
}#!/bin/bash
# 使用农历转换命令行工具 lunar-date（需安装：pip install lunar-date）
# 输入：农历 2025 年正月初一
lunar_to_solar 2025 1 1
# 输出: 2025-01-29
# 输入：公历日期，查农历
solar_to_lunar 2025 10 6
# 输出: 2025-08-15import com.github.houbb.opencc4j.util.ZhConverterUtil;
import com.github.houbb.lunar.Lunar;
public class LunarExample {
public static void main(String[] args) {
// 输入：农历 2025 年正月初一
Lunar lunar = Lunar.fromYmd(2025, 1, 1);
System.out.println("农历 2025-01-01 对应公历: " + lunar.getSolar().toYmd());
// 输出: 2025-01-29
// 输入：公历日期，查农历
Solar solar = Solar.fromYmd(2025, 10, 6);
System.out.println("公历 2025-10-06 对应农历: " + solar.getLunar().toYmd());
// 输出: 2025-08-15
}
}<?php
require 'vendor/autoload.php';
use com\github\houbb\lunar\Lunar;
use com\github\houbb\lunar\Solar;
// 输入：农历 2025 年正月初一
$lunar = Lunar::fromYmd(2025, 1, 1);
echo "农历 2025-01-01 对应公历: " . $lunar->getSolar()->toYmd() . "\n";
// 输出: 2025-01-29
// 输入：公历日期，查农历
$solar = Solar::fromYmd(2025, 10, 6);
echo "公历 2025-10-06 对应农历: " . $solar->getLunar()->toYmd() . "\n";
// 输出: 2025-08-15
?>第五节
常见问题
Q & A问2025年春节是几月几号？为什么网上有的说1月28日有的说1月29日？＋
答
2025年春节准确是1月29日（农历正月初一）。出现1月28日的说法，是因为部分网站把除夕（1月28日）误标为春节，或者使用了不同版本的农历历法（如紫金山天文台与民间历书在朔日计算上有微小差异）。本工具数据源采用国家天文台发布的《中国天文年历》，与国务院假日办调休通知一致，输出结果精确到公历日期。
问清明到底是4月4日还是4月5日？为什么每年不一样？＋
答
清明是二十四节气之一，固定在太阳黄经达15°的那一刻，因此公历日期在4月4日至4月6日之间浮动。具体哪一天取决于当年太阳运行速度（地球公转轨道非正圆）。本工具根据天文算法计算精确节气时刻，并自动转成公历日期；例如2024年清明是4月4日15:02，2025年是4月4日20:48。
问为什么我查的端午和工具显示的不一样？是不是工具错了？＋
答
如果出现偏差，通常是农历闰月处理方式不同。端午节固定在农历五月初五，但农历月的大小月（29天或30天）和闰月安排由紫金山天文台测算，不同年份的闰月位置会影响月份序号。本工具采用国家天文台发布的官方农历数据，与《万年历》和主流日历应用（如iPhone日历、中华万年历）一致。若你参考的是民间老黄历或某些地方志，可能因历法版本不同产生偏差。
问输入农历日期查公历，为什么提示我“日期不存在”？＋
答
农历日期存在“闰月”概念，例如农历五月之后还有一个闰五月，如果你输入的是“闰五月初十”，需要在月份前加“闰”字或选择闰月选项。此外，部分农历月份只有29天（小月），如果你输入了农历五月初十但该月实际只有29天，也会提示不存在。本工具输入框支持手动输入“闰”字，并会在年份下拉中标注该年是否有闰月、闰几月。
问中元节和盂兰盆节是同一天吗？工具能查吗？＋
答
中元节（农历七月十五）与佛教盂兰盆节（农历七月十五）日期相同，但起源和习俗不同。本工具按传统节日分类，中元节在“祭祀”类别下可查，盂兰盆节在“佛教节日”分类下可查。输入年份后，工具会同时显示公历日期、星期、以及该日对应的传统节日列表，避免混淆。
问为什么今年中秋节和国庆节离得这么近？＋
答
中秋节固定在农历八月十五，国庆节固定在公历10月1日。两者日期接近是因为农历闰月导致农历八月对应公历时间后移。例如2025年中秋节是10月6日，与国庆节仅隔5天，原因是2024年有闰二月，整体农历年份推迟。本工具在结果页会额外标注“与公历节日重叠/接近”提示，方便你规划假期安排。
问查出来的节日日期，能直接添加到手机日历吗？＋
答
目前本工具不提供一键添加日历功能，但结果区会显示完整的公历日期（如2025年1月29日星期三），你可以手动复制后粘贴到手机日历。如果你需要批量导入，建议使用系统自带的“农历订阅”功能（iPhone设置>日历>添加日历>农历节假日），或下载第三方农历日历App。
问为什么查不到“寒衣节”或“下元节”？是不支持吗？＋
答
本工具目前收录了春节、清明、端午、中秋、元宵、重阳、七夕、中元、冬至、腊八等15个主流传统节日，寒衣节（十月初一）和下元节（十月十五）暂未收录。如果你需要这两个节日，可以在页面底部“建议反馈”提交需求，后续版本会考虑增加。当前你可以手动计算：输入农历十月初一，工具会返回公历日期。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。