Go 模板默认不支持直接调用 time.Now() 等函数，需通过自定义函数映射（FuncMap）注入 time.Now，再链式调用 .UTC().Year 获取当前 UTC 年份。
go 模板默认不支持直接调用 `time.now()` 等函数，需通过自定义函数映射（`funcmap`）注入 `time.now`，再链式调用 `.utc().year` 获取当前 utc 年份。
在 Go 的 html/template（或 text/template）中，模板语法本身不支持方法调用链（如 time.Now().UTC().Year()），也不内置时间相关函数——因此直接写 {{time.Time.Now().UTC().Year()}} 会报错 function "time" not defined。正确做法是：将 time.Now 注册为模板函数，利用 Go 模板对返回值的自动字段/方法访问能力，实现链式取值。
以下是推荐实现方式：
✅ 正确注册与使用方式
package main
import (
"html/template"
"log"
"os"
"time"
)
func main() {
// 定义函数映射：将 "now" 关键字映射到 time.Now 函数
funcMap := template.FuncMap{
"now": time.Now, // 注意：此处是函数值，不是调用结果
}
tmplText := `<html><body>The current year is {{now.UTC.Year}}</body></html>`
tmpl, err := template.New("year").Funcs(funcMap).Parse(tmplText)
if err != nil {
log.Fatal("parsing template:", err)
}
if err := tmpl.Execute(os.Stdout, nil); err != nil {
log.Fatal("executing template:", err)
}
}✅ 输出示例（假设当前为 2024 年）：
The current year is 2024
? 原理说明
-
{{now}}调用time.Now()，返回一个time.Time实例； - Go 模板会自动解析后续的
.UTC.Year：-
.UTC是time.Time.UTC()方法（返回time.Time）； -
.Year是time.Time.Year()方法（返回int），模板支持对方法返回值的连续访问；
-
- 因此
{{now.UTC.Year}}等价于time.Now().UTC().Year()，但语法合法且安全。
⚠️ 注意事项
- 不要写
{{now().UTC().Year()}}—— 模板中函数调用不加括号，now后直接接点号即可； - 若需格式化完整日期（如
"2006"），可扩展函数："year": func() int { return time.Now().UTC().Year() },然后模板中用
{{year}}，更简洁、语义更清晰； - 避免在模板中执行耗时或有副作用的操作（如网络请求），
time.Now是安全的纯函数； - 所有时间操作默认基于服务器本地时区；如需强制 UTC，请始终显式调用
.UTC()（如上例），避免因部署环境时区差异导致年份错误（例如跨午夜时区偏移影响）。
✅ 推荐实践（增强可读性与复用性）
funcMap := template.FuncMap{
"currentYear": func() int { return time.Now().UTC().Year() },
"today": func() time.Time { return time.Now().UTC() },
}对应模板：
© {{currentYear}} My Site
<!-- 或 -->
<span>{{today.Format "2006-01-02"}}</span>这样既提升模板可读性，又便于单元测试和逻辑复用。
