`prevArchive`和`nextArchive`标签获取的文档时间，如何用`stampToDate`统一格式？
在安企CMS的日常运营中，我们深知内容呈现的细节往往决定着用户体验的优劣。一篇优质的文章不仅内容引人入胜，其排版与信息展示的专业度也至关重要。其中，文章发布时间的统一格式化，就是一个虽小却能极大提升网站专业度的细节。今天，我们就来深入探讨安企CMS中，如何巧妙运用prevArchive和nextArchive标签获取的文档时间，并通过stampToDate标签，将其统一格式化，让您的网站在细节处彰显卓越。
统一时间格式：提升用户体验与网站专业度的关键
在浏览网站时，用户常常希望能够快速了解文章的发布或更新时间。而当“上一篇”和“下一篇”文章的时间显示格式不一致，比如一篇显示“2023-10-26”，另一篇却是“October 26, 2023”，甚至直接显示一串难以理解的数字（时间戳）时，无疑会影响阅读体验，降低网站的专业度。对于搜索引擎优化（SEO）而言，一致且清晰的日期信息也有助于爬虫更好地理解内容的新鲜度。
安企CMS的模板系统为我们提供了极大的灵活性，特别是通过prevArchive和nextArchive这两个标签，我们可以轻松地获取当前文档的上一篇和下一篇文档信息。它们各自返回一个完整的文档对象，其中就包含了CreatedTime（创建时间）和UpdatedTime（更新时间）这两个关键的时间字段。这些时间字段通常以Unix时间戳的形式存储，即一串代表从1970年1月1日00:00:00 UTC到现在的秒数。要让这些时间戳变得易读且统一，stampToDate标签便是我们的得力工具。
深入理解 stampToDate：时间格式化的魔术师
stampToDate标签在安企CMS的模板体系中扮演着将原始时间戳转化为我们熟悉的日期时间格式的重要角色。它的使用方式简洁明了，通常只需要两个参数：
- 时间戳（Timestamp）：这是您想要转换的原始Unix时间戳，通常是10位数字。
- 格式字符串（Format String）：这是一个定义输出日期时间格式的字符串。
这里需要特别注意的是，安企CMS的stampToDate标签所使用的格式字符串，遵循的是Go语言的特定时间格式化标准，而非我们常见的Y-m-d H:i:s这类PHP或Java风格。Go语言采用一个固定的参考时间“2006-01-02 15:04:05”来作为格式化模板。您通过这个参考时间来组合出任何想要的日期时间格式。
举例来说：
- 如果您希望显示为“年-月-日”的格式，您可以写成
"2006-01-02"。 - 如果想显示“年/月/日 时:分”，则可以写成
"2006/01/02 15:04"。 - 需要完整的“年-月-日 时:分:秒”格式，就是
"2006-01-02 15:04:05"。 - 甚至像“02 Jan 2006 (Mon)”这样的复杂格式，也可以通过组合
"02 Jan 2006 (Mon)"来实现。
这个看似特殊的2006-01-02 15:04:05，实际上是Go语言中一个精确到毫秒的时间点，每个数字或字符都代表了时间的不同部分，例如2006代表年，01代表月，02代表日，15代表小时（24小时制），04代表分钟，05代表秒。掌握这个参考点，您就能随心所欲地格式化时间了。
实战演练：统一前后文档时间格式的步骤
现在，让我们将理论付诸实践，看看如何在您的安企CMS模板中，统一prevArchive和nextArchive获取的文档时间格式。假设我们希望将文档的创建时间格式化为“YYYY年MM月DD日”。
首先，在您的文章详情页模板（通常是{模型table}/detail.html）中，您会找到用于展示上一篇和下一篇文档链接的部分。我们以获取创建时间CreatedTime为例：
{# 获取上一篇文档信息 #}
{% prevArchive prev %}
<div class="prev-archive">
{% if prev %}
<a href="{{ prev.Link }}">
<span class="label">上一篇：</span>
<span class="title">{{ prev.Title }}</span>
{# 将时间戳 prev.CreatedTime 格式化为“YYYY年MM月DD日” #}
<span class="date">发布时间：{{ stampToDate(prev.CreatedTime, "2006年01月02日") }}</span>
</a>
{% else %}
<span class="no-archive">没有上一篇了</span>
{% endif %}
</div>
{% endprevArchive %}
{# 获取下一篇文档信息 #}
{% nextArchive next %}
<div class="next-archive">
{% if next %}
<a href="{{ next.Link }}">
<span class="label">下一篇：</span>
<span class="title">{{ next.Title }}</span>
{# 将时间戳 next.CreatedTime 格式化为“YYYY年MM月DD日” #}
<span class="date">发布时间：{{ stampToDate(next.CreatedTime, "2006年01月02日") }}</span>
</a>
{% else %}
<span class="no-archive">没有下一篇了</span>
{% endif %}
</div>
{% endnextArchive %}
在这段代码中，我们首先使用{% prevArchive prev %}和{% nextArchive next %}分别获取了上一篇和下一篇文档的对象，并将其命名为prev和next。为了避免文档不存在时出错，我们加入了{% if prev %}和{% if next %}的判断。
核心的格式化步骤在于：
{{ stampToDate(prev.CreatedTime, "2006年01月02日") }}
这里，prev.CreatedTime（或next.CreatedTime）就是我们从文档对象中获取到的原始Unix时间戳。"2006年01月02日"则是我们定义的Go语言风格的格式字符串，它告诉stampToDate函数如何将时间戳转换为我们希望的中文日期格式。
如果您还需要展示更新时间UpdatedTime，操作方法也是完全相同的：
{# 假设在同一段落中，同时显示创建时间和更新时间 #}
<span class="date">发布时间：{{ stampToDate(prev.CreatedTime, "2006年01月02日") }}</span>
<span class="date">更新时间：{{ stampToDate(prev.UpdatedTime, "2006-01-02 15:04") }}</span>
通过这种方式，无论prevArchive和nextArchive获取到的文档时间戳是什么，它们都将统一按照您定义的格式呈现出来，极大地提升了网站内容的专业度和用户体验。
总结
安企CMS的模板标签设计旨在为运营者提供强大且灵活的控制能力。通过prevArchive、nextArchive获取前后文档信息，再结合stampToDate进行精细化的时间格式控制，您不仅能确保网站日期显示的一致性与美观性，还能为用户带来更流畅的阅读体验。这正是安企CMS帮助中小企业和内容运营团队提升效率、降低成本，并通过技术手段实现内容高效呈现的理念体现。
常见问题 (FAQ)
Q1: stampToDate中的时间戳如果不是10位数字（Unix时间戳），会发生什么？
A1: stampToDate标签期望接收的是标准的Unix时间戳（通常为10位数字，代表秒数）。如果传入的不是有效的Unix时间戳，或者格式不