日期计算器

关于 日期计算器

"项目交付日往后顺延 45 天是几号""合同还剩多少周到期""距离上线还有多少小时"——这类日期推算靠掰手指容易出错，尤其跨月跨年时。本工具提供两个独立模块：一是日期加减，在基准日上增减天、月、年并显示对应星期几；二是日期间隔，计算两个日期相差的天数、周数、小时数和分钟数。底层使用成熟的日期运算库处理闰年和月份长度差异，结果准确可靠。所有计算均在浏览器本地完成，结果即时呈现，无需等待网络请求，它适合核算项目排期、合同到期与倒计时，跨月跨年也准确。例如计算 2026-01-01 到 2026-08-25 的间隔，会给出相差 236 天、33 周 5 天与工作日数。核算排期时留意是否按工作日计算，含周末的结果会与目标日期有明显差异；跨月跨年运算已处理好闰年与月份长度，可直接用于合同到期提醒。

时区是日期计算里最常见的偏差来源，尤其在只处理「日期」而不含时刻的场景。同一个瞬间在不同时区属于不同的日期，因此两个系统若采用不同时区，跨日的结果就会差一天；而当输入只有日期没有时间时，隐含的时区假设会直接影响加减结果。因此计算前先统一时区，比调整算法更重要。

按月份加减时的边界情况需要明确定义，否则会得到不直观的结果。当起始日大于目标月份的天数时（例如某月三十一日加一个月后落在只有三十天的月份），不同实现分别采取「回退到该月最后一天」或「溢出到下个月第一天」两种策略，结果相差数天。因此在涉及月度结算或订阅周期时，必须先确认采用哪一种约定。

工作日计算需要一份节假日数据作为依据，而它无法从日期本身推导出来。工作日与自然日的差别、调休安排、以及不同地区的节假日各不相同，因此任何「自动排除节假日」的功能都必须依赖一份可更新的日期表。把表当作配置而非内置常量，才能在下一年度到来前及时更新。

夏令时切换会造成某些日期出现「跳过的一小时」或「重复的一小时」。在采用夏令时的地区，切换日的当地时刻并不连续，按小时累加就可能落在不存在或出现两次的时刻上，而按天累加通常不受影响。因此在涉及跨夏令时边界的小时级计算时，用绝对时间轴运算比用当地时刻加减更可靠。

时间戳的单位与起点需要显式确认，这是系统间对接时的常见事故点。同一串数字在一种约定下表示秒，在另一种约定下表示毫秒，两者相差三个数量级；而起点不同（例如以某一年份为零点）会让整数值完全无法对应。因此交换时间戳时应当同时在文档里写明单位与起点，而不是依赖双方默认一致。

最后，日期的存储与展示应当分离，这是避免多数问题的结构性做法。存储时用无歧义的形式（带时区的绝对时间，或纯粹的日期字段），展示时再按用户所在时区与习惯格式渲染。把两者混在一起，例如直接存储本地格式化后的字符串，会在跨时区或跨区域使用时立刻暴露问题，且很难事后补救。