如何在安企CMS模板中格式化时间戳，以友好的日期/时间形式显示？
在网站内容的展示中，如何将后台存储的时间戳数据，以用户友好且易于阅读的日期或时间形式呈现，是提升用户体验的关键一环。安企CMS深谙此道，为模板开发者提供了一个简洁高效的标签——stampToDate，让这一过程变得轻而易举。
理解安企CMS中的时间戳
在安企CMS的许多内容模型中，如文章、产品或分类等，时间数据通常以10位的时间戳形式存储。例如，文章的创建时间（CreatedTime）和更新时间（UpdatedTime）就是这样的时间戳。这种格式虽然便于数据库存储和计算，但直接显示给用户则显得生硬且难以理解。我们需要将其转换为常见的“年-月-日 时:分:秒”等形式。
核心利器：stampToDate 标签解析
安企CMS的模板引擎支持类似Django的语法，其中stampToDate标签正是为了解决时间戳格式化问题而设计的。它的使用方式非常直观：
{{stampToDate(时间戳字段, "格式化字符串")}}
这里有两个关键部分：
- 时间戳字段：这通常是你从
archive、item等对象中获取到的10位时间戳数据，例如item.CreatedTime。 - 格式化字符串：这是决定时间日期显示样式的核心。安企CMS的模板引擎采用了Go语言（GoLang）的时间格式化标准。
Go语言时间格式化规则
Go语言的时间格式化规则与PHP、Python等语言中常见的Y-m-d H:i:s之类的占位符有所不同。它使用一个固定的参考时间来定义格式，这个参考时间是：
2006年01月02日 15时04分05秒 -0700 MST
你需要将这个参考时间中的各个部分，替换成你希望显示的实际日期时间元素。举例来说：
2006代表年份（四位数）01代表月份（两位数）02代表日期（两位数）15代表小时（24小时制，两位数）04代表分钟（两位数）05代表秒数（两位数）- 如果你想显示12小时制的小时，可以使用
03。 - 如果你想显示星期几，可以使用
Mon（简写）或Monday（全称）。
理解这个参考时间是掌握Go语言时间格式化的关键。
常用格式化示例
掌握了Go语言的格式化规则后，我们可以轻松地实现各种常见的日期时间显示需求：
仅显示年-月-日：
<div>{{stampToDate(item.CreatedTime, "2006-01-02")}}</div> {# 例如：2023-10-27 #}显示中文格式的年-月-日：
<div>{{stampToDate(item.CreatedTime, "2006年01月02日")}}</div> {# 例如：2023年10月27日 #}显示完整日期和时间（24小时制）：
<div>{{stampToDate(item.CreatedTime, "2006-01-02 15:04:05")}}</div> {# 例如：2023-10-27 10:30:45 #}显示完整日期和时间（12小时制，带上下午）：
<div>{{stampToDate(item.CreatedTime, "2006-01-02 03:04:05 PM")}}</div> {# 例如：2023-10-27 10:30:45 AM #}仅显示时:分：
<div>{{stampToDate(item.CreatedTime, "15:04")}}</div> {# 例如：10:30 #}显示周几：
<div>{{stampToDate(item.CreatedTime, "Mon")}}</div> {# 星期五 #} <div>{{stampToDate(item.CreatedTime, "Monday")}}</div> {# 星期五 #}
在模板中的实际运用
通常，你会在遍历文档列表或显示文档详情时使用stampToDate标签。例如，在展示文章列表时，你可能需要显示每篇文章的发布日期：
{% archiveList archives with type="page" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>
<span>发布日期：{{stampToDate(item.CreatedTime, "2006年01月02日 15:04")}}</span>
<span>浏览量：{{item.Views}}</span>
</div>
</a>
</li>
{% empty %}
<li>暂无内容</li>
{% endfor %}
{% endarchiveList %}
或者在文章详情页显示文章的更新时间：
<article>
<h1>{% archiveDetail with name="Title" %}</h1>
<div>
<span>更新于：{% archiveDetail archiveUpdatedTime with name="UpdatedTime" %}{{stampToDate(archiveUpdatedTime, "2006-01-02 15:04")}}</span>
</div>
<div>
{% archiveDetail archiveContent with name="Content" %}
{{archiveContent|safe}}
</div>
</article>
可以看到，stampToDate标签让时间戳的格式化变得非常灵活且强大，只需调整格式化字符串，就能满足几乎所有日期时间显示的需求。
使用建议与注意事项
- 牢记Go语言格式化标准：这是核心。不要混淆Go语言的
2006-01-02 15:04:05参考时间与其他语言的占位符。一旦掌握，便可举一反三。 - 输入值必须是时间戳：
stampToDate标签专门用于处理10位或更多位的整数时间戳。如果你的变量已经是time.Time类型的Go语言时间对象，则应该使用date过滤器（如{{ myTimeVar|date:"2006-01-02" }}），但通常在模板中直接操作time.Time对象的情况较少，安企CMS通常会将时间提供为时间戳。 - 验证显示效果：在修改模板后，务必刷新页面，检查日期时间是否按照预期格式显示。
通过stampToDate这个强大的标签，安企CMS为开发者提供了极大的便利，让时间日期的显示不再是难题，只需简单几步，就能将冰冷的时间戳转化为用户眼前友好的信息。
常见问题 (FAQ)
Q1: 为什么我的日期格式化出来总是显示“2006-01-02”，而不是实际的日期？
A1: 这是因为您可能误解了Go语言的时间格式化规则。在stampToDate标签中，"2006-01-02"不是一个占位符，而是一个固定的参考日期。您需要将您想显示的实际日期元素的样式，对照这个参考日期来编写。例如，如果您想显示”年-月-日”，就写"2006-01-02"；如果想显示”日/月/年”，就写"02/01/2006"。
Q2: 我有一个变量是time.Time类型（或类似日期对象），可以使用stampToDate进行格式化吗？
A2: stampToDate标签是专门用来格式化整数时间戳的。如果您的变量已经是后端处理好的time.Time或其他日期对象，您应该尝试使用模板引擎内置的date过滤器（如果可用）或其他适用于该数据类型的格式化方法。在安企CMS的模板中，大部分时间数据会直接以时间戳形式提供，因此stampToDate通常是首选。
Q3: 如果我只需要显示年份、月份或特定部分的日期，格式化字符串怎么写？
A3: 您可以根据Go语言的参考时间2006年01月02日 15时04分05秒，只选择您需要的部分。
- 只显示年份：
{{stampToDate(item.CreatedTime, "2006")}} - 只显示月份：
{{stampToDate(item.CreatedTime, "01")}}(会显示如”10”) 或{{stampToDate(item.CreatedTime, "Jan")}}(会显示如”Oct”) - 只显示小时和分钟：
{{stampToDate(item.CreatedTime, "15:04")}}