Is there an easy way to check if the input timestamp for `stampToDate` is valid in the Anqi CMS template?

As a senior website operations expert, I know that the accuracy and display format of timestamps in content management systems like AnQiCMS are crucial for user experience and data presentation.stampToDateThis powerful label function is undoubtedly a good helper for us to handle time information in templates.However, like any tool, it also requires us to use and understand its input requirements correctly.

Today, let's delve into a problem that everyone might encounter in the development of AnQi CMS templates:Is there a simple method to check in AnQi CMS templates?stampToDateThe input timestamp is valid?

stampToDateThe expectation: the secret of 10-digit Unix timestamp

Let's review the Security CMS document firststampToDateThe label description. The document explicitly states:{{stampToDate(时间戳, "格式")}}。时间戳为10位的时间，如 1609470335，格式为Golang支持的格式。.

The key information here is "Timestamp with 10 digitsEnglishThis refers to the standard Unix timestamp, which is the number of seconds from 00:00:00 UTC/GMT on January 1, 1970, to the present.stampToDateIt may not yield the expected results when processed, ranging from blank displays to severe page parsing exceptions.

Then, in the template environment, do we have a way to perform strict input validation as we do in backend code? The answer is: although the template engine itself is designed for data display rather than complex data validation, we can take advantage of the 'detective toolbox' it provides - that is, the built-in filters and logical judgments (ifLabel），to perform some practical, template-level “legality” checks.

The “detective toolkit” of templates: clever use of filters andifJudgment

The template engine of AnQi CMS is similar to Django syntax, providing rich filters and logical control tags, which makes it possible for us to indirectly check the legality of timestamps. Here, we will mainly use the following "detective tools":

1. ifLogical judgment tag:This is the basis for any conditional judgment.
2. stringformatFilter:It can format variables into strings, making it convenient for us to perform string operations.
3. lengthFilter:Used to get the length of a string.
4. integerFilter:Try to convert the input to an integer.

With these tools, we can combine a simple method to check the 'legality' of timestamps.

Practical template hierarchy checking method

Our goal is to ensure that the inputstampToDatea variable:

1. is a number (at least it looks like a number).
2. and its string length is 10 digits.

Below, I will show you several degrees of inspection methods, as well as a comprehensive, more robust inspection logic:

1. The most basic check: does it exist and is not empty

This is the simplest judgment, just make sure the timestamp variable has a value:

{% if item.CreatedTime %}
    {# 存在时间戳，但未校验格式，可直接使用或继续深层校验 #}
    {{ stampToDate(item.CreatedTime, "2006-01-02") }}
{% else %}
    {# 时间戳不存在或为空 #}
    <span>发布时间未知</span>
{% endif %}

This method is only suitable when you are very sure about the backend providedCreatedTimeField must be a valid timestamp, it cannot recognize incorrect format or length.

2. Length check for '10 digits'

This is the closeststampToDateSpecific requirements check. We need to convert the timestamp to a string and then check its length.

{% set timestamp_str = item.CreatedTime|stringformat:"%v" %} {# 将时间戳转换为字符串 #}
{% if timestamp_str|length == 10 %}
    {# 长度为10，基本符合要求 #}
    {{ stampToDate(item.CreatedTime, "2006-01-02 15:04") }}
{% else %}
    {# 长度不符，可能不是有效的10位时间戳 #}
    <span>无效时间格式</span>
{% endif %}

Here,stringformat:"%v"Attempts to convert any type of variable to its string representation. For example, ifitem.CreatedTimeis a number1609470335It will become a string."1609470335"；如果是EnglishnilOr empty, it may become.""or"0"Its length will naturally not be 10.

3. Validity and non-negative check of numbers

Although it does not directly check the length, we can ensure that it is at least a positive integer. Unix timestamps are typically not negative or zero (unless in the very early dates).

{% set timestamp_val = item.CreatedTime|integer %} {# 尝试转换为整数 #}
{% if timestamp_val > 0 %}
    {# 转换成功且为正数，可视为有效时间戳，但长度仍需校验 #}
    {{ stampToDate(item.CreatedTime, "2006-01-02") }}
{% else %}
    {# 非数字或负数/零 #}
    <span>日期不合法</span>
{% endif %}

Please note,integerThe filter will convert unconvertible strings (such as "abc") to0.timestamp_val > 0which can help us exclude non-numeric or invalid input.

4. Comprehensive Check: More robust legality judgment

The method described above can be combined to create a more robust template hierarchy check, to ensure as much as possiblestampToDateThe timestamp received is as expected:

{% set raw_timestamp = item.CreatedTime %}
{% set timestamp_as_integer = raw_timestamp|integer %}
{% set timestamp_as_string = raw_timestamp|stringformat:"%v" %}

{% if timestamp_as_integer > 0 and timestamp_as_string|length == 10 %}
    {# 既是有效的正整数，又是10位长度的字符串，认为是合法时间戳 #}
    <span>发布日期：{{ stampToDate(raw_timestamp, "2006年01月02日 15:04") }}</span>
{% else %}
    {# 不符合有效时间戳的条件 #}
    <span>发布日期格式错误或缺失</span>
    {# 您也可以选择在这里显示一个默认日期，或者隐藏该信息 #}
    {# <span>发布日期：待定</span> #}
{% endif %}

This comprehensive check passes through two layers of logic filtering, which can effectively handle null values, non-numeric strings, and cases where the length does not meet 10 digits, thereby greatly improvingstampToDatethe reliability of tags.

**Practice: Controlling Data Quality from the Source

Although we can perform these 'detective-style' checks in the template, as a website operations expert, what I want to emphasize more is:The best verification always occurs at the source of the data.

This means that during content entry, data interface reception, or backend logic processing, the format and validity of the timestamp should be strictly verified to ensure that the data stored in the database or passed to the template is always clean and accurate.Templates are more of a 'defensive programming' check, meant to handle a few unexpected cases rather than as a primary validation method.

Summary

Anqi CMS'sstampToDateLabel is a very practical time formatting tool, it explicitly expects a 10-digit Unix timestamp. Although the template engine does not have a directis_timestamp_valid()function, but by cleverly combiningifLogical judgment,stringformat/length