时间戳能解析,为什么配置导入仍应拒绝它
把 savedAt 写成字符串,往往只解决了“数据能放进 JSON”这一步。导入时还要回答:它是不是项目约定的格式?日期本身是否存在?转换后有没有悄悄变成另一天?这几个问题应分别验证。
本文由 AI 辅助整理,基于配置备份恢复实验台现有校验函数,以及 2026 年 11 月 15 日在本机 Node v22.22.1 中完成的十二项边界复核。结果只覆盖这次运行时和输入样例,不代表完成所有浏览器兼容验证。
能解析不等于符合业务约定
本项目把 savedAt 定义为 UTC 时间字符串:日期和时间以 T 连接,必须包含秒,以 Z 结尾;允许省略小数秒,或提供一到三位小数。这里是一项文件格式约定,并非在定义所有合法时间表示。
例如,带 +08:00 的字符串可以表示明确时刻,但不属于当前导入协议接受的文本形式。只有日期的字符串也缺少协议要求的时间信息。拒绝它们时,应提示“当前格式要求 UTC 且以 Z 结尾”,不要笼统说用户填写的时间不存在。
正则表达式先检查形状
现有 isIsoTimestamp 函数先检查输入类型,再用固定表达式核对字段排列、位数和时区后缀。这样可以拒绝数字、前导空格、缺失时间、四位小数秒等不符合协议的输入,避免隐式类型转换把错误数据变成可处理的值。
但形状检查本身不负责验证日历。2026-02-30T00:00:00Z 的数字位数完全正确,二月三十日却不存在。若只检查“年月日都是数字”,非法日期仍会进入后续流程。
解析之后做一次回转核对
函数接着调用 Date.parse,先拒绝解析结果为 NaN 的输入,再把结果转回 ISO 字符串,比较到秒的日期时间部分。本次复核中,原生解析器把 2026 年二月二十九日转换到了三月一日,把二月三十日转换到了三月二日;这些值能够解析,却不再是用户原来写出的日期。
回转比较会发现日期字段发生变化,因此当前校验器拒绝这两项输入。同样,24:00:00 在本次运行时中转换为次日零点,当前严格格式校验也将其拒绝。这是项目对输入边界的选择,不意味着所有时间协议都必须采用同样规则。
比较到秒,需要配合明确的小数精度
当前实现比较前十九个字符,也就是年月日、小时、分钟和秒。它没有直接比较完整文本,因为 .1Z 与 .100Z 在毫秒精度内可以表示同一时刻,转回 ISO 时文本长度会发生变化。前面的格式检查已经限制小数最多三位,因此这里可以把“允许的文本差异”和“日期被修正”区分开。
如果以后要支持微秒或纳秒,就不能直接沿用这套判断:本次四位小数秒样例在原生转换后只保留三位。扩展精度需要同步修改解析、存储、比较和导出规则,不能只把正则位数放宽。
十二项样例说明了什么
本次复核中,秒级时间、一位小数秒、三位小数秒和 2024 年二月二十九日均通过;2026 年二月二十九日、二月三十日、24 点表示、带偏移时区、仅日期、四位小数秒、前导空格及非字符串均按项目规则拒绝,十二项结果全部符合预期。还单独运行了原项目已有的 isIsoTimestamp 测试,测试通过。
这些结果证明当前函数对选定边界的处理符合本项目约定,不能据此推断数据是真实产生的。格式正确的 savedAt 也可能由用户手工修改。因此,它适合作为备份元信息展示,不能单独用于证明操作发生时间、判定最新可信版本或决定权限。
失败信息应帮助用户修复
导入失败时,提示中应区分类型、格式与日期语义问题。带偏移时区可以建议在导出端统一转成 UTC;不存在的日期应要求核对原始数据;精度超出范围则需要明确告知支持到毫秒。在校验通过前,继续保留旧配置和候选数据边界,避免“为了兼容”自动改写原输入后直接提交。
后续跨浏览器复核应使用同一组固定样例,并保留运行时版本。若格式协议需要升级,还应为旧版本文档设计显式迁移规则,让接受范围的变化可追踪。
- 点赞
- 收藏
- 关注作者
评论(0)