作为一名资深的网站运营专家，我深知在日常内容管理中，如何高效且灵活地展示信息至关重要。安企CMS（AnQiCMS）凭借其Go语言的高效特性和Django风格的模板语法，为我们提供了强大的内容展示能力。今天，我们将聚焦安企CMS模板中一个非常实用的小技巧：如何通过stampToDate标签，只提取时间戳中的年份进行显示。
安企CMS模板的时间处理哲学
安企CMS采用了类似Django的模板引擎语法，这使得模板的编写既直观又强大。无论是展示文章标题、内容、分类，还是处理时间数据，都有相应的标签和变量供我们调用。在很多场景下，我们从数据库中获取的时间信息通常是Unix时间戳，一个表示从1970年1月1日零时零分零秒起，到当前时间所经过的秒数。直接显示这些数字对用户而言并不友好，因此，AnQiCMS提供了一个名为stampToDate的内置标签，专门用于将这些原始的时间戳转换为我们熟悉的日期时间格式。
深入理解stampToDate标签的工作原理
stampToDate标签的核心功能在于其强大的格式化能力。它的使用方式是{{stampToDate(时间戳, "格式")}}。这里的关键在于第二个参数——格式。它遵循Go语言独特的日期时间格式化规则。与我们可能习惯的YYYY-MM-DD等模式不同，Go语言使用一个特定的参考时间点来定义格式，这个参考时间点固定为：
2006年01月02日 15时04分05秒
这意味着，当你想要显示年份时，就使用2006；想要显示月份时，就使用01或1（取决于是否需要前导零）；显示日期时，使用02或2，以此类推。这个参考时间点中的数字本身，就代表了它们各自对应的日期时间组成部分。
实际操作：仅提取年份进行显示
现在，让我们回到核心问题：如何在安企CMS模板中只提取时间戳中的年份进行显示？
答案就藏在Go语言的格式化规则中。只需将stampToDate的格式参数设定为2006，它就会智能地识别并只提取时间戳中的年份信息进行展示。
假设你有一个名为publishStamp的变量，存储了一个10位的Unix时间戳，比如1672502400（这大约是2023年1月1日）。如果你想显示它所代表的年份，可以这样写：
{# 假设 publishStamp 是一个Unix时间戳变量 #}
<div>文档发布年份：{{stampToDate(publishStamp, "2006")}}</div>
页面输出将会是：
文档发布年份：2023
这非常简洁直观。在安企CMS的实际内容列表或详情页中，文档（archive）或评论（comment）等数据通常会包含CreatedTime（创建时间）或UpdatedTime（更新时间）这类时间戳字段。例如，在一个文章列表中，你可能希望只显示文章的发布年份：
{% archiveList archives with type="list" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>发布于：{{stampToDate(item.CreatedTime, "2006")}}</div> {# 只显示年份 #}
</a>
</li>
{% endfor %}
{% endarchiveList %}
这样，每篇文章旁边就只会显示其发布年份，无需展示完整的日期，保持了页面布局的整洁。
更多灵活的日期格式化
stampToDate的强大之处远不止于此。通过调整格式字符串，你可以轻松实现多种日期时间显示方式。例如：
- 显示完整的日期（年-月-日）：
{{stampToDate(item.CreatedTime, "2006-01-02")}}输出：2023-01-01 - 显示带有中文的日期：
{{stampToDate(item.CreatedTime, "2006年01月02日")}}输出：2023年01月01日 - 显示完整日期和时间：
{{stampToDate(item.CreatedTime, "2006-01-02 15:04:05")}}输出：2023-01-01 08:00:00(取决于时区)
熟练掌握Go语言的这个参考时间点，将让你在安企CMS的模板开发中如鱼得水，无论是显示简洁的年份，还是详尽的日期时间，都变得轻而易举。
注意事项与**实践
- 时间戳精度：
stampToDate标签默认期望接收的是10位的Unix时间戳（秒级）。如果你的时间戳是13位的毫秒级时间戳，你需要先将其除以1000转换为秒级。 - Go语言格式化规则：记住
2006-01-02 15:04:05这个神奇的数字串是Go语言日期格式化的精髓。它不是占位符，而是字面上的参考值。 - 缓存影响：在开发或修改模板后，如果前台页面没有立即更新，别忘了清理安企CMS的缓存，以确保最新的模板代码被正确加载。
常见问题 (FAQ)
Q1: 为什么stampToDate格式化年份要用2006而不是YYYY？
A1: 这是Go语言日期时间格式化机制的独特性。Go语言没有采用YYYY-MM-DD这种常见的占位符模式，而是使用一个固定的参考时间点2006-01-02 15:04:05。在这个参考时间点中，2006就代表了年份，01代表月份，02代表日期，15代表小时（24小时制），04代表分钟，05代表秒。当你提供一个格式字符串时，Go会根据你字符串中包含的参考时间点部分来匹配并输出相应的时间信息。
Q2: 除了年份，如果我想显示月份和日期，应该如何操作？
A2: 同样是利用Go语言的参考时间点。如果你想显示“年-月-日”，格式字符串就是"2006-01-02"；如果想显示“月/日”，可以是"01/02"；如果你想显示“月日”，可以是"01月02日"。例如：
{{stampToDate(item.CreatedTime, "01月02日")}} 将显示01月01日。
Q3: 我的时间戳是13位的（毫秒级），stampToDate标签可以直接用吗？
A3: stampToDate标签默认期待10位的Unix时间戳（秒级）。如果你的时间戳是13位的毫秒级时间戳，你需要先将其转换为10位。虽然安企CMS的模板语法中没有直接提供除法运算的过滤器来处理这个问题，但在Go语言后端代码中处理或通过其他方式（例如数据库查询时转换）会更合适。如果必须在前端模板中处理，可以考虑在输出时间戳之前进行处理，或者确保传入模板的时间戳已经是10位的秒级时间戳。