Revel框架中直接调用.TimeField.Format即可格式化time.Time，无需额外函数；需确保字段为非指针time.Time类型，布局字符串须严格遵循Go参考时间格式，指针类型需先判空，时区转换应在Controller层完成。
Revel 框架默认使用 Go 原生的 html/template，所以它对 time.Time 的处理方式和标准 html/template 完全一致——不额外封装、不自动格式化、也不拦截方法调用。你不需要引入 Revel 特有的日期函数，直接用 .TimeField.Format 就行。
模板里直接调用 Format 方法
Revel 的模板引擎允许调用公开方法，而 time.Time.Format 正好满足条件：接收一个 string 参数，返回一个 string。只要你的结构体字段是 time.Time 类型（不是指针、不是字符串），就能在模板中安全使用。
比如结构体定义：
type BlogPost struct {
Title string
CreatedAt time.Time
}
模板中写法：
{{ .CreatedAt.Format "2006-01-02 15:04:05" }}
{{ .CreatedAt.Format "Jan 2, 2006" }}
{{ .CreatedAt.Format "2006年01月02日" }} // 中文格式，注意引号内是字面量
- 布局字符串必须严格按 Go 的参考时间
"Mon Jan 2 15:04:05 MST 2006"对应，不能写"yyyy-MM-dd"或"%Y-%m-%d" - 大小写敏感：
"M"是月，"m"是分；"Y"是 4 位年，"y"是 2 位年 - 如果字段是
*time.Time（指针），模板中需先判空，否则.CreatedAt.Format会 panic
避免在 Controller 层提前转成字符串
常见错误是把 time.Time 在 Revel 的 controller 里就 Format 成字符串，再传给模板：
// ❌ 错误：丢失类型语义，无法再做时区转换或计算
c.RenderArgs["created_at_str"] = post.CreatedAt.Format("2006-01-02")
这会导致后续想改格式、切时区、或加“X 分钟前”逻辑时，必须回退到字符串解析，徒增风险。
- 保持字段原始类型，把格式化决策留在模板层，更灵活
- 若需统一格式（如所有时间都显示为“刚刚/今天/昨天”），可封装一个自定义 template func，而不是提前转字符串
- Revel 支持注册全局 template func，例如
ago，内部调用time.Since+ 条件判断
处理 *time.Time 空值和零值
从数据库读取的时间字段常为 *time.Time（如 PostgreSQL 的 NULL TIMESTAMP）。Revel 模板里直接调用 .Field.Format 会 panic，因为 nil 指针解引用。
安全写法是模板内判空：
{{ if .UpdatedAt }}
{{ .UpdatedAt.Format "2006-01-02" }}
{{ else }}
—
{{ end }}
- 不要依赖
.UpdatedAt.IsZero判空：如果.UpdatedAt是*time.Time且为 nil，.UpdatedAt.IsZero本身就会 panic - 正确判空只有一种：先检查指针是否非 nil，再访问其方法，即
{{ if .UpdatedAt }}（Go template 对 nil 指针求值为 false） - 如果结构体字段是
time.Time（非指针），零值是time.Time{}，此时.Field.Format不 panic，但输出的是 “0001-01-01 00:00:00”，建议仍用{{ if not .Field.IsZero }}过滤
时区问题在 Revel 模板里怎么体现
time.Time 内部始终是 UTC 时间戳，Format 默认按 Local 时区渲染。你在 Revel controller 里传入模板的 time.Time 是什么时区，模板里就显示什么时区。
典型陷阱：
- 从 PostgreSQL 读取
TIMESTAMP WITH TIME ZONE，Go 驱动自动转成 Local 时区的time.Time→ 模板中.Time.Format显示本地时间 - 从 JSON API 解析
"2026-10-19T05:12:00Z"，用time.Parse(time.RFC3339, s)得到的是 UTCtime.Time→ 模板中.Time.Format会按本地时区显示（可能差 8 小时） - 解决办法不是在模板里改时区，而是在 controller 层统一调用
.In(location)转换，再传入模板；或者让前端用 JS 处理时区
真正容易被忽略的是：Revel 没有“模板时区上下文”概念，所有时区转换必须发生在数据进入模板之前。别指望靠一个配置开关让所有 .Time.Format 自动套上 CST 或 UTC。
