`prevArchive`标签如何获取上一篇文档的发布（`CreatedTime`）或更新时间（`UpdatedTime`）？

妙用 prevArchive 标签：深入挖掘安企CMS上一篇文档的时间奥秘

作为一名资深的网站运营专家，我深知内容的时效性和更新频率对于网站的SEO表现和用户体验至关重要。在安企CMS（AnQiCMS）中，我们经常需要在文章详情页提供“上一篇”和“下一篇”的导航，这不仅方便用户浏览，更是构建内部链接、提升页面权重的好方法。今天，我们就来深入探讨 prevArchive 标签，特别是如何灵活地获取上一篇文档的发布（CreatedTime）或更新时间（UpdatedTime），并将其以易读的格式呈现在您的网站上。

在安企CMS中，prevArchive 标签是一个非常实用的工具，它允许您在当前文档的上下文环境中，轻松地获取到排在它之前的文档数据。它的使用方式简洁明了，通常您只需在模板中声明一个变量即可，例如 {% prevArchive prev %}。这个 prev 变量随后便会承载上一篇文档的各种信息，包括文档ID、标题、链接等。

然而，不同于直接展示文档标题或链接，时间信息在 prevArchive 标签中是以原始的 Unix 时间戳（timestamp）形式提供的，具体通过 prev.CreatedTime 和 prev.UpdatedTime 这两个字段获取。这些时间戳是自1970年1月1日00:00:00 UTC以来经过的秒数，对于普通用户而言，这样的数字序列是难以理解的。

为了将这些原始的时间戳转化为我们日常可读的日期格式，安企CMS提供了一个非常便捷的内置功能——stampToDate 标签。这个标签专门用于格式化时间戳，它需要两个参数：第一个是您要格式化的时间戳，第二个是您期望输出的日期时间格式。值得一提的是，安企CMS的时间格式化遵循Go语言的独特规则，即使用一个固定的参考日期 2006-01-02 15:04:05 来定义格式。这意味着，如果您想显示“年-月-日”，您就输入 2006-01-02；如果您想显示“时:分”，您就输入 15:04，以此类推。

现在，让我们通过几个实际的例子来演示如何获取并格式化上一篇文档的发布或更新时间。

假设我们希望在文章详情页底部，展示上一篇文章的标题及其发布日期，我们可以这样编写模板代码：

{% prevArchive prev %}
  {% if prev %}
    <p>上一篇：
      <a href="{{ prev.Link }}">{{ prev.Title }}</a>
      （发布于：{{ stampToDate(prev.CreatedTime, "2006年01月02日") }}）
    </p>
  {% else %}
    <p>没有更早的文章了。</p>
  {% endif %}
{% endprevArchive %}

在这段代码中，我们首先使用 {% prevArchive prev %} 来获取上一篇文档。接着，通过 {% if prev %} 判断是否存在上一篇文档，避免在没有上一篇时显示错误。核心部分在于 {{ stampToDate(prev.CreatedTime, "2006年01月02日") }}，这里我们将 prev.CreatedTime （上一篇文档的发布时间戳）传入 stampToDate，并指定了格式为 “2006年01月02日”，从而使其显示为“XXXX年XX月XX日”的形式。

如果您更关注文档的最新更新动态，希望显示上一篇文档的更新时间，只需将 CreatedTime 替换为 UpdatedTime，并可根据需要调整格式，例如显示为包含具体时间的格式：

{% prevArchive prev %}
  {% if prev %}
    <p>上一篇：
      <a href="{{ prev.Link }}">{{ prev.Title }}</a>
      （最后更新：{{ stampToDate(prev.UpdatedTime, "2006-01-02 15:04:05") }}）
    </p>
  {% else %}
    <p>没有更早的文章了。</p>
  {% endif %}
{% endprevArchive %}

这样，您的用户就能一目了然地看到上一篇文档的详细发布或更新时间，这对于判断内容的鲜活度，或是寻找最新的相关信息都非常有帮助。在内容运营策略中，清晰地展示时间信息，不仅能增强网站内容的权威性，也能间接鼓励用户探索更多更新的内容，提升整体的用户粘性。

总而言之，安企CMS的 prevArchive 标签结合 stampToDate 格式化功能，为您提供了灵活且强大的方式来处理和展示上一篇文档的时间信息。无论是精确到秒的更新时间，还是简洁明了的发布日期，都能通过简单的模板代码实现，让您的网站内容运营更加精细化。

常见问题（FAQ）

Q1: nextArchive 标签是否也支持以同样的方式获取下一篇文档的发布或更新时间？ A1: 是的，nextArchive 标签与 prevArchive 标签的功能和用法非常相似。您可以通过 {% nextArchive next %} 来获取下一篇文档的数据，然后同样利用 next.CreatedTime 和 next.UpdatedTime 字段，并结合 stampToDate 标签进行格式化，例如 {{ stampToDate(next.CreatedTime, "2006-01-02") }}。

Q2: 如果当前文档是该分类下的第一篇，那么 prevArchive 标签会返回什么？我该如何处理这种情况？ A2: 如果当前文档是其所在分类下的第一篇文章，即没有“上一篇”文档，那么 prevArchive 标签定义的变量（例如 prev）将会是空的。为了避免模板渲染错误，您应该始终使用条件判断（例如 {% if prev %} … {% else %} … {% endif %}）来检查上一篇文档是否存在，再进行内容的展示，就像我们在文章示例中做的那样。

Q3: 除了发布或更新时间，我还能通过 prevArchive 标签获取上一篇文档的其他哪些信息？ A3: prevArchive 标签能提供上一篇文档的多种信息，以便您在模板中灵活使用。除了 CreatedTime 和 UpdatedTime，它还支持获取文档ID (Id)、标题 (Title)、链接 (Link)、关键词 (Keywords)、描述 (Description)、分类ID (CategoryId)、浏览量 (Views)、封面首图 (Logo)、封面缩略图 (Thumb)、评论数量 (CommentCount) 等。您可以根据实际需求，通过 prev.字段名 的形式调用这些数据。