返回资讯中心
外部精选
软件工程
#开发者实时流

开发者称 systemd.time(7) 手册页遗漏大量时间语法细节

来源标题:What systemd.time(7) leaves out

开发者在为独立项目编写 Go 实现时发现,systemd.time(7) 手册页遗漏了大量情况且并非总是正确,最接近规范的其实是带注释的 C 代码。例如手册称一个月为 30.44 天,但 systemd 实际按一年除以 12 即 30.4375 天计算,遵循手册的解析器每月会偏差 3 分 36 秒;单位还区分大小写,M 表示月、m 表示分钟。

Hacker News 最新allddd2026/11/17 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Timers、journalctl --since 以及许多 unit 设置都使用同一套时间语法,而它唯一的文档就是 systemd.time(7)。为另一个项目用 Go 写实现时发现,这份 man page 遗漏了大量情况,而且并不总是正确,所以最接近规范的东西其实是 C 代码——幸运的是,其中许多古怪之处都有注释。

下面的输出来自 systemd 262,每个 systemd-analyze 前面都加了 libfaketime 的 faketime -f '2027-01-01 00:00:00'。

Time spans 时间跨度是一串数字和单位,全部相加,所以 2h 30min 是 150 分钟。systemd-analyze timespan 会以微秒为单位打印结果,以及 systemd 显示它的方式。

Months man page 说一个月是 30.44 天,但 systemd 用的是一年除以 12,即 30.4375 天。

$ systemd-analyze timespan 1M 30.44d Original: 1M μs: 2629800000000 Human: 1month Original: 30.44d μs: 2630016000000 Human: 1month 3min 36s 遵循 man page 的解析器每个月会差 3 分 36 秒。

Case sensitivity 单位区分大小写,M 是唯一的大写单位。m 是分钟,M 是月,而 H、D 或 Min 完全不能用。

$ systemd-analyze timespan 1m 1H Original: 1m μs: 60000000 Human: 1min Failed to parse time span '1H': Invalid argument Plurals 单位是按前缀与一个固定列表匹配的,匹配后剩下的任何内容都会被当作下一个数字读取。days 在列表里,但 hrs、mins 和 secs 不在,所以 hr、min 和 sec 能匹配,剩下的 s 则导致失败。

$ systemd-analyze timespan 1days 1hrs Original: 1days μs: 86400000000 Human: 1d Failed to parse time span '1hrs': Invalid argument Bare numbers 在大多数地方,没有单位的数字就是秒,即使出现在更长跨度的末尾也是如此。1hr30 看起来像一个半小时,但实际上是 1 小时 30 秒。

$ systemd-analyze timespan 1hr30 Original: 1hr30 μs: 3630000000 Human: 1h 30s Signs and dots 每个数字都用 strtoll() 读取,它接受前导 +,所以 5s+5s 是 10 秒。数字后面紧跟第二个小数点会失败,但中间有空格/单位则会开始一个新数字。

$ systemd-analyze timespan 5s+5s '12.34 .56' 12.34.56 Original: 5s+5s μs: 10000000 Human: 10s Original: 12.34 .56 μs: 12900000 Human: 12.900000s Failed to parse time span '12.34.56': Invalid argument Fractions 小数在微秒以下会被截断而不是四舍五入,而且是对每个数字分别进行,所以 0.5us 0.5us 是 0。

$ systemd-analyze timespan '0.5us 0.5us' 1.9999999s Original: 0.5us 0.5us μs: 0 Human: 0 Original: 1.9999999s μs: 1999999 Human: 1.999999s Infinity infinity 也是有效的时间跨度,尽管 man page 没有列出它。它是 systemd 能存储的最大值,像 TimeoutStopSec= 这样的设置用它来关闭超时。

$ systemd-analyze timespan infinity Original: infinity μs: 18446744073709551615 Human: infinity Timestamps 时间戳由星期、日期、时间和时区组成,其中大部分可以省略,也可以是少数几种特殊形式之一,比如 now、+5h 或 @1234567890。systemd-analyze timestamp 会以本地时区打印它,以及自 epoch 以来的秒数。

Two-digit years 年份可以是两位数,man page 在示例中展示了这一点但没有解释。00 到 68 变成 2000 到 2068,69 到 99 变成 1969 到 1999。

$ TZ=UTC systemd-analyze timestamp 68-01-01 69-01-01 70-01-01 Original form: 68-01-01 Normalized form: Sun 2068-01-01 00:00:00 UTC UNIX seconds: @3092601600 From now: 40 years 11 months left Failed to parse "69-01-01": Numerical result out of range Hint: this expression is a valid calendar specification. Use 'systemd-analyze calendar "69-01-01"' instead? Original form: 70-01-01 Normalized form: - UNIX seconds: @0 From now: - 时间戳不能低于 epoch,所以 69-01-01(1969)超出范围。70-01-01 正好是 epoch,即 0,而 systemd 把时间戳 0 打印为 -。在 64 位 time_t 下,上限是 9999-12-30 23:59:59 UTC,即 9999 年结束前一天,这样任何时区都无法把它推入五位数年份(来源)。

转换本身来自 strptime() 中的 %y,而不是 systemd。Calendar events 有自己的一套规则,其中 00 到 69 变成 2000 到 2069,70 到 99 变成 1970 到 1999,所以 69-01-01 是有效的事件(也是上面那条提示的原因)。

$ TZ=UTC systemd-analyze calendar 69-01-01 70-01-01 Original form: 69-01-01 Normalized form: 2069-01-01 00:00:00 Next elapse: Tue 2069-01-01 00:00:00 UTC From now: 42 years 0 months left Original form: 70-01-01 Normalized form: 1970-01-01 00:00:00 Next elapse: never 日期和时间之间的 T(如 RFC 3339 中那样)只适用于四位数年份,man page 没有提到这一点。带 T 时,年份按原样读取,所以 09 是公元 9 年,超出范围。

$ TZ=UTC systemd-analyze timestamp 2009-11-10T18:15:22 09-11-10T18:15:22 Original form: 2009-11-10T18:15:22 Normalized form: Tue 2009-11-10 18:15:22 UTC UNIX seconds: @1257876922 From now: 17 years 1 month ago Failed to parse "09-11-10T18:15:22": Numerical result out of range Timezones man page 列出了 UTC、Z、偏移量以及 IANA 数据库中的名称。缩写只有在数据库中有同名时区,或属于本地时区时才有效,所以在 UTC 下 CET 有效而 PST 无效。

$ TZ=UTC systemd-analyze timestamp '2009-11-10 18:15:22 CET' '2009-11-10 18:15:22 PST' Original form: 2009-11-10 18:15:22 CET Normalized form: Tue 2009-11-10 17:15:22 UTC UNIX seconds: @1257873322 From now: 17 years 1 month ago Failed to parse "2009-11-10 18:15:22 PST": Invalid argument timedatectl list-timezones 显示数据库中有哪些名称(例如 EST 是其中一个,但美国西海岸时间是 America/Los_Angeles、US/Pacific 或 PST8PDT)。在 TZ=America/Los_Angeles 下,PST 和 PDT 有效。

本地缩写也决定是否适用夏令时,与日期无关。在纽约,12 月的 EDT 比 UTC 晚 4 小时,比 EST 差一小时。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →