在网站内容管理中，时间信息扮演着至关重要的角色，无论是文章的发布日期、更新时间，还是评论的提交时刻，都离不开时间的记录。数据库通常会以一种简洁高效的格式——Unix 时间戳来存储这些时间数据。然而，对于最终用户来说，一串数字组成的时间戳显然不如“2023年10月27日 14:30”这样直观易懂。

AnQiCMS 作为一款基于 Go 语言开发的内容管理系统，充分考虑了这一需求。它在模板中提供了强大且灵活的工具，能够帮助您轻松地将 Unix 时间戳转换为各种可读的日期时间格式，极大地提升了网站内容的友好性和用户体验。

AnQiCMS 模板与时间戳

AnQiCMS 的模板引擎语法与 Django 模板非常相似，这使得熟悉 Web 开发的伙伴能够快速上手。它的设计哲学在于简洁高效，让内容运营和模板制作变得轻松。在处理时间数据时，AnQiCMS 提供了一个专门的标签——stampToDate，用于在前端模板中直接将 Unix 时间戳格式化。

首先，让我们简单了解一下 Unix 时间戳。它通常是一个整数，代表从“纪元”（1970年1月1日 00:00:00 UTC）开始至今所经过的秒数。例如，1678886400 这个数字可能代表着某个特定的日期和时间，但单独看这串数字，我们很难立即理解它所表达的含义。

使用 stampToDate 标签进行格式化

stampToDate 标签是 AnQiCMS 模板中格式化 Unix 时间戳的核心工具。它的使用方式直观而强大：

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

这里有两个关键部分：

  • 时间戳：您要格式化的 Unix 时间戳，通常是一个 10 位整数，代表秒数。
  • 格式：这是一个字符串，定义了您希望时间显示的具体格式。

值得注意的是，AnQiCMS 模板的日期时间格式化字符串遵循 Go 语言的特定规则，它使用一个固定的“参考时间”——2006年01月02日 15时04分05秒 -0700 MST 来定义各种时间组成部分。这与我们在其他语言（如 PHP 的 Y-m-d 或 Python 的 %-Y-%m-%d）中常见的模式字母不同。

为了帮助您理解并应用，以下是 Go 语言格式化中一些常用参考元素的含义：

  • 2006 代表年份
  • 01 代表月份（两位数）
  • 02 代表日期（两位数）
  • 15 代表小时（24小时制，两位数）
  • 03 代表小时（12小时制，两位数）
  • 04 代表分钟（两位数）
  • 05 代表秒（两位数）
  • Mon 代表星期几（简写）
  • Monday 代表星期几（全称）
  • Jan 代表月份（简写）
  • January 代表月份（全称）

您可以根据这些参考元素组合出您需要的任何日期时间格式。

常用格式化示例：

  • "2006-01-02"：显示为 年-月-日 (例如：2023-10-27)
  • "2006/01/02"：显示为 年/月/日 (例如：2023/10/27)
  • "15:04:05"：显示为 时:分:秒 (例如：14:30:59)
  • "2006-01-02 15:04"：显示为 年-月-日 时:分 (例如：2023-10-27 14:30)
  • "2006年01月02日 15时04分"：显示为自定义中文格式 (例如：2023年10月27日 14时30分)
  • "Monday, Jan 02 2006"：显示为 星期几, 月份简写 日 年份 (例如：Friday, Oct 27 2023)

在 AnQiCMS 模板中的实际应用

在 AnQiCMS 中，文章的创建时间 (CreatedTime) 和更新时间 (UpdatedTime) 字段都存储为 Unix 时间戳。您可以在文章列表页、文章详情页或任何需要展示这些时间的地方使用 stampToDate 标签。

1. 在文章列表中显示发布时间与更新时间：

假设您正在构建一个文章列表页面，希望清晰地展示每篇文章的发布和更新时间。

{% archiveList archives with type="list" limit="10" %}
    {% for item in archives %}
        <div class="article-item">
            <h2><a href="{{item.Link}}">{{item.Title}}</a></h2>
            <p class="article-meta">
                发布于：<time datetime="{{stampToDate(item.CreatedTime, "2006-01-02T15:04:05Z")}}">{{stampToDate(item.CreatedTime, "2006年01月02日")}}</time>
                {% if item.CreatedTime != item.UpdatedTime %} {# 仅在更新时间与发布时间不同时显示 #}
                <br>更新于：<time datetime="{{stampToDate(item.UpdatedTime, "2006-01-02T15:04:05Z")}}">{{stampToDate(item.UpdatedTime, "2006-01-02 15:04")}}</time>
                {% endif %}
            </p>
            <p>{{item.Description}}</p>
        </div>
    {% endfor %}
{% endarchiveList %}

在上面的例子中，CreatedTime 和 UpdatedTime 被格式化为易于阅读的中文日期和简洁的日期时间格式。同时，我们还利用了 HTML5 的 <time> 标签及其 datetime 属性，为搜索引擎和无障碍阅读提供机器可读的时间格式。

2. 在文章详情页显示详细时间信息：

在文章详情页面，您可能需要更精确或包含星期几的时间信息。

{% archiveDetail detail %}
    <article>
        <h1>{{detail.Title}}</h1>
        <p class="article-info">
            发布时间：{{stampToDate(detail.CreatedTime, "2006年01月02日 星期一 15:04:05")}}
        </p>
        {% if detail.CreatedTime != detail.UpdatedTime %}
        <p class="article-info">
            最近更新：{{stampToDate(detail.UpdatedTime, "2006年01月02日 星期一 15时04分")}}
        </p>
        {% endif %}
        <div class="article-content">
            {{detail.Content|safe}}
        </div>
    </article>
{% endarchiveDetail %}

这里，我们通过调整格式字符串，展示了包含“星期一”的更详细日期格式。

3. 格式化自定义时间戳变量：

如果您在模板中定义了或从其他地方获取了一个 Unix 时间戳变量，同样可以使用 stampToDate 进行格式化。

{% set eventTimestamp = 1678886400 %} {# 假设这是一个活动开始的Unix时间戳 #}
<p>活动开始：{{stampToDate(eventTimestamp, "2006.01.02 下午03:04")}}</p>

这个例子展示了如何格式化一个自定义变量，并且使用了不同的时间显示方式（下午03:04）。

小结

通过 stampToDate 标签，AnQiCMS 为模板开发者提供了强大且灵活的时间戳格式化能力。关键在于理解 Go 语言特有的“参考时间”格式化规则，并根据您的具体需求组合出相应的格式字符串。这使得将后台的原始时间数据呈现在用户友好的前端界面上变得轻而易举，从而提高了网站内容的易读性和用户体验。

常见问题 (FAQ)

  1. 为什么 stampToDate 的格式字符串看起来这么奇怪，例如 “2006-01-02” 而不是 “YYYY-MM-DD”？ 这主要是因为 AnQiCMS 的模板引擎基于 Go 语言开发，而 Go 语言在设计其日期时间格式化时，选择了一个固定的“参考时间” (2006-01-02 15:04:05 -0700 MST) 来代表日期和时间的各个组成部分。您需要将您想要显示的时间格式与这个参考时间进行匹配。例如，如果您想显示两位数的月份，就使用参考时间中的