工具用的顺手吗?
你的反馈能帮助我们做得更好
用于农历与公历日期互相转换的工具,支持农历闰月,适用于查询节日、生辰或历史日期。
Result will appear here
概览
了解工具能解决的问题、计算或处理逻辑,以及数据边界。
“公历转农历”读取一个 YYYY-MM-DD 日期,返回农历年月日;“农历转公历”读取农历年、月、日,并在该年确有闰月时把“普通月”和“闰月”列成两个不同选项。转换由项目中的 lunar-typescript 1.8.6 执行,输入变化后自动更新,不需要另点转换按钮。
结果区的主日期会随方向变化:前一种模式突出农历,后一种模式突出公历。附加信息包括年干支与生肖的组合、月干支、日干支、星期索引;只有当天命中节气或节日时,才显示对应卡片。复制按钮会把公历、农历、干支、星期以及存在的节气和节日整理成多行文本。
同一农历年中,普通二月与闰二月是先后两个不同月份,对应的公历日期不同。组件查询所选农历年的闰月,只在对应普通月后插入“闰某月”;传给库时,闰月用负月份值表示。因此,旧资料只写“二月初一”却未说明是否闰月时,无法唯一确定公历日期。
农历转公历的年份下拉框固定列出 1900–2099,共 200 个年份。公历日期输入框没有在组件中声明最小或最大日期,但这不等于所有历史年代都经过页面验证。
指南
按步骤完成操作,并通过示例核对输入与结果。
身份证、手机日历常见的 2024-02-10 属于公历;“甲辰年正月初一”属于农历。顶部标签应与已知日期一致。
公历模式直接选择日期。农历模式依次选年、月、日;当月列表出现“闰某月”时,必须根据原始记录判断普通月还是闰月。
右侧大字是转换后的目标日期,次行保留另一套日期。再检查干支、星期以及当天是否出现节气或节日。
复制内容同时保留两套日期与附加字段,适合粘贴到备忘录。用于日程提醒时,应把转换所得公历日期写入对应年份,而不是每年重复同一个公历月日。
2023 年存在闰二月。选择农历 2023 年二月初一,当前库转换为公历 2023-02-20;选择 2023 年闰二月初一,转换为 2023-03-22。两者相差一个农历月,说明“闰”字不能省略。
反向例子:输入公历 2024-02-10,页面得到农历“二〇二四年正月初一”,年干支与生肖组合为“甲辰龙年”,节日字段显示“春节”,星期字段显示 6。这里的 6 是组件直接展示的库索引,不是中文“星期六”文本。
场景
查看这项工具在不同工作与生活流程中的用法。
按目标年份重新把农历月日换为公历,再写入当年日历;若出生记录涉及闰月,应完整保留闰月信息。
族谱、日记或历史记录采用农历时,可逐条转换并同时保存原日期和结果,避免后续无法追溯转换方向。
查某年春节、端午或中秋对应的公历日期时,先选具体年份;同一农历节日的公历日期会随年份变化。
问答
集中解答高频疑问与容易混淆的问题。
只有该农历年确实设置闰月时,月份列表才插入对应项,而且闰月名称跟在同名普通月之后。切换年份后,原先不再有效的闰月状态会自动取消。
日期下拉框始终列出初一到三十,但农历小月只有 29 天。若所选月份没有第三十天,Lunar.fromYmd 会报错,组件捕获后把结果清空;应改选该月真实存在的日期。
当前页面直接展示 getWeek() 的索引:0 代表星期日,1 到 6 代表星期一到星期六。复制文本也会保留这个数字。
不是。节气与节日卡片只在返回字符串非空时出现;普通日期仍会显示两套日期、干支和星期。节日集合合并了库中的农历节日、其他节日与公历节日。
按钮读取浏览器当前时间,但公历输入值由 toISOString() 的 UTC 日期部分生成。UTC 日期与所在地日期不同的时段,输入框可能相差一天,应以页面显示日期为准并手动校正。
须知
使用前了解适用范围、结果限制与必要提醒。
结果适合日常日期查询,不应单独作为历史考证、法律文书、宗教历日或精密天文历算依据。
推荐
查找相关工具、专题与可用的 API 能力。