日期时间标准化与截止日计算

目标与适用范围

把含糊或混合格式的日期时间输入整理为经过校验、具备时区语义、可直接执行的时间戳、标准时间和业务截止日结果。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 收集所有原始日期时间字符串、预期语言环境，以及权威时区或 UTC 偏移。

• 先决定结果要表达的是一个真实瞬时、本地墙上时间，还是需要按工作日与节假日规则调整的业务截止日。

• 决策点: 原始输入代表真实时刻还是本地标签？. 先判断输入是精确瞬时，例如 Unix 时间戳，还是“下周五下午五点”这类依赖本地语境的时间表达。

• 决策点: 哪个时区是权威来源？. 在换算前确定唯一时区基准，避免把发送者、查看者和系统时区混在同一个结果里。

• 决策点: 截止日计算按自然日还是工作日？. 只有在规则明确排除周末或法定节假日时，才引入工作日与节假日修正。

按步骤完成工作流

1. 解析并校验原始输入

从文本中提取日期，拒绝非法值，并在开始计算前确认起止范围本身没有自相矛盾。 使用 date-extractor, date-time-validator, date-range-validator.

2. 统一为单一标准表示

把混杂格式整理成一个稳定表示，确保后续比较、导出和交接都指向同一个时刻或本地时间。 使用 date-format-unifier, iso-8601-converter, timestamp-converter.

3. 确定时区与日历上下文

把标准时间换算到权威时区，并补充星期、周次或跨时区时长等会影响后续判断的上下文。 使用 time-zone-converter, day-of-week-calculator, week-number-calculator, timezone-duration-calculator.

4. 计算截止日或偏移结果

先做纯时间加减，再按明确规则决定是否需要工作日或节假日修正。 使用 date-adder, date-difference, working-days-calculator, holiday-calculator.

交付前验收结果

• 每个输入值都被成功解析或被明确拒绝，并写明权威时区。
• 最终结果包含一致的机器可读表示，例如 ISO 8601 或时间戳；必要时同时给出人类可读时间。
• 任何加减时间、时差计算或截止日顺延都符合已记录的工作日、节假日和截止规则。
• 本工作流不引入重复规则、cron 语法或 ICS 专属排期行为。

常见问题

• 什么时候该用 ISO 8601，而不是 Unix 时间戳？ 当人或 API 需要可读且带时区语义的时间时，用 ISO 8601；当系统只需要唯一数值瞬时时，用时间戳。
• 为什么这个工作流不处理重复会议？ 这里解决的是单次日期时间标准化与计算。重复规则展开、ICS 导出和重复事件验证应交给日历循环工作流。
• 怎样避免多算或少算一天？ 先校验来源时区，再统一成单一标准格式，最后才做加减、差值或工作日修正。