在网站运营中，清晰、一致且美观的时间信息展示对用户体验至关重要。无论是文章发布日期、产品更新时间，还是活动截止时刻，一个友好的日期时间格式总能让访问者更快地获取信息。安企CMS（AnQiCMS）深谙此道，为我们提供了一个强大而灵活的模板标签——stampToDate，让我们可以轻松掌控时间戳在前端的多种日期时间格式显示。

告别原始时间戳：为什么需要格式化？

我们通常从数据库中获取的时间，往往是 Unix 时间戳，一串看似无意义的数字（例如 1609470335）。这样的原始数据显示在网站上，不仅不直观，还会让用户感到困惑。更重要的是，在不同的内容场景下，我们对时间显示的需求也不同：在文章列表中，可能只需要显示简洁的“2023-08-15”；而在文章详情页，可能需要精确到“2023年08月15日 14:30:59”。

安企CMS 的 stampToDate 标签正是解决这些问题的利器。它能将后台存储的时间戳，根据我们定义好的格式，灵活地呈现在网站前端。

stampToDate 的使用奥秘：Go 语言的格式化规则

stampToDate 标签的语法非常直观：{{stampToDate(时间戳, "格式")}}。这里的“时间戳”通常就是我们从 archiveList 或 archiveDetail 等标签中获取到的 CreatedTime 或 UpdatedTime 等字段。而“格式”参数，则是控制最终显示效果的核心。

这里需要注意的是，安企CMS 的模板引擎是基于 Go 语言的，所以它的时间格式化规则也遵循 Go 语言的独特方式。它不像我们日常习惯的 YYYY-MM-DD 或 HH:MM:SS 那样直接表示格式，而是采用一个固定的参考时间——2006年01月02日 15时04分05秒——来作为格式化的“模板”。

这意味着，如果您想显示某种日期时间格式，您只需要将这个参考时间按照您期望的格式书写出来，stampToDate 标签就会根据您的书写方式进行转换。例如：

  • 显示年份： 参考时间中的 2006 就代表年份。
  • 显示月份： 参考时间中的 01 就代表月份（带前导零）。
  • 显示日期： 参考时间中的 02 就代表日期（带前导零）。
  • 显示小时（24小时制）： 参考时间中的 15 就代表小时。
  • 显示分钟： 参考时间中的 04 就代表分钟。
  • 显示秒： 参考时间中的 05 就代表秒。

理解了这个“魔术般的”参考时间，我们就可以随心所欲地组合出各种日期时间格式了。

常用日期时间格式示例：

以下是一些常见的格式化需求及其在 stampToDate 标签中的应用：

  1. 简洁的日期（年-月-日）：

    {{ stampToDate(item.CreatedTime, "2006-01-02") }}
{# 输出: 2023-08-15 #}

  2. 中文日期（年_月_日）：

    {{ stampToDate(item.CreatedTime, "2006年01月02日") }}
{# 输出: 2023年08月15日 #}

  3. 时间（时:分）：

    {{ stampToDate(item.CreatedTime, "15:04") }}
{# 输出: 14:30 #}

  4. 完整日期时间（年-月-日 时:分:秒）：

    {{ stampToDate(item.CreatedTime, "2006-01-02 15:04:05") }}
{# 输出: 2023-08-15 14:30:59 #}

  5. 自定义分隔符的日期（日/月/年）：

    {{ stampToDate(item.CreatedTime, "02/01/2006") }}
{# 输出: 15/08/2023 #}

  6. 包含星期几的日期：

    {{ stampToDate(item.CreatedTime, "Mon, 02 Jan 2006") }}
{# 输出: Tue, 15 Aug 2023 #}

在实际模板中的应用

stampToDate 标签最常用于文章列表、产品详情、评论区等需要展示时间信息的场景。

例如，在一个文章列表页面，您可能希望每篇文章的发布时间以简洁的“年-月-日”格式显示：

{% archiveList archives with type="list" limit="10" %}
    {% for item in archives %}
    <div class="article-card">
        <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
        <p class="article-meta">发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</p>
        <p>{{ item.Description }}</p>
    </div>
    {% endfor %}
{% endarchiveList %}

而在某篇文章的详情页，您可能需要显示更详细的发布和更新时间：

{% archiveDetail archive %}
<article>
    <h1>{{ archive.Title }}</h1>
    <div class="article-info">
        <span>发布时间：{{ stampToDate(archive.CreatedTime, "2006年01月02日 15:04") }}</span>
        <span>更新时间：{{ stampToDate(archive.UpdatedTime, "2006-01-02 15:04:05") }}</span>
    </div>
    <div class="article-content">
        {{ archive.Content|safe }}
    </div>
</article>
{% endarchiveDetail %}

通过这样的灵活应用，您网站上的时间显示将不再是单调的数字，而是符合语境、清晰易读的信息。

**实践与思考

  • 保持一致性： 在网站的不同区域，尽量保持相同类型时间显示格式的一致性，避免给用户带来困惑。
  • 根据语境选择粒度： 列表页倾向于简洁，详情页可以更详细。选择最能满足用户需求的格式。
  • 考虑国际化： 尽管 stampToDate 直接控制的是格式字符串，但通过自定义这些字符串，您可以针对不同语言版本的网站，提供符合当地习惯的日期时间格式（例如，中文网站使用“年-月-日”，英文网站使用“Mon, Jan 02 2006”）。

安企CMS 的 stampToDate 标签，以其独特的 Go 语言格式化机制，为我们提供了在前端精细控制时间显示格式的能力。掌握这一标签，将使您的网站内容更加专业、用户体验更加出色。

常见问题解答 (FAQ)

1. 如果我想显示“星期几”，应该如何设置格式？

Go 语言的日期格式中，参考时间 Mon 代表星期几（简写），Monday 代表星期几（完整）。所以，如果您想显示“周二，2023年08月15日”，可以尝试使用 {{stampToDate(item.CreatedTime, "Mon, 2006年01月02日")}}。

**2. `Created