术语表

零值时间(zero time)

0001 年 1 月 1 日 00:00:00 UTC,按 RFC3339 格式化为 0001-01-01T00:00:00-00:00。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断页面日期显示成 0001-01-01 的原因,以及该用什么条件判断日期是否设置过

接着读:Date

零值时间(zero time)是 0001 年 1 月 1 日 00:00:00 UTC。按 RFC3339 格式化,_零值时间_为 0001-01-01T00:00:00-00:00。

为什么重要

零值时间的存在感来自「没写日期」:页面的 date 缺省时,.Date 不是一个空值,而是一个真实的 time.Time,直接打印就会得到 0001-01-01。更麻烦的是 Go 模板里 {{ with .Date }} 永远为真,用它判断「有没有日期」会一路走进零值时间分支。所以判断日期是否设置过要用 .IsZero;页脚年份、日期归档、按日期排序里出现 0001 年,基本都是漏了这层判断。

延伸阅读:Page.Date、time.AsTime