模板:Countdown：修订间差异

2025年8月21日 (四) 15:17的最新版本

模板描述

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格式
结果为整数，向下取整

@@ 第1行： / 第1行： @@
-<includeonly>
+<includeonly>{{#if: {{{1|}}}
-<!-- 正倒计时模板 -->
+   |{{#if: {{{utc|}}}
-<div class="countdown-container" style="border: 1px solid #ddd; padding: 15px; margin: 10px 0; border-radius: 5px; background: #f9f9f9;">
+     |{{#if: {{#pos:{{{1}}}|:}}
-  <h3 style="margin-top: 0; color: #0645ad;">{{#if: {{{title|}}}|{{{title}}}|倒计时}}</h3>
+       |{{#expr: floor( ({{#time: U}} - {{#time: U | {{{1}}} {{{utc}}} }}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
+      |{{#expr: floor( ({{#time: U}} - {{#time: U | {{{1}}} 00:00:00 {{{utc}}} }}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
-   {{#if: {{{date|}}}
+    }}
-     | {{#time: U | {{{date}}} }}
+    |{{#if: {{#pos:{{{1}}}|:}}
-       {{#ifexpr: {{#time: U | {{{date}}} }} > {{#time: U}}
+      |{{#expr: floor( ({{#time: U}} - {{#time: U | {{{1}}} }}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
-        | <!-- 未来日期 - 倒计时 -->
+      |{{#expr: floor( ({{#time: U}} - {{#time: U | {{{1}}} 00:00:00 }}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
-        <div style="text-align: center;">
+    }}
-          <div style="font-size: 1.5em; color: #d33; margin: 10px 0;">
-            距离{{{event|目标日期}}}
-          </div>
-          <div style="display: flex; justify-content: center; gap: 10px;">
-            <div style="background: #fff; padding: 10px; border-radius: 5px; min-width: 60px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">
-              <div style="font-size: 2em; font-weight: bold;">{{#expr: floor(({{#time: U | {{{date}}} }} - {{#time: U}}) / 86400) }}</div>
-              <div style="font-size: 0.9em;">天</div>
-            </div>
-          </div>
-          <div style="margin-top: 10px; color: #666; font-size: 0.9em;">
-            目标日期: {{#time: Y年m月d日 | {{{date}}} }}
-          </div>
-        </div>
-        | <!-- 过去日期 - 正计时 -->
-        <div style="text-align: center;">
-          <div style="font-size: 1.5em; color: #14866d; margin: 10px 0;">
-            {{{event|目标日期}}}已过去：
-          </div>
-          <div style="display: flex; justify-content: center; gap: 10px;">
-            <div style="background: #fff; padding: 10px; border-radius: 5px; min-width: 60px; box-shadow: 0 2px 4px rgba(0,0,0,0.1);">
-              <div style="font-size: 2em; font-weight: bold;">{{#expr: floor(({{#time: U}} - {{#time: U | {{{date}}} }}) / 86400) }}</div>
-              <div style="font-size: 0.9em;">天</div>
-            </div>
-          </div>
-          <div style="margin-top: 10px; color: #666; font-size: 0.9em;">
-            起始日期: {{#time: Y年m月d日 | {{{date}}} }}
-          </div>
-        </div>
-      }}
-    | <div style="color: #d33; text-align: center;">错误：未提供日期参数</div>
    }}
+   |错误：未提供日期参数
-  {{#if: {{{update|}}}
+}}</includeonly>
-    | <div style="margin-top: 10px; font-size: 0.8em; color: #666; text-align: center;">
-        最后更新: {{#time:Y-m-d H:i|{{{update}}}}}
-      </div>
-  }}
-</div>
-</includeonly>
 <noinclude>
-== 倒计时/正计时模板 ==
-用于显示距离某个日期的倒计时或已过去的时间。
+== 模板描述 ==
+'''Countdown''' - 计算指定日期与当前时间的时间差，可自定义输出格式。
 === 使用方法 ===
 <pre>
-{{Countdown
+{{Countdown|目标日期|utc=时区|time=精度|text=后缀文本}}
-|date = 目标日期 (YYYY-MM-DD格式)
-|title = 可选标题 (默认为"倒计时")
-|event = 事件名称 (默认为"目标日期")
-|update = 最后更新时间 (可选)
-}}
 </pre>
+=== 参数说明 ===
+; 1 (必需)
+: 目标日期，格式为YYYY-MM-DD或YYYY-MM-DD HH:MM:SS
+; utc (可选)
+: 时区偏移，例如+8表示UTC+8，-5表示UTC-5
+; time (可选)
+: 时间精度，可选值：day(天)、hour(小时)、minute(分钟)、second(秒)，默认为day
+; text (可选)
+: 显示在数字后面的后缀文本
 === 示例 ===
 <pre>
-{{Countdown
+{{Countdown|2023-12-31}} → 输出距离2023年12月31日的天数
-|date = 2023-12-31
+{{Countdown|2023-12-31|utc=+8}} → 使用UTC+8时区计算天数
-|title = 新年倒计时
+{{Countdown|2023-12-31|time=hour}} → 输出小时差
-|event = 元旦
+{{Countdown|2023-12-31 12:30:45|time=minute}} → 输出分钟差
-}}
+{{Countdown|2025-8-21|text=天了}} → 输出"X天了"
 </pre>
+=== 典型应用场景 ===
+* 显示距离某个重要日期的倒计时
+* 计算文章/页面的存在时间
+* 显示活动剩余时间
+* 记录项目持续时间
+=== 注意事项 ===
+* 日期格式必须正确，否则会报错
+* 时区参数需符合±HH格式
+* 结果为整数，向下取整
 [[Category:时间模板]]
 </noinclude>