时间工具

日期计算器

计算日期差、日期加减、工作日统计等常用日期计算

→
日期差
7 天 (1 周)

日期计算器

快速计算日期之间的差值、日期加减、工作日统计等常用日期计算功能。

功能特点

  • 日期差计算:计算两个日期之间的天数、周数、月数、年数
  • 日期加减:在指定日期基础上加减指定天数
  • 工作日统计:计算指定日期范围内的工作日和周末天数
  • 实时计算:输入日期即时显示结果

使用场景

  • 项目计划:计算项目周期和里程碑日期
  • 工资计算:计算工作日天数
  • 到期提醒:计算距离到期日还有多少天
  • 日程安排:计算未来或过去的日期

日期计算器用同一组输入回答两类问题:两个日期相隔多少天,以及某个日期加上或减去若干天之后落在哪一天。它接受 YYYY-MM-DD 形式的日期,并可按周六周日拆分一个区间的天数,适合排工期、算请假天数、核对合同期限和倒推到期日。

差值做减法,工作日两头都算

同一对日期在两种模式下相差一天,这是设计使然而非缺陷。「日期差」把两个日期换算成毫秒、取绝对值后除以 86400000 再向下取整,2026-10-19 到 2026-10-25 得到 6 天,起始日只充当边界不计入。「工作日」则用 setDate 逐日推进,以 current <= end 判断何时停止,首尾两天都算进总数,再按 getDay() 是否返回 0 或 6 归入周末,同一个七天区间得到工作日 5 天、周末 2 天、总计 7 天。算「还剩多少天」「已经过去多久」用前者;按天计费、排班或给假用后者,因为周一到周一的驻场确实占满 8 个日历日。

年、月、周是 365/30/7 的固定换算

总天数确定后,年、月、周并不逐月推真实月长,而是拿常数做除法:days / 365 取整得年,余数 / 30 取整得月,再 / 7 得周,最后的「天」直接取 days % 7。问题在于这一项取的是总天数对 7 的余数,而不是扣掉年月周之后的零头,于是各段可能互相重叠、相加超过总数:2024-01-01 到 2025-01-01 显示为 366 天 (1 年 2 天),因为 366 除以 365 余 1 记一年,366 除以 7 余 2 又记两天,尽管这段恰好是一个整年。换算时把年月周当作量级参考,对账以总天数为准。

UTC 解析与本地取值的错位

按 ECMAScript 规范,只含日期的字符串如 2026-10-22 按 UTC 零点解析,而工具用 getFullYear()、getDate() 输出结果、用 getDay() 判断星期,读的都是本地日历。东八区看不出差别,因为本地零点加八小时仍是同一天;UTC 负偏移地区就会差一天:在 America/New_York,同一字符串被读成本地前一天,于是加 0 天返回 2026-10-21,2026-10-19 会被当成周日,整段工作日统计随之平移。日期差模式不受影响,两个操作数解析方式一致,毫秒差不含日历偏移。身处 UTC 以西时,先确认返回日期与输入同日,再采信工作日数字。

实操示例

同一对日期跑两种模式

输入
开始 2026-10-19,结束 2026-10-25
输出
日期差: 6 天 (6 天)
工作日: 工作日: 5, 周末: 2, 总计: 7 天

两次计算用的是同一组日期。日期差把 518400000 毫秒除以 86400000 得 6,括号里的年、月、周都被取整成 0,只剩天数一项,因此与总数重复;工作日遍历把首尾两天都算入,正好 7 天。文案不做单复数变化,换成英文界面同样是 6 days。

边界与常见误用

  • 日期差取绝对值,交换开始与结束得到同一个正数,无法表达「早 3 天」这类负向差值。
  • 年、月、周按 365/30/7 固定换算,闰日会累积误差:闰年的一整年显示成 1 年 2 天,各段相加还可能超过总天数。
  • 工作日只按 getDay() 是否为 0 或 6 归类,区间跨法定假日、调休补班或公司停工期时仍是周一至周五的算术结果,这些天需要自己加减。
  • 加减以整天为单位、通过 setDate 完成,2.5 这类小数会被截断,并且没有小时、分钟或时区输入。
  • 「日期减」会把共用的天数输入改写成负数,切回「日期加」时负号仍在;此外输入按 UTC 零点解析而结果按本地时间读取,UTC 以西地区会整体早一天。

相关工具

出问题时先看这里

开始日期填了个很早的年份,页面就卡死了,结果一直没出来。

原因工作日模式是 while 循环,一天执行一次 setDate,而两个日期框都没有 min 或 max:0001-01-01 到 9999-12-31 就是主线程上 3,652,059 次迭代,何况任一输入变动都要把这段重跑一遍。

处理把区间收到真正需要的年份——三年也就一千一百天上下——或者先用「日期差」看总天数,确实需要拆分再切到「工作日」。

我本来想加一个月,在 2026-03-31 上填了 31 天,结果跳到 5 月 1 日。

原因setDate(date.getDate() + 31) 是纯天数推进:3 月 31 日往后 30 天已经是 4 月 30 日,第 31 天自然落进 5 月。组件里没有任何月末钳制,因为计算里压根没有「月」这个量。

处理按真实月长填天数,4 月填 30 得到 2026-04-30。如果合同写的是「一个月」而不是「30 天」,就别再拿天数来表达,换个工具。

我把 2026/10/22 粘进去,输入框直接变空了。

原因input type="date" 只认 RFC 3339 的 YYYY-MM-DD,斜杠写法在浏览器那一层就被拒掉,交给 Vue 的是空字符串。外围的 catch 也永远不会触发:new Date('') 得到 Invalid Date 却不抛错,所以「日期格式错误」这句提示根本不可能出现。

处理改成 2026-10-22 重新输入,或用弹出的日期选择器点选。这里没有计算按钮,两端一旦都是合法值,结果立刻刷新。

开始和结束填成同一天,结果显示「0 天 (0 天)」,看着像没算出来。

原因差值为 0 时年、月、周三项都不进数组,兜底条件 if (days > 0 || parts.length === 0) 又把「0 天」塞进括号,于是括号里和总数重复了一遍,而不是留空。

处理这就是正确结果:两端同一天。如果预期该有差值,先看另一端是不是被上面那种斜杠粘贴清空了——某一端为空时,结果位显示的是「请选择日期」而不是数字。

刚打开页面,预填的结束日期离今天只有 6 天,说好的一周呢。

原因初始化用的是 Date.now() + 7 × 24 × 60 × 60 × 1000,再用本地取值格式化。若这七天里夹着夏令时回拨、而你恰好在本地时间 00:00–01:00 之间打开,这一整周读回来会变成第六天的 23:30。

处理结束日期自己手填,别依赖预填的那一对。结果由两个字符串各自按 UTC 零点解析后计算,不受这个偏移影响。

四种「算日期」的活儿,哪种该留在这一页

你要解决的问题这一页怎么答什么时候必须换工具
要「往后推 30 天」,不是「下个月的同一天」基准日填 2026-01-31、加 30 天,结果是 2026-03-02。setDate 只做整天推进,2 月短就直接穿过去,表单里也没有「月」这个输入可以做月末钳制。条款写的是「一个月」就换月运算:dayjs('2026-01-31').add(1, 'month') 和 date-fns 的 addMonths 都返回 2026-02-28。单位是天就留在本页,单位是月或年就别拿天数去凑。
差几小时,而不是差几天两个输入框都是 type="date",精度止步于一天。今天 09:00 交接、明天 08:00 交接,这里输出 1 days,绝不会是 23 小时。要小时级就先换成时间戳:时间戳转换工具收 datetime-local、精确到秒,同时给出 seconds 与 milliseconds,两端相减再除以 3600 即得小时数。
工作日要扣法定假日,或者公司单休只有 getDay() 为 0 或 6 才算周末,其余一律计入工作日,没有假日表可填。2026-10-01 到 2026-10-07 在这里是工作日 5 天、周末 2 天——周四、周五、周一到周三全被当成上班日,放假安排它一概不知道。表格里用 NETWORKDAYS.INTL(开始, 结束, '0000011', 假日区域),周末掩码和假日区间一起管;脚本里用 numpy.busday_count(开始, 结束, holidays=[...])。两者都能把 1 号那个周四踢出计数,本页做不到。
要年龄,或者要先拦住「结束早于开始」差值套了 Math.abs,两个日期填反不报警,只安静返回同一个正数,也没有任何「结束早于开始」的状态可供判断。结果还只有整天,没有小时总数可以回头核对。年龄计算工具会明确拒绝结束日早于生日,并按 365.25 / 30.44 折算年月日、另给总小时数。问「多大」去那一页,问「隔多少天」回这一页。
这个日期还要别的标签:ISO 周、季度、年内第几天结果只有总天数加上 365/30/7 的拆解,没有周序号、没有季度,也不会告诉你两端各是星期几。ISO 周数计算工具给 2026-W53 连同该周的周一与周日;时间戳转换给完整的 ISO 8601 字符串。它们都不给天数差,所以问发布窗口时常常需要两个页面同时开着。
三百组成对的日期要一次算完一次只算一组,没有列表、区间或 CSV 入口,一个季度的合同到期日就是三百次手工填写加三百次复制。一行 Python 就能刷完这一列:(date(2026,3,2) - date(2026,1,31)).days 返回 30。本页留给那次需要你亲眼核对的结果。

常见问题

日期差是"两头都算"还是"只算一头"?
默认按"结束日 − 开始日"的天数差(不把首尾两天都计入):1 月 1 日到 1 月 2 日是 1 天。项目工期、请假天数这类"含头含尾"场景需要把结果 +1 天再使用,工具本身只给出差值。
加减工作日(跳过周末)是怎么算的?
工作日模式只跳过周六周日,不识别法定节假日:跨节假日时请先自行扣除相应天数。另外工作日模式统计的是区间内的天数(含首尾),与差值模式口径不同。
跨月份和跨年的大天数为什么有时差一天?
几乎都是边界约定问题:是否包含起始日、是否包含结束日。工具明确显示所采用的约定;和他人对账时先对齐口径再对数字,能省掉大部分"差一天"的争论。

内容复核: