在网站运营中，时间信息的展示无处不在，无论是版权声明中的当前年份，文章发布的时间，还是活动截止的日期，动态且准确的时间显示对于提升用户体验和内容时效性都至关重要。作为一款致力于高效内容管理的企业级CMS，安企CMS（AnQiCMS）深知这一需求，因此在模板系统中提供了直观且强大的标签，让您能够轻松地在网站模板中实时显示当前年份或自定义格式的时间。

安企CMS的模板引擎设计上借鉴了Django的语法风格，通过简洁的标签标记实现各类动态内容的输出。对于时间显示，我们主要会用到两个核心标签：{% now %} 和 {{stampToDate()}}。

优雅显示当前年份：{% now %} 标签

在网站的页脚版权声明区域，我们经常会看到“Copyright © 2023 Your Company”这样的文字，其中的年份需要每年更新。手动修改显然不是一个高效的方案。安企CMS为此提供了一个极其方便的标签：{% now %}。

这个标签能够直接获取服务器当前的日期和时间，并根据您指定的格式输出。如果您仅仅需要显示当前的年份，只需简单地在模板中这样编写：

<footer>
    &copy; {% now "2006" %} {{ system.SiteName }} 版权所有。
</footer>

在这里，"2006" 是Golang中一个特殊的日期时间格式化字符串，它代表着年份的参考布局。当系统解析到 {% now "2006" %} 时，它会智能地将当前年份提取并替换到该位置。这样，您的网站版权年份每年都会自动更新，无需人工干预，大大提升了运营效率。

精准控制时间格式：{{stampToDate()}} 标签的魔法

如果您的需求不仅仅是简单的年份，而是更具体、更丰富的日期或时间格式，比如在文章详情页显示“2023年10月27日 14:35”，或者需要将数据库中存储的时间戳转换为可读的日期格式，那么安企CMS提供了功能更为强大的 {{stampToDate()}} 标签。

{{stampToDate()}} 标签是一个函数式的标签，它接收两个主要参数：第一个是要格式化的10位Unix时间戳，第二个是定义输出格式的字符串。其基本用法如下：

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

例如，假设您的文章数据对象 archive 中有一个 CreatedTime 字段，存储的是文章的创建时间戳，您希望以“年-月-日”的形式显示，可以这样实现：

<p>发布日期：{{ stampToDate(archive.CreatedTime, "2006-01-02") }}</p>

Golang 时间格式化字符串的秘密

这里需要特别强调的是，"2006-01-02" 这样的格式化字符串并不是一个随机的日期，而是Golang语言中约定俗成的参考布局。它指示了时间元素（年、月、日、时、分、秒等）在字符串中的位置。理解这个参考布局是灵活运用 stampToDate 的关键：

  • 2006: 代表年份（Year）
  • 01: 代表月份（Month），例如1月
  • 02: 代表日期（Day），例如2日
  • 15: 代表小时（Hour），24小时制，例如下午3点
  • 04: 代表分钟（Minute）
  • 05: 代表秒钟（Second）
  • Mon / Monday: 代表星期几的简称/全称
  • Jan / January: 代表月份的简称/全称

通过组合这些参考元素，您可以构建出几乎任何您想要的日期时间格式。

以下是一些常见的格式化示例：

  • 仅显示年份： {{ stampToDate(archive.CreatedTime, "2006") }} -> 2023
  • 显示年-月-日： {{ stampToDate(archive.CreatedTime, "2006-01-02") }} -> 2023-10-27
  • 显示年/月/日： {{ stampToDate(archive.CreatedTime, "2006/01/02") }} -> 2023/10/27
  • 显示中文年-月-日： {{ stampToDate(archive.CreatedTime, "2006年01月02日") }} -> 2023年10月27日
  • 显示时:分:秒： {{ stampToDate(archive.CreatedTime, "15:04:05") }} -> 14:35:01
  • 显示完整日期时间： {{ stampToDate(archive.CreatedTime, "2006-01-02 15:04:05") }} -> 2023-10-27 14:35:01
  • 显示带星期几的格式： {{ stampToDate(archive.CreatedTime, "Mon, 02 Jan 2006") }} -> Fri, 27 Oct 2023

通过这些灵活的格式化选项，您可以根据网站的设计风格和内容需求，精确控制时间信息的呈现方式。

实际应用场景与组合使用

在安企CMS中，这两个标签的应用场景非常广泛。

  • 网站页脚： 
    
<p>Copyright &copy; {% now "2006" %} {{ system.SiteName }}. All Rights Reserved.</p>
  • 文章或产品列表页： 在 archiveList 标签循环文章时，显示每篇文章的发布日期。 
    
{% archiveList archives with type="list" limit="10" %}
    {% for item in archives %}
    <div class="article-item">
        <h3><a href="{{item.Link}}">{{item.Title}}</a></h3>
        <p>发布时间：{{ stampToDate(item.CreatedTime, "2006年01月02日") }}</p>
        <p>{{item.Description}}</p>
    </div>
    {% endfor %}
{% endarchiveList %}
  • 自定义时间显示： 如果您在后台自定义了某个字段来存储一个活动的时间戳（例如 event.StartDate），同样可以使用 stampToDate 进行格式化。 
    
<p>活动开始：{{ stampToDate(event.StartDate, "2006年01月02日 星期一 15:04") }}</p>

无论是简单的年份标注，还是复杂的日期时间格式化，安企CMS都提供了直观且强大的模板标签来满足您的需求。通过灵活运用 {% now %} 和 {{stampToDate()}} 标签，您可以轻松地为网站内容增添时效性和专业性，从而提升整体的用户体验。

常见问题 (FAQ)

  1. Q: 为什么 Golang 的时间格式化字符串看起来像一个具体的日期（例如 “2006-01-02 15:04:05”），而不是像 PHP 或 Java 那样使用 “Y-m-d H:i:s” 这样的占位符？ A: 这是 Golang 语言设计上的一个独特之处。Golang 的时间格式化不是通过抽象的占位符来定义，而是使用一个特定的“参考时间”——即 2006年1月2日15点04分05秒 -0700 MST 来作为布局示例。您需要做的就是编写一个与您期望输出格式相匹配的字符串，其中包含这个参考时间中的相应数字或文字部分。系统会根据您的布局来解析并格式化实际的时间。例如，如果您想显示年份，