如何利用`stampToDate`标签在文章列表页显示每篇文档的发布日期？

赋能内容时效性：安企CMS中文章列表页发布日期的高效展示之道

在当今瞬息万变的数字世界里，内容的时效性对于网站的吸引力和用户体验至关重要。无论是新闻报道、技术文章还是产品更新，清晰地展示发布日期都能帮助读者快速判断信息的价值，提升网站的专业度。对于安企CMS（AnQiCMS）的用户来说，这是一项非常容易实现的功能，因为系统内置了强大而灵活的模板标签体系，尤其是stampToDate标签，它能巧妙地将后台的时间戳数据转换为我们熟悉的日期格式。

作为一名资深的网站运营专家，我深知将技术细节转化为实际操作的价值。接下来，我将引导大家，如何利用安企CMS的stampToDate标签，在您的文章列表页上，优雅地展示每一篇文档的发布日期。

理解时间背后的“秘密”：stampToDate标签的工作原理

在安企CMS的后台，文章的发布时间通常以“时间戳”（Unix timestamp）的形式存储。这本质上是一个长长的数字序列，代表了从1970年1月1日0时0分0秒（UTC）起，到某个特定时间点所经过的秒数。这种格式对于计算机来说非常高效，但对人类而言则显得晦涩难懂。

为了解决这个问题，安企CMS提供了stampToDate这个强大的模板标签。它的作用，顾名思义，就是将这种数字时间戳“盖章”转换成人类可读的日期和时间格式。它的基本使用方法非常直观：

{{ stampToDate(时间戳, "格式") }}

这里有两个关键部分：

1. 时间戳：您需要传入一个10位或13位的数字，代表着文章的发布时间。
2. 格式：这是一个字符串，它告诉stampToDate您希望日期以何种形式展现。这里需要特别注意的是，安企CMS（基于Go语言开发）的日期格式字符串是基于一个固定的参考日期2006-01-02 15:04:05来定义的。例如，如果您想显示“年-月-日”格式，您就应该写成"2006-01-02"；如果想显示“时:分”，则写成"15:04"。这个参考日期就像一个模板，您按照它的对应位置输入想要显示的年、月、日、时、分、秒即可。

捕获文章发布时刻：archiveList中的CreatedTime

当我们在安企CMS的文章列表页（通常是模型对应的list.html模板文件，例如article/list.html）使用archiveList标签循环展示文章时，每一篇文章的详细信息都会被赋予到一个临时变量（通常命名为item）中。在这个item对象里，就包含了我们需要的发布时间信息——CreatedTime。

item.CreatedTime正是那串10位的数字时间戳，它忠实地记录了文章被创建并发布的那一刻。有了它，我们就可以将其作为stampToDate标签的第一个参数。

将两者巧妙融合：在文章列表页展示发布日期

现在，我们有了“转换工具”（stampToDate）和“原始数据”（item.CreatedTime），接下来就是将它们组合到您的模板代码中。假设您的文章列表页模板（例如article/list.html）结构大致如下：

{% archiveList archives with type="page" limit="10" %}
    {% for item in archives %}
        <article class="article-item">
            <h3 class="article-title"><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
            <div class="article-meta">
                <span class="publish-date">发布日期：{{ stampToDate(item.CreatedTime, "2006年01月02日") }}</span>
                <span class="article-views">阅读量：{{ item.Views }}</span>
            </div>
            <p class="article-description">{{ item.Description }}</p>
            <a href="{{ item.Link }}" class="read-more">查看详情</a>
        </article>
    {% empty %}
        <p class="no-content">暂无文章发布。</p>
    {% endfor %}
{% endarchiveList %}

{# 如果您的列表需要分页，可以在此处添加分页标签 #}
{% pagination pages with show="5" %}
    {# 分页导航的代码，例如： #}
    <div class="pagination-nav">
        {% if pages.PrevPage %}<a href="{{ pages.PrevPage.Link }}">上一页</a>{% endif %}
        {% for page in pages.Pages %}<a href="{{ page.Link }}" class="{% if page.IsCurrent %}active{% endif %}">{{ page.Name }}</a>{% endfor %}
        {% if pages.NextPage %}<a href="{{ pages.NextPage.Link }}">下一页</a>{% endif %}
    </div>
{% endpagination %}

在上面的代码片段中，我们特意在<div class="article-meta">这个区域添加了一行：

<span class="publish-date">发布日期：{{ stampToDate(item.CreatedTime, "2006年01月02日") }}</span>

这行代码正是核心所在。当页面被访问时，archiveList会遍历每一篇文章，item.CreatedTime会提取出当前文章的发布时间戳，然后stampToDate标签会按照您指定的"2006年01月02日"格式，将其转化为“XXXX年XX月XX日”的直观显示。您可以根据需要，调整span标签的样式，让日期信息更好地融入您的网站设计。

灵活多变：定制您的日期显示格式

stampToDate标签的强大之处在于其格式字符串的灵活性。除了上面示例的"2006年01月02日"，您可以尝试各种组合，以满足不同的设计和信息展示需求：

• 仅显示年份和月份：{{ stampToDate(item.CreatedTime, "2006年01月") }} -> 2023年03月
• 简洁的月/日格式：{{ stampToDate(item.CreatedTime, "01/02") }} -> 03/15
• 包含完整时间：{{ stampToDate(item.CreatedTime, "2006-01-02 15:04:05") }} -> 2023-03-15 10:30:00
• 显示星期几：{{ stampToDate(item.CreatedTime, "2006-01-02 Mon") }} -> 2023-03-15 Wed (Go语言格式化中的”Mon”代表星期一，以此类推)

您可以根据网站的整体设计风格和用户阅读习惯，灵活调整日期的显示格式，确保信息清晰且美观。

总结

通过stampToDate标签，安企CMS让在文章列表页展示发布日期变得异常简单和高效。它不仅提升了用户对内容的信任感，也对搜索引擎优化（SEO）有所助益，让爬虫能更好地理解内容的时效性。掌握这个小技巧，您的安企CMS网站运营将更加精细和专业。

常见问题 (FAQ)

1. Q: item.CreatedTime为什么是一个长数字，而不是我熟悉的日期格式？ A: 这是因为item.CreatedTime存储的是Unix时间戳（Unix timestamp）。它是一种国际通用的标准，代表从1970年1月1日0时0分0秒（UTC）至今所经过的秒数。这种格式机器容易处理，方便跨平台数据交换和比较。而stampToDate标签正是用来将这种机器语言转换为我们人类熟悉的日期格式。

2. Q: 我想在日期中只显示年份或月份，应该怎么设置stampToDate的格式参数？ A: 您只需要根据Go语言的参考日期2006-01-02 15:04:05，保留您想显示的年、月部分即可。

   • 只显示年份：{{ stampToDate(item.CreatedTime, "2006年") }}
   • 只显示月份和日期：{{ stampToDate(item.CreatedTime, "01月02日") }}

3. Q: 如果我的文章有更新日期，我想显示更新日期而不是发布日期，可以吗？ A: 当然可以。安企CMS通常也会为文章提供item.UpdatedTime这个字段，它记录了文章最后一次更新的时间戳。您可以将item.CreatedTime替换