在网站运营的日常工作中，我们经常需要将日期和时间信息以用户友好的方式展示出来。尤其是在面对不同地域的用户时，能够输出符合当地习惯的日期时间格式，也就是我们常说的“国际化格式输出”，就显得尤为重要。今天，我们就来聊聊安企CMS（AnQiCMS）中一个常用的过滤器 stringformat，看看它在日期时间对象的处理上，是否支持这种自定义的国际化格式输出。

深入了解 stringformat 过滤器

首先，让我们回顾一下 stringformat 过滤器的核心功能。根据安企CMS的文档描述，stringformat 过滤器主要用于将数字、字符串、数组等任意值，按照指定的格式格式化成字符串输出。它的用法类似于Go语言中的 fmt.Sprintf() 函数，能够让我们对不同类型的数据进行灵活的文本组合和格式化。例如，我们可以用它来控制浮点数的小数位数，或者将数字嵌入到一段文本中：

{{ 3.141592653|stringformat:"%.2f" }}  {# 输出 3.14 #}
{{ 888|stringformat:"库存数量：%d" }}  {# 输出 库存数量：888 #}

通过这些例子不难发现，stringformat 过滤器在通用数据格式化方面表现出色。然而，当我们谈论到日期时间对象时，情况就有所不同了。在安企CMS的模板系统中，日期时间对象（无论是Unix时间戳还是Go语言原生的 time.Time 类型）的格式化，通常由专门的标签或过滤器来处理，而非 stringformat。stringformat 的设计初衷更多是针对通用数据类型的字符串转换，它本身并不包含对日期时间格式化所需的特定逻辑，例如解析日期组成部分（年、月、日、时、分、秒）并根据特定布局字符串进行输出的能力。

安企CMS 中日期时间格式化的专门工具

在安企CMS中，处理日期时间格式输出，我们主要依赖两个强大的工具：stampToDate 标签和 date 过滤器。

  • stampToDate 标签：这个标签专门用于格式化10位Unix时间戳。它要求传入一个时间戳和一个符合Go语言标准的时间布局字符串。例如，如果你有一个 CreatedTime 字段存储的是时间戳：

    {# 格式化为 年-月-日 #}
{{ stampToDate(item.CreatedTime, "2006-01-02") }} {# 例如输出 2023-10-27 #}


{# 格式化为 年-月-日 时:分:秒 #}
{{ stampToDate(item.CreatedTime, "2006-01-02 15:04:05") }} {# 例如输出 2023-10-27 10:30:00 #}

    这里的 "2006-01-02" 并不是字面意义上的日期，而是Go语言中定义的一种特定布局（Layout）模板，代表了“年-月-日”的格式。

  • date 过滤器：与 stampToDate 类似，date 过滤器也用于日期时间格式化，但它期望的输入是一个 time.Time 类型的对象（而非时间戳）。它的用法与 stampToDate 几乎一致，同样使用Go语言的时间布局字符串：

    {# 假设 someTimeVariable 是一个 time.Time 对象 #}
{{ someTimeVariable|date:"Jan 02, 2006" }} {# 例如输出 Oct 27, 2023 #}

无论是 stampToDate 还是 date 过滤器，它们都提供了强大的自定义格式输出能力，但这种“自定义”是基于Go语言预设的布局字符串，即你必须明确指定“年”用什么表示、“月”用什么表示等等。

国际化格式输出的考量

现在回到“国际化格式输出”这个核心问题。安企CMS在内容层面提供了多语言支持，你可以设置网站的默认语言包，甚至通过 languages 标签获取不同语言站点的链接，并通过 tr 标签翻译模板中的文本。然而，就日期时间格式化而言，stampToDate 和 date 过滤器本身并没有内置自动识别当前用户语言环境并输出相应日期格式的功能。

这意味着，如果你想实现针对不同语言环境的日期格式输出（例如，中文用户看到 2023年10月27日，英文用户看到 October 27, 2023，德文用户看到 27. Oktober 2023），仅仅依靠 stampToDate 或 date 标签直接传入一个通用的格式是无法实现的。你传入的布局字符串 "2006年01月02日" 永远会输出带有中文“年”、“月”、“日”的格式，无论用户当前使用的是什么语言环境。

实现国际化日期格式的思路

要实现日期时间的国际化格式输出，我们通常需要结合安企CMS的其他功能，通过模板逻辑进行判断和处理：

  1. 获取当前语言环境：你可以通过 {% system with name='Language' %} 标签获取当前站点的语言代码（例如 zh-CN, en-US, de 等）。

  2. 条件判断应用不同布局：在模板中，根据获取到的语言代码，使用 {% if %} 逻辑来选择不同的Go语言日期布局字符串，传递给 stampToDate 或 date 标签。

    {% set currentLang = system.Language %} {# 假设system.Language能获取到当前语言代码，具体字段需查阅系统标签 #}
{% set myTimestamp = archive.CreatedTime %} {# 假设从archive获取时间戳 #}


{% if currentLang == "zh-CN" %}
    {{ stampToDate(myTimestamp, "2006年01月02日") }}
{% elif currentLang == "en-US" %}
    {{ stampToDate(myTimestamp, "January 02, 2006") }}
{% elif currentLang == "de" %}
    {{ stampToDate(myTimestamp, "02. Januar 2006") }}
{% else %}
    {# 默认或备用格式 #}
    {{ stampToDate(myTimestamp, "2006-01-02") }}
{% endif %}

这种方法虽然需要一些手动配置，但在安企CMS当前的功能体系下，是实现日期时间国际化格式输出的有效途径。

总结

stringformat 过滤器在安企CMS中，是一个通用的字符串格式化工具，它不直接支持日期时间对象的格式化，更不具备自动国际化日期格式的功能。对于日期时间对象的处理，我们应该使用专门的 stampToDate 标签（针对时间戳）或 date 过滤器（针对 time.Time 对象），并传入Go语言标准的时间布局字符串。要实现日期时间的国际化格式输出，则需要在模板中结合语言环境判断，手动应用不同的日期布局字符串。

常见问题 (FAQ)

1. stringformat 过滤器和 stampToDate 标签有什么核心区别？

stringformat 过滤器是通用型的字符串格式化工具，适用于数字、字符串、数组等多种数据类型，采用 fmt.Sprintf() 风格的格式定义。而 stampToDate 标签是专门为Unix时间戳设计的，用于将其转换为特定布局的日期时间字符串，其格式定义遵循Go语言的时间布局规则。简单来说，stringformat 不懂日期，stampToDate 才是日期处理的专家。

2. 安企CMS 能不能让日期格式根据访客的浏览器语言自动切换？

安企CMS的内置日期时间格式化标签（如 stampToDate 和 date）目前不直接支持根据访客的浏览器语言自动调整日期格式。它们依赖于模板中硬编码的Go语言布局字符串。要实现这种动态切换，你需要在模板中编写条件判断逻辑，获取当前页面或用户设定的语言环境（例如通过 system 标签），然后根据语言代码手动选择并应用相应的日期格式布局。

3. Go 语言的时间格式化布局（Layout）字符串感觉不太直观，有没有更方便记忆的方法？

Go语言的时间布局确实比较特殊，它不是使用常见的 YYYY-MM-DD 这样的占位符，而是使用一个固定的参考时间 2006年01月02日 15时04分05秒 -0700 MST 来定义布局。虽然初学时可能觉得不便，但记住这个参考时间中的每个数字和符号所代表的含义（例如 2006 代表年，`