作为一位资深的网站运营专家，我深知内容发布时机的艺术及其对用户体验、搜索引擎优化乃至运营效率的深远影响。AnQiCMS（安企CMS）正是为满足这些需求而生，其“时间因子-定时发布功能”是内容运营者手中的一把利器。但光有强大的发布能力还不够，如何将这些精心设置的发布时间在前台优雅、精准地呈现给读者，同样至关重要。这正是stampToDate这一模板标签大显身手的地方。

定时发布功能：灵活运营的基石

AnQiCMS的“时间因子-定时发布功能”无疑是其核心亮点之一，它赋予了内容运营极大的灵活性。想象一下，您可以在深夜灵感迸发时创作内容，但将其发布时间设定在次日清晨用户活跃的高峰时段，或者提前安排好节假日的内容发布计划，无需人工值守。

在AnQiCMS的后台，当您编辑一篇文档时，会发现一个名为“发布时间”的字段。默认情况下，它会自动填充为当前的日期和时间。然而，如果您希望这篇文档在未来的某个特定时刻才正式上线，只需将此字段设置为未来的日期和时间。AnQiCMS会智能地在抵达该时刻后自动发布内容，极大地提升了内容运营的灵活性和自动化水平。文档中明确指出，这个发布时间的格式为2006-01-02 15:04:05，这不仅是后台的输入规范，也暗示了其在系统内部的存储方式。

前台精准展示：stampToDate 的魔法

然而，后台设置的这些时间信息，在数据库中通常以时间戳（timestamp）的形式存储，这对于机器而言高效便捷，但对于人类读者来说，一串10位或13位的数字时间戳显然不够直观。为了让用户能够清晰、准确地阅读到内容发布或更新的具体时间，AnQiCMS为此提供了stampToDate这一简洁而强大的模板标签。

stampToDate标签的核心功能，就是将这种机器友好的时间戳，转换为我们熟悉的、可读的日期和时间格式。它的使用方式非常直观，通常包含两个核心参数：{{stampToDate(时间戳, "格式")}}。

  1. 时间戳：这通常是您希望格式化的原始时间数据。在AnQiCMS的内容模型中，文档的CreatedTime（创建时间）和UpdatedTime（更新时间）等字段，都以时间戳的形式提供，可以直接作为stampToDate的第一个参数。
  2. 格式：这是stampToDate的精髓所在，它遵循Go语言独特的时间格式化规则。与许多其他编程语言使用YYYY-MM-DD这样的占位符不同，Go语言采用一个特定的参考时间点——2006年01月02日 15时04分05秒，并以其对应的数字作为模板。例如，如果您希望显示年份，就写2006；如果想显示月份，就写01。这是一种非常灵活且强大的格式化方式。

理解Go语言的这个格式化规则是关键：

  • 年: 2006
  • 月: 01 (或 Jan 表示英文缩写，January 表示英文全称)
  • 日: 02 (或 _2 表示单个数字的日，前面加空格)
  • 时: 15 (24小时制) 或 03 (12小时制)
  • 分: 04
  • 秒: 05
  • 毫秒: .000
  • AM/PM: PM (与12小时制结合)
  • 时区: MST (或 Z07:00 表示UTC偏移)

通过这些参考值组合，您可以定制出几乎任何想要的日期时间显示格式。

实战演练：在 AnQiCMS 模板中应用

现在，让我们通过具体的模板代码示例，看看stampToDate如何在AnQiCMS的前台模板中实现发布时间的精准展示。

场景一：在文章详情页显示发布时间

假设我们希望在文章详情页（通常对应archiveDetail标签）展示文章的发布时间。文档的CreatedTime字段将提供我们所需的时间戳。

{# 获取当前文章的发布时间戳，并格式化为 "年-月-日 时:分" #}
<div>
    文章发布时间：
    {% archiveDetail articleCreatedTime with name="CreatedTime" %}
    {{stampToDate(articleCreatedTime, "2006-01-02 15:04")}}
</div>

{# 如果您希望显示为中文格式的日期 #}
<div>
    发布日期：
    {% archiveDetail articleCreatedTime with name="CreatedTime" %}
    {{stampToDate(articleCreatedTime, "2006年01月02日")}}
</div>

{# 或者需要更详细的中文时间，精确到秒 #}
<div>
    详细发布时间：
    {% archiveDetail articleCreatedTime with name="CreatedTime" %}
    {{stampToDate(articleCreatedTime, "2006年01月02日 15时04分05秒")}}
</div>

{# 甚至只显示月份和日期 #}
<div>
    月日：
    {% archiveDetail articleCreatedTime with name="CreatedTime" %}
    {{stampToDate(articleCreatedTime, "01-02")}}
</div>

在这个例子中，我们首先使用archiveDetail标签获取了当前文档的CreatedTime（时间戳），然后将其作为第一个参数传递给stampToDate，并根据需求提供了不同的Go语言时间格式化字符串。

场景二：在文章列表页展示每篇文章的发布时间

当您需要在一个文章列表页（通常对应archiveList标签）展示多篇文章的发布时间时，stampToDate同样适用。在for循环遍历文章列表时，每篇文章的CreatedTime会通过item.CreatedTime获取。

”`twig {% archiveList archives with type=“page” limit=“10” %}

{% for item in archives %}
    <div class="article-