关于此工具
在项目排期、合同履约期限推算、倒计时纪念日以及法定工时核算中,精确计算两个日期之间的相差天数是一项不可或缺的实用需求。然而公历历法规则繁杂(大小月交替、平年 365 天与闰年 366 天、2 月的 28 或 29 天),仅凭脑力心算极易产生偏差。本工具严格依照格里高利历(公历)规范,秒级计算两个日期间的绝对相隔天数、周数、月数及年数,并支持工作日与法定节假日自动折算。
如何使用本工具(操作步骤)
选择起始日期与结束日期
在日期选择器中分别挑选开始日期(Start Date)与截止日期(End Date),也可以快捷选择“今天”。
配置是否包含结束日
根据业务需求勾选是否“包含结束当天”(算头不算尾 vs 算头又算尾),系统自动调整天数计入标准。
查看多单位换算明细
即时查验计算结果:总天数、整周加零星天数、几整年几个月几天,并可一键复制结果。
精准处理闰年与大小月差异
严格适配四年一闰、百年不闰、四百年又闰的历法算法,彻底消灭跨越 2 月 29 日时常见的计算偏差。
支持工作日(剔除周末)筛选
可智能剔除周六与周日,精确输出期间纯工作日天数,为企业敏捷研发排期与请假考勤提供可靠依据。
多维度人性化时间跨度表述
不仅输出冷冰冰的“总天数”,同时换算为“X 年 X 个月 X 天”与“X 周 X 天”,便于撰写进度汇报与活动通知。
日期计算开发常识与合同期限要点
- •厘清“算头不算尾”与“算头又算尾”:民法典及合同法中,起算日通常不计入期限(即算头不算尾,从次日起算);但在酒店住宿、租房天数结算时,则需明确双方合同约定采用何种算法。
- •注意夏令时(DST)带来的 23/25 小时陷阱:在跨越夏令时开始或结束的那一天,一天实际只有 23 小时或 25 小时。若纯靠加减 86,400,000 毫秒推算日期,极易在欧美服务器上产生日期错位!
- •月份长短不一的“满月”概念:从 1 月 31 日加 1 个月是 2 月 28 日(闰年 29 日),此时再加 1 个月是 3 月 28 日还是 3 月 31 日存在歧义,业务逻辑中推荐明确按天数而非“自然月”结算。
代码与转换对比示例
典型日期跨度综合计算对照示例
起始日: 2026-01-01 (元旦)
结束日: 2026-09-23 (今天)• 绝对相差: 265 天 (算头不算尾)
• 折合周数: 37 周 零 6 天
• 复合表述: 8 个月 零 22 天
• 纯工作日: 190 个工作日 (剔除周六周日)* 复合表述结合了各月份的实际物理天数进行精确累进推算。
现代 JavaScript 计算日期相差天数核心代码
function getDaysDiff(date1, date2) {
const MS_PER_DAY = 1000 * 60 * 60 * 24;
// 统一转为 UTC 午夜以规避夏令时 1 小时偏差
const utc1 = Date.UTC(date1.getFullYear(), date1.getMonth(), date1.getDate());
const utc2 = Date.UTC(date2.getFullYear(), date2.getMonth(), date2.getDate());
return Math.floor((utc2 - utc1) / MS_PER_DAY);
}直接拿本地时间相减除以 86400000 可能会在跨越夏令时(DST)换季当天少算或多算 1 小时。务必使用 Date.UTC() 对齐。* 采用 UTC 午夜可完美规避时区跳变与夏令时跳钟的隐蔽 Bug。
常见问题解答
Q: 为什么 2026 年不是闰年?公历闰年是怎么判定的?
A: 公历闰年法则为:“四年一闰,百年不闰,四百年又闰”。2026 不能被 4 整除,因此是普通平年(全年在 365 天,2 月只有 28 天)。下一次闰年是 2028 年。
Q: 本工具的工作日计算包含法定节假日调休吗?
A: 默认模式剔除每周常规的周六和周日。由于各国家和地区的法定节日及调休补班安排每年由政府动态颁布,精准的法定长假排班需配合当年官方日历数据。
Q: 计算倒计时时,未来日期显示为负数吗?
A: 系统智能识别先后顺序。如果目标日期晚于起始日,显示为“还剩 X 天(未来倒计时)”;如果目标日期已过去,则显示为“已过去 X 天(纪念日天数)”。