术语表

协调世界时(UTC)

全球用于规范时钟与时间的首要时间标准,也是民用时间与时区的基础。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 判断日期显示差一天、或页面根本没进构建,是不是时区与日期字段造成的

接着读:AsTime

UTC 是协调世界时(Coordinated Universal Time)的缩写,是全球用于规范时钟与时间的首要时间标准。它是全球民用时间与时区的基础。

参见:协调世界时(维基百科)

为什么重要

前置元数据里不带时区的日期,Hugo 会按项目配置的 timeZone 解析,未配置时落到 Etc/UTC;而模板输出又保留值本身带有的偏移量。于是同一篇内容在不同机器、不同时区下可能显示成不同的日期,甚至因 date 被判定在未来而整页不进构建(hugo list future 可查,加 --buildFuture 才构建)。要稳定输出,就给日期写明确的 IANA 时区名或偏移量,机器可读的时间再用固定布局输出。

延伸阅读:解析日期与时间、日期格式