在网站运营过程中，有效展示内容发布或更新的时间，对于提升用户体验和内容的可读性至关重要。如果时间信息以原始的时间戳形式呈现，对普通用户来说往往难以理解。AnQiCMS 提供了一套直观而灵活的方式，帮助您将这些数字化的时间戳转换为易于阅读的日期和时间格式。

AnQiCMS 如何处理时间戳

AnQiCMS 在存储内容的时间信息时，通常会采用标准的时间戳（Unix Timestamp）格式。这种格式是一个 10 位或 13 位的整数，代表从 1970 年 1 月 1 日 00:00:00 UTC 到现在所经过的秒数或毫秒数。虽然机器处理起来效率很高，但直接展示给用户显然不够友好。

为了解决这个问题，AnQiCMS 的模板引擎内置了一个强大的标签，允许您在前端页面上轻松地格式化这些时间戳。

核心功能：stampToDate 标签

AnQiCMS 提供了 stampToDate 标签，专门用于将时间戳转换为可读的日期时间格式。这个标签的用法非常简洁：

{{stampToDate(时间戳变量, "格式化字符串")}}

这里的关键在于第二个参数——“格式化字符串”。由于 AnQiCMS 的模板引擎是基于 Go 语言的，其时间格式化遵循 Go 语言独有的参考时间。这个参考时间并不是我们平时习惯的 YYYY-MM-DD 这样的占位符，而是特定的日期 2006年01月02日 15时04分05秒。您需要将您希望显示的时间格式，按照这个参考日期中的年月日时分秒位置进行替换。

例如，如果您想显示：

  • 年份：使用 2006
  • 月份：使用 01
  • 日期：使用 02
  • 小时（24小时制）：使用 15
  • 分钟：使用 04
  • 秒钟：使用 05

实际应用场景举例

了解了格式化规则后，我们来看看如何在实际的模板中应用 stampToDate 标签。

  1. 展示文章的发布和更新时间

    在 AnQiCMS 中，文章的 CreatedTime（创建时间）和 UpdatedTime（更新时间）都是以时间戳形式存储的。假设您正在编写一个文章详情页或列表页，需要展示这些时间。

    • 仅显示日期（例如：2023-01-15）

      {# 假设 item 是当前文章对象 #}
发布日期：{{stampToDate(item.CreatedTime, "2006-01-02")}}
更新日期：{{stampToDate(item.UpdatedTime, "2006-01-02")}}

    • 显示完整日期和时间（例如：2023-01-15 10:30:45）

      发布时间：{{stampToDate(item.CreatedTime, "2006-01-02 15:04:05")}}
更新时间：{{stampToDate(item.UpdatedTime, "2006-01-02 15:04:05")}}

    • 自定义中文格式（例如：2023年01月15日）

      发布日期：{{stampToDate(item.CreatedTime, "2006年01月02日")}}

  2. 显示评论的发布时间

    评论系统中的 CreatedTime 同样是时间戳，也可以用相同的方式格式化：

    评论时间：{{stampToDate(comment.CreatedTime, "2006-01-02 15:04")}}

  3. 获取并格式化当前服务器时间

    除了格式化存储在数据库中的时间戳，如果您需要获取并显示当前的服务器时间，AnQiCMS 也提供了 {% now "格式化字符串" %} 标签。它的格式化规则与 stampToDate 中的“格式化字符串”完全一致。

    当前时间：{% now "2006年01月02日 15:04:05" %}

注意事项与技巧

  • 时间戳的精确性： stampToDate 标签默认期望接收一个 10 位的 Unix 时间戳（秒级）。如果您的时间戳是 13 位的（毫秒级），通常需要先将其除以 1000 转换为秒级，或者 AnQiCMS 后台的数据处理层面已经做了适配。
  • Go 语言的格式化规则是核心： 这是最容易混淆的地方。请务必记住 2006-01-02 15:04:05 这个参考日期，然后根据您需要的输出格式，替换对应的数字。例如，如果您想显示 MM/DD/YYYY，就写成 01/02/2006。
  • 与 date 过滤器的区别： AnQiCMS 的模板中还有一个 date 过滤器（例如 {{ someDate|date:"2006-01-02" }}），但它通常用于已经解析成 Go 语言 time.Time 结构体的日期对象，而不是原始的时间戳。在处理从数据库直接取出的时间戳时，stampToDate 是更便捷的选择。

通过 stampToDate 标签，AnQiCMS 让网站的时间展示变得清晰、灵活，大大提升了您内容管理的效率和用户阅读的体验。

常见问题 (FAQ)

Q1: 我想显示“5分钟前”这样的相对时间，AnQiCMS 的 stampToDate 标签能做到吗？ A1: stampToDate 标签主要用于将时间戳格式化为具体的日期时间字符串，例如“2023-01-15 10:30”。如果您需要显示“5分钟前”这样的相对时间，AnQiCMS 的模板标签目前没有直接提供此功能。您通常需要通过前端 JavaScript 库（如 moment.js 或 day.js）来计算并动态显示相对时间，或者在 AnQiCMS 的后端进行二次开发来实现。

Q2: 如果我的时间戳是 13 位的（毫秒级），stampToDate 标签还能用吗？ A2: stampToDate 标签默认预期接收 10 位的秒级 Unix 时间戳。如果您的时间戳是 13 位的毫秒级，直接使用可能会导致日期不正确。在这种情况下，您需要确保在数据传递给模板之前，将 13 位时间戳除以 1000 转换为 10 位秒级时间戳。通常 AnQiCMS 在内部处理时会进行适配，但如果遇到问题，检查时间戳的位数是排查方向之一。

Q3: Go 语言的时间格式化字符串为什么是 2006-01-02 15:04:05，而不是像 Y-m-d H:i:s 这样的占位符？ A3: Go 语言采用了一种非常独特且直观的时间格式化方式：它提供了一个固定的参考时间 (2006年01月02日 15时04分05秒)。您只需要将希望输出的时间格式，按照这个参考日期中的数字和符号位置进行替换即可。例如，如果想显示四位年份，就写 2006；如果想显示两位月份，就写 01。这种方式避免了记忆大量不同占位符的复杂性，通过一个具体的日期模板来定义所有可能的格式。