Linux systemd.time 怎样区分时长表达式与时间点表达式

Linux 的 systemd 配置里，5min、05:00 和 +5min 都像“时间”，实际却分别可能代表时长、时间点和相对时间。判断方法不是看字符串长短，而是先看字段要表达“经过多久”“某个时刻”还是“按日历重复”。官方资料地址：https://www.freedesktop.org/software/systemd/man/latest/systemd.time.html。

先按“值的含义”区分三种表达式

最容易混淆的是相对时间：+5min 仍然属于 timestamp 的输入，它表示“当前时刻加五分钟”，不是一个可直接替代 OnCalendar= 的重复规则。

用 timespan 验证时长单位和默认值

时长表达式会把各段相加，空格可以省略。月份按约 30.44 天、年份按约 365.25 天换算，因此它适合表示等待、超时和间隔，不适合表达“下个月同一天”。

# 用中文注释说明：先把复合时长归一化，再观察没有单位时的默认秒数
systemd-analyze timespan '2h 30min'
systemd-analyze timespan '55s500ms'
systemd-analyze timespan '90'

前两个输入分别是 9000 秒和 55.5 秒；第三个输入通常按 90 秒理解，但具体字段仍要以对应 unit 文档的例外说明为准。生产配置里建议显式写 s、min 或 h，减少读者把裸数字误解成毫秒的风险。

用 timestamp 检查绝对时间、相对时间与时区

时间点可以只写日期、只写时刻或使用 now、today、tomorrow 等特殊词。没有显式时区时，通常按当前时区解释；用 UTC、Asia/Shanghai 或 RFC 3339 偏移量能让配置更稳定。

# 用中文注释说明：分别检查绝对时间、相对当前时间和显式时区
systemd-analyze timestamp '2026-10-27 05:00 UTC'
systemd-analyze timestamp '+5min'
systemd-analyze timestamp '2026-10-27T13:00:00+08:00'

+5min 的结果会随执行时刻变化，所以它适合一次性计算或依赖“现在”的接口，不宜把一次归一化结果硬编码进长期 timer 规则。若输入带星期，星期与日期不一致时会被拒绝，这正好能发现手工配置中的隐性错误。

timer 重复任务要改用 calendar 语法

当需求是“每天 9 点”或“每周一执行”，应使用日历事件。例如 daily 会归一化为每天零点，Mon *-*-* 09:00 表示每周一 9 点。它描述的是匹配规则，不是从当前时刻开始等待九小时。

# 用中文注释说明：验证重复调度规则，并查看下一次匹配时间
systemd-analyze calendar 'Mon *-*-* 09:00'
systemd-analyze calendar 'daily'

检查顺序可以固定为：字段语义 → 对应子命令 → 显式单位或时区 → 再写入 unit。这样能把“等待 5 分钟”和“每天某时触发”分开，也避免把 OnBootSec=5min 错写成 OnCalendar=+5min。

常见问题

为什么 05:00 不能当作五分钟？

它包含冒号，通常按时刻解析，表示当天 05:00；五分钟应写成带单位的 5min。

为什么 timer 配置里最好写时区？

机器时区变化或多机部署会改变未标注时区的解释。跨环境任务优先写 UTC 或明确的 IANA 时区。

怎么快速判断写错了哪一类？

把候选值交给 timespan、timestamp、calendar 中语义最接近的命令归一化；命令拒绝输入时，再回到字段文档检查类型。

记住一个实用判断：时长看单位累加，时间点看日期和时区，重复任务看日历匹配。systemd.time 的语法相近，但字段语义决定了应该调用哪一种解析器。