日期差计算器

相差天数是五项结果的共同基准

选择两个日期后，页面先求它们之间的绝对时间距离，所以开始日期早于或晚于结束日期都得到同一个非负结果。最大的数字是相差天数；下方的年、月、周、小时不是一段“几年几个月几天”的拆分，而是把同一段距离分别换成五种总量后取整数。

floor 表示只保留已经完成的整数单位，不做四舍五入。日期输入不含时分秒，因此正常有效日期的小时结果等于相差天数乘以 24。每张结果卡片都可单独复制当前数字。

月数和年数属于平均长度估算

公历月份可能有 28、29、30 或 31 天，自然年也可能有 365 或 366 天；页面没有按日历逐月借位，而是固定用 30.44 日估算一个月、365.25 日估算一年，再向下取整。这种口径适合把较长的总天数粗略换成完整月数或年数，却不能回答“满几个自然月”或“到了第几个周年日”。

结果项	页面口径	适合怎样读
天	两个日期的绝对间隔	作为主要、可直接核对的跨度
周	总天数 ÷ 7 后取整	已经完成的整周数量
月	总天数 ÷ 30.44 后取整	按平均月长得到的近似整月数
年	总天数 ÷ 365.25 后取整	按固定平均年长得到的近似整年数
小时	日期间隔换成整小时	日期级跨度的 24 倍表达

美国海军天文台给出的公历长期平均年长为 365.2425 日。页面中的 365.25 是计算器自身的换算系数，不应被理解为公历标准对每一年长度的定义。

阳历和农历输入最终比较的是公历日期

两个日期区都可以选择阳历或农历。阳历模式直接选择 YYYY-MM-DD；农历模式依次选择年、月、日，遇到相应年份的闰月时会把普通月与闰月分开列出。农历选择会先对应成一个公历日期，再进入完全相同的日期差公式，因此结果中的“月”不是农历月数。

农历年份可选 1900—2100。打开页面时，开始日期和结束日期默认相隔 30 天；两个“设置为今天”按钮可分别替换对应日期。输入一变化，结果随之重算，不需要另点提交按钮。以上数值只由所选日期与固定换算系数产生，不读取节假日、调休或地区工作日资料。

日期格式与历法核验资料

设置日期后按用途选择结果

1. 先确认原始日期采用哪种历法

   合同、证件和常见日程通常直接写公历日期，可留在阳历模式；只知道农历生日或传统日期时，再切到农历并确认年份、是否闰月和具体日号。

2. 填写开始与结束日期

   分别改动两个日期字段，或用“设置为今天”替换其中一项。页面允许较晚日期放在开始栏，因为最终会取绝对值，但这样不会保留先后方向。

3. 优先读取相差天数

   需要核对两个日历日隔了多久时，先看大号的天数。若只想做粗略周期汇报，再查看整周、估算整月、估算整年或总小时。

4. 复制并保留口径

   复制单个结果时，最好同时记录两个输入日期以及“绝对间隔、向下取整”的口径。只保存一个“1个月”会丢失实际是 31 天还是其他跨度的信息。

用 31 天跨度复算所有结果

把开始日期设为 2024-01-01，结束日期设为 2024-02-01。两者相差 31 天，所以页面应显示：31 天、4 周、1 月、0 年、744 小时。

边界对照：2024-02-28 到 2024-03-01 跨过闰日，结果是 2 天和 48 小时；把这两个日期互换，结果仍是 2 天。该例同时验证了闰日会进入总天数、日期顺序不会生成负数。

首尾计数、整年显示与功能边界

相差天数包含开始日和结束日吗？

它表示两个日期之间跨过了多少个日历日边界。2024-01-01 到 2024-01-02 显示 1 天，而不是把首尾都算入得到 2 天；若业务规则明确要求首尾两天都计数，可在总天数上加 1，但其他结果需按新口径另行换算。

开始日期晚于结束日期会出现负数吗？

不会。页面取绝对差，所以交换两个输入后，天、周、月、年、小时五项都不变。需要判断“已过去”还是“还剩”时，必须自行根据两个日期的先后关系解释。

为什么整整一个公历年可能显示 0 年或 11 月？

因为年和月卡片使用固定平均长度并向下取整。例如 2023-01-01 到 2024-01-01 相差 365 天，floor(365 ÷ 365.25) = 0，floor(365 ÷ 30.44) = 11。总天数仍是 365；判断周年应比较公历月日，而不是读取这两个估算卡片。

可以计算时分秒、工作日或节假日吗？

当前输入只到日期，输出只含天、完整周、估算月、估算年和整小时，不显示分钟或秒，也不排除周末、法定节假日和调休日。需要精确时刻或工作日口径时，应使用包含明确时区和地区日历的专门计算方法。

正式期限前要复核的边界

总天数是这个页面最直接的结果；月数和年数只是固定平均长度的向下取整估算。合同履行、年龄资格、保险期间、签证停留、劳动考勤或申报截止等正式事项，必须以适用规则对起算日、届满日、节假日顺延和所在地时区的规定为准。

• 没有自然月拆分：结果不会输出“1年2个月3天”，也不会按月末逐月推算；不要用估算月数判断账期、生日或周年。
• 没有方向：绝对值会隐藏先后顺序。保存结果时同时保留原始日期，避免把“已过去 30 天”误读成“还剩 30 天”。
• 只到日期：两个输入都没有时分秒或时区字段，小时数只是日期跨度的等价表达，不适合航班、班次、直播或跨时区会议。
• “今天”需核对：页面按协调世界时的日期生成“今天”。当所在地日历日与协调世界时日期不一致时，按钮可能与本地当天相差一天，应以输入框显示值为准并手动修正。
• 农历范围有限：农历下拉年份为 1900—2100；香港天文台公开对照覆盖 1901—2100，不能用该资料替页面的 1900 年边界背书。远期农历日期用于重要事项时还应与届时官方历书交叉核对。
• 不计算工作日：结果不读取任何地区的节假日或调休安排。项目工期、请假、营业日和办事期限应另按实际日历逐日核算。