日期计算器的工作原理
日期计算器回答两个基本问题：两个时刻之间相隔多长时间，以及将已知日期按固定间隔推移后得到什么时刻。在底层，这两种操作共享同一种严谨的方法：使用 ISO 8601 标准将日期解析为明确的时刻，以协调世界时（UTC）进行算术运算，并按用户请求的粒度取整后呈现结果。
该工具接受一个开始日期和一个结束日期，计算两者之间的经过时长，并将该时长表示为整数天数加上剩余的小时、分钟和秒。它还可以接受单个日期和一个整数偏移量（正数或负数），并返回加上或减去指定数量的年、月或日后的结果日期。两种模式都建立在同样严格的基础上，因此输出结果是确定且可复现的。
理解 ISO 8601 输入解析
进入计算器的每个日期都必须符合 ISO 8601 组合日期时间格式：YYYY-MM-DDTHH:MM:SS。T 分隔符将日历日期与时钟时间组件区分开来，所有时间在解析时立即被解释为 UTC。不存在隐式的本地时区，没有夏令时调整，也没有模糊的小时。如果用户提供了部分时间戳——例如，只有日期没有时间——该工具会将其视为该日 UTC 午夜（T00:00:00）。
不符合 ISO 8601 模式的输入将被直接拒绝。同样的严格性也适用于日期顺序：如果结束日期早于开始日期，计算不会产生负的持续时间。相反，该工具将输入视为无效并停止计算，防止用户依赖难以解读的结果。这种拒绝反转策略使输出空间保持清晰：每个返回的持续时间都是一个正的时间跨度。
持续时间计算：天、小时、分钟和秒
当该工具计算两个时间戳之间的经过时间时，它首先用结束时刻的 Unix 纪元秒数减去开始时刻的 Unix 纪元秒数。得到的整数表示总经过秒数。从这一个值出发，计算器推导出用户看到的每个组件：
- 整天数是总秒数除以 86,400（一个标准 UTC 日的秒数）的整数商。余数则填充小时、分钟和秒的桶。
- 总小时数是总秒数除以 3,600，向下取整得到的整数。这不是"减去天数后剩余的小时数"，而是整个时间跨度以小时表示的总量。
- 总分钟数和总秒数遵循相同的模式：分别将原始秒数除以 60 和 1，向下取整。
这种向下取整的设计意味着，在总量级视图中，90,123 秒的持续时间不会被呈现为"1 天 1 小时 2 分钟 3 秒"。相反，总小时数显示为 25 小时，总分钟数显示为 1,502 分钟，总秒数显示为 90,123 秒。除了这些累积数字外，该工具还同时显示分解为整天数加上剩余小时、分钟和秒的对应视图，以便用户同时获得两种视角。
月份和年份偏移量的日期算术
加减天数很简单：计算器将底层 UTC 时间戳精确地移动相应的秒数。然而，月份和年份的长度各不相同，因此该工具采用了基于日历的方法。
当用户为某个日期加上一个月时，该工具递增月份字段，同时保留日期值——但有一个关键例外。如果目标月份的天数少于原始日期，计算器会将结果钳制到该月的最后一个有效日期。这就是月末钳制。例如，1 月 31 日加一个月，在闰年得到 2 月 29 日，否则得到 2 月 28 日。时间组件在整个操作过程中保持不变，因此 2024-01-31T12:00:00 加一个月变为 2024-02-29T12:00:00。
年份偏移量的工作方式相同：递增年份字段，保留月份，如果目标日期无效（最常见的是在闰年的 2 月 29 日加一年，落到非闰年），则钳制日期。仅支持整数偏移量——不支持分数月份或年份，因为对于"半个月"意味着什么，没有普遍接受的定义。
计算示例
考虑开始日期为 2026-01-01T00:00:00，结束日期为 2026-01-02T01:02:03。计算器计算秒数差：
该时间跨度正好是 1 天 1 小时 2 分钟 3 秒。以累积方式表示，则是 25 小时、1,502 分钟和 90,123 秒。该工具并排显示所有四种粒度，因此用户既能看到分解视图（1 整天加上余数），也能看到每个总量级数字。
对于日历算术，以 2024-01-31T12:00:00 加一个月为例。1 月有 31 天，因此朴素的目标日期是 2 月 31 日。由于 2024 年是闰年，2 月只有 29 天，该工具将日期钳制到 29 日。时间组件保持正午不变，得到 2024-02-29T12:00:00。这种钳制行为是确定性的，在所有月末边界情况下保持一致。
准确性与局限性
该计算器完全在 UTC 下运行，不考虑时区偏移或夏令时过渡。它直接从解析后的 UTC 时间戳推导持续时间，并报告整秒数，但该结果并不反映观察夏令时变化的用户的"挂钟"体验。如果伦敦的用户需要知道跨越夏令时变更的两个时刻之间相隔多少本地时钟时间，他们必须手动应用该调整。
闰秒不被建模。该工具将每个 UTC 日视为恰好 86,400 秒。对于跨越数十年的持续时间，忽略闰秒的累积误差可能达到几十秒，这对日历日期计算来说可以忽略不计，但对高精度科学用途而言则值得关注。
该工具也不处理 Unix 纪元（1970 年 1 月 1 日）之前或 9999 年之后的日期。超出该范围的输入会被拒绝。月末钳制规则已被记录并一致应用，但用户应注意，业务规则有时会有所不同——例如，某些金融合同将"1 月 31 日之后一个月"定义为每年 2 月 28 日，无论是否闰年。该工具的行为遵循通用的日历月末惯例，而非任何特定的行业标准。
参考来源
ISO 8601 标准规定了日期和时间的表示方式，并支撑了该工具所做的每一个解析决策。该规范的完整版本由国际标准化组织维护。
编辑记录
本文随日期计算器模块的发布而起草。它反映了截至 2026 年 8 月的实现。计算示例已与同日工具的实际输出进行核对，以确保数字与在线计算一致。
未来的修订将记录解析规则、支持的日期范围或钳制行为的任何变更。如果计算器更新以支持时区感知输入或为闰秒建模，本文将相应地进行修订。 作者：SoupCalc 编辑团队 最后审阅日期：2026 年 8 月 11 日。