
三个时长走进一个排序函数:P1M、P30D、P4W。一个想当然的解析器给出 30、30、28 天,并把那个「周」判为最短。以 2026-01-15 为锚点,真实顺序是 P4W 28 天、P30D 30 天、P1M 31 天;换成 2026-02-15 做锚点,同样这三个字符串里 P1M 缩到 28 天,与那个「周」并列。时长是一份配方,不是一个数字。
字母 P 划出的是一条边界,不是前缀
后面所有内容都建立在一个结构性事实之上:一个 ISO 8601 时长不是一个挂着单位的标量,而是一小段程序,意思是:从你开始的那一天出发,按这个顺序走这么远。P 是这段程序的入口,围绕它的语法比人们日常处理的大多数字符串格式都要窄。
指示符区分大小写。p1d 不会被宽容地当成 P1D,它得到的是自己的一条报错信息,因为标准把字母大小写当作承重结构。工具自己的报错文本就写着这份刻意:「the designator must be an uppercase P (ISO 8601 designators are case-sensitive)」,指示符必须是大写 P,ISO 8601 的指示符区分大小写。顺序固定为年、月、周、日,然后是一道 T 闸门,最后是时、分、秒。T 是边界,不是分隔符:没有时间部分的时长里不出现 T,单独一个 PT 根本不构成时长,标准要求闸门后面必须跟数字。
零是特例,正确写法只有一个:P0D。任何路径只要最后不剩组件,都收敛到它,所以 PT0S 返回的是 P0D,不是空字符串。这一条规则消掉了一整类 bug:算出来什么都没有的时长被序列化成一个光秃秃的 P。
时长是一份配方,上面还钉着一个锚点
拿 P1Y2M3DT4H5M6S 来问它有多长。你不给出起点,就没有答案。以 2026-01-15T00:00:00Z 为锚点,工具按组件顺序在日历上走一遍,落到 2027-03-18T04:05:06Z。
这一步值得亲手走一遍,你能看清那些秒是从哪来的:
- 从 2026-01-15 加一年得到 2027-01-15,共 365 天,因为 2026 年不是闰年。
- 再加两个月到 2027-03-15,又是 59 天:1 月 31 天,2 月 28 天。
- 再加三天到 2027-03-18。
- 时间部分加上 4 小时 5 分 6 秒,合 14,706 秒。
合计 427 天加 14,706 秒,也就是 36,907,506 秒的流逝时间。这个数字是精确的,但只对这个锚点精确。把起点挪到 2027-01-15,让年份那一步跨过 2 月 29 日,同一个字符串量出 36,993,906 秒,因为年组件悄悄多拿了一天。一个字符串,两个答案:36,907,506 秒对 36,993,906 秒,全看读者从哪天开始。时长里的「一年」不是 365.25 天,它指的是「同一个日期,一年之后」,这个操作没有固定长度。
这是它与「一对时间戳」第一次真正分道扬镳的地方。一对时间戳是两个点,两点之间的距离是一个数。时长则是一套在点之间移动的指令,不同的指令在某个锚点下可以给出相同的位移,换个锚点就不同了。
周会折进天,小时不肯
规范形式是这套格式承认哪些单位可以互换的地方。工具的归一化很硬:P3W 变成 P21D,P2W3D 变成 P17D,P14M 变成 P1Y2M,PT90M 变成 PT1H30M。每一条都是定义层面的换算:一周正好七天,十二个月正好一年,六十分钟正好一小时。

到这里规律就断了。PT36H 原样不动,不会变成 P1DT12H;PT24H 永远不会变成 P1D。这种不对称是设计的一部分,不是疏忽:在日历里,一天可能是二十三小时,也可能是二十五小时,取决于这一天里有没有落进一次时钟调整。小时精确、连续;天是名义的、本地的。把 24 小时折成一天的序列化器,等于替读者做了一个时区假设。
对于要把时长存下来的人,实际后果是:如果你看到 P1D 和 PT24H 是两个不同的字符串,它们就是两个不同的主张。一个说「明天的同一个墙上时间」,另一个说「从现在起 86,400 秒」。碰上夏令时切换,两者差一小时;把其中一个归一化成另一个的系统,就在实现里埋了一个一年发作两次、而且从不在测试日期发作的错误。
锚点决定哪个时长更长
排序时长这件事,让「配方」这个比喻从可爱变成要你付一个 bug 的代价。把 P1M、P30D、P4W 丢进一个把所有单位都换成天的比较器,得到 30、30、28:P1M 与 P30D 并列,周最小。

把排序锚在 2026-01-15,量出的长度是 31、30、28 天,月成了三者中最长的。锚在 2026-02-15,月是 28 天,正好与 P4W 打平,P30D 反而最大。三个固定字符串的排序变了,字符串本身一个字都没动。
唯一站得住的理解是:时长没有内在长度。「把这些时长排个序」是个没说完的请求,必须补上日期,而且只在这个日期下才有明确定义。所以工具的排序模式把锚点列为必填输入,不提供「一把全排」的选项。任何看板如果对时长列排名却不暴露锚点,展示的排序下个月就可能反过来。
小数在 T 以下精确,在 T 以上消失
语法允许在最小的单位上带小数,若小数出现在更高位,则会标出形态问题。P1.5Y2M 仍能解析,但返回时被打上「不合规」的标记;按标准,小数只能落在最小的单位上,工具给出的说法是「a fraction is only allowed on the smallest present unit」,小数只允许出现在当前最小的单位上。十进制逗号也接受并转换,所以 PT1,5H 会读成 PT1.5H,附一条说明。

到这儿还算合理。下面就到我开始不再信任这个字符串的地方,也是这篇文章最坦白的一段。
P1.5Y 解析得很干净,规范化后还是 P1.5Y。以 2026-01-15 为锚点,绝对长度返回 31,536,000 秒,正好 365 天。那半年没了。不是四舍五入,也不是折成大约 182 天,是直接丢弃:日历算术只取整年整月,小数余量留在原地。P1.5M 同理,量出 31 天,按字面读本该是 45.7 天。
在 T 之下,小数是真的,也是精确的。PT1.5H 量出 5,400 秒,P0.5D 量出 43,200 秒。分界线就是那道 T 闸门:时间组件无损换算成毫秒,日历组件按设计截断,因为不存在「半个月」这种东西。
结构性的警告在这里一条都不会触发:它们覆盖正负号、周与其他单位混写、小数位置和十进制逗号,不包括截断。这个截断是我把解析器的算术移植到 Python,再用同一批输入同时跑两套实现量出来的,两边给出的秒数一致。可以把它当作一处例外:格式确实合法的时长,字面承诺多过实际。
月末截断牺牲了可逆性
给 2026-01-31 加一个月,落不到 2026-02-31 上。工具截到当月最后一个有效日:2026-02-28。例如闰年里对 2024-01-31 做同样的操作得到 2024-02-29,2026-03-31 加一个月得到 2026-04-30。
另一种做法是溢出到下个月,日期会跳到 3 月 2 日或 3 日,凭空造出区间里从来没有的日子。截断把答案留在你点名的那个月里,账单周期和订阅续费要的正是这个。Temporal.Duration 采用的就是这条规则,这也是涉及金钱的场景值得认真对待这套格式的原因。
代价是截断不可逆。2026-01-30 和 2026-01-31 加上 P1M 都落在 2026-02-28。两个不同的输入,一个输出,没有办法还原你从哪天出发。需要往返换算,就把锚点日期和时长存在一起,别试图从一个推出另一个。
为什么「一年两个月,加十一个月,减九十天」不等于「减九十天」
组件算术看起来满足结合律,实际不满足。工具逐项求值,带着一个游标在日历上移动,这是唯一能得出一个可写成时长的答案的办法。
从 2026-01-15 出发,P1Y2M 到 2027-03-15。加 P11M 到 2028-02-15。减 P90D 落在 2027-11-17。锚点到这个终点之间的日历差是 P1Y10M2D,净流逝时间是 57,974,400 秒,即 671 天。
把组件直接相加,得到零年零月减九十天。这个答案不只是不精确,它根本没法被写成正确的时长,因为月份在行走的某个环节里变成了天,而字符串里没有任何东西记录这一步发生在哪里。
同一个断裂有两处实测演示,都来自我那份与工具自身算术对照的移植实现:
- 2026-01-31 加
P1M再加P1M得 2026-03-28;2026-01-31 加P2M得 2026-03-31。差三天,因为第一步截断了,第二步从一个已经被截断的日期出发。 - 2026-01-31 加
P3M再减P90D得 2026-01-30;先减九十天再加三个月,得 2026-02-02。
日历算术里的运算顺序是答案的一部分,不是实现细节。如果你的流水线在数据库里把时长加总、一次性应用,它就会和逐条应用的流水线对不上,而两者在一个从不触发截断的测试日期上都显得正确。
信任一个时长字符串之前,该查什么
以下五个问题,几乎能抓住我梳理这套格式时发现的每一个缺陷:
- 凡是比较、排序或累加时长的地方,锚点写出来了吗?没有锚点,比较就是未定义的。
- 时长在年或月那一级带了小数吗?日历算术会把这段小数丢掉。
- 字符串以正负号开头,或者把周和其他单位混写了吗?两者都是 ISO 8601-2 的扩展,纯 8601-1 解析器会直接拒绝,于是同一份数据在一个服务里通过校验,在另一个服务里报错。
- 有没有把指示符不同的两个时长直接排名,比如
P1M对P30D?先按一个真实锚点把两者都换算一遍。 - 流水线是先加月还是先减天?答案不一样,这个差异会一路走到生产环境。
想把五条都试一遍,可以用 ISO 8601 时长解析与算术工作台:解析、表达式、排序、差分四种模式都跑在你自己的一个锚点字段上。反方向也一样,从「三年两个月十四天」这样的自然语言短语生成合规字符串,ISO 8601 时长构造器 从另一侧覆盖同样的边界情况;它自己给出的示例 P1WT12H 正是「周加时间」的混写,纯 8601-1 会拒绝。更多工具在 elysiatools.com。
动笔时我以为这是一篇讲格式化器的文章:一个拿 P1Y2M3D 进来、还你一个更整齐写法的工具。想错了。这里的每个数字都是有条件的:从 2026-01-15 开始,才是 36,907,506 秒;那个月是二月,P1M 才是 28 天。那么你的时长列里存的到底是什么,一个长度,还是一句关于某本你从未传进去的日历的承诺?要么把日历留在回路里,要么继续解释那少掉的一天。
Pingback: P1M Is Not P30D: A Duration Is a Recipe, Not a Number - COSESAI