模板:Countdown

<templatedata> {

 "description": "计算指定日期与当前时间的时间差，可自定义输出格式。",
 "params": {
   "1": {
     "label": "目标日期",
     "description": "目标日期，格式为YYYY-MM-DD或YYYY-MM-DD HH:MM:SS",
     "type": "string",
     "required": true
   },
   "utc": {
     "label": "时区",
     "description": "时区偏移，例如+8表示UTC+8，-5表示UTC-5",
     "type": "string",
     "required": false
   },
   "time": {
     "label": "精度",
     "description": "时间精度，可选值：day(天)、hour(小时)、minute(分钟)、second(秒)，默认为day",
     "type": "string",
     "required": false,
     "default": "day"
   },
   "text": {
     "label": "后缀文本",
     "description": "显示在数字后面的后缀文本",
     "type": "string",
     "required": false
   }
 },
 "paramOrder": ["1", "utc", "time", "text"]

} </templatedata>

模板描述

Countdown - 计算指定日期与当前时间的时间差，可自定义输出格式。

使用方法

{{Countdown|目标日期|utc=时区|time=精度|text=后缀文本}}

参数说明

1 (必需)

目标日期，格式为YYYY-MM-DD或YYYY-MM-DD HH:MM:SS

utc (可选)

时区偏移，例如+8表示UTC+8，-5表示UTC-5

time (可选)

时间精度，可选值：day(天)、hour(小时)、minute(分钟)、second(秒)，默认为day

text (可选)

显示在数字后面的后缀文本

示例

{{Countdown|2023-12-31}} → 输出距离2023年12月31日的天数
{{Countdown|2023-12-31|utc=+8}} → 使用UTC+8时区计算天数
{{Countdown|2023-12-31|time=hour}} → 输出小时差
{{Countdown|2023-12-31 12:30:45|time=minute}} → 输出分钟差
{{Countdown|2025-8-21|text=天了}} → 输出"X天了"

典型应用场景

• 显示距离某个重要日期的倒计时
• 计算文章/页面的存在时间
• 显示活动剩余时间
• 记录项目持续时间

注意事项

• 日期格式必须正确，否则会报错
• 时区参数需符合±HH格式
• 结果为整数，向下取整