Template:Countdown/doc：修订间差异

2026年5月3日 (日) 15:27的版本

Template:Intricate template 本模板用以实时显示特定时间与现在的差距。相比于传统模板，本模板基于 JavaScript 实现，无需刷新页面即可看到秒级跳动，且不会因服务器缓存导致计时错误。

参数

time / 匿名参数 1: （只可使用其中一个）指定目标时间。支持 ISO 格式（如 2013-10-04）、带时区的格式（+09:00）或仅年份。
before: 当目标时间早于现在时（过去）显示的文本格式。使用 $1 作为时间差的占位符。默认为 $1前。
after: 当目标时间晚于现在时（未来）显示的文本格式。使用 $1 作为时间差的占位符。默认为 还剩$1。

示例

代码	效果
`{{Countdown\|time=2013-10-04 20:42+09:00\|before=在$1之前\|after=将在$1后}}`	...
`{{Countdown\|2027-06-25T18+09}}`	...
`{{Countdown\|time={{LOCALYEAR}}\|before=新年已过去$1}}`	...
`{{Countdown\|time={{#expr:{{LOCALYEAR}}+1}}\|after=今年还有$1}}`	...

注意事项

本模板使用客户端时间。如果用户的系统时间不准确，倒计时显示也会随之偏差。
页面在后台运行（如切换标签页）时会暂停计算以节省 CPU，切回页面时会自动校准。

@@ 第1行： / 第1行： @@
-本模板用以显示特定时间与现在的差距
+{{Intricate template}}
-==参数==
+本模板用以实时显示特定时间与现在的差距。相比于传统模板，本模板基于 JavaScript 实现，无需刷新页面即可看到秒级跳动，且不会因服务器缓存导致计时错误。
-;time
-;匿名参数 1
-:（只可使用其中一个）指定目标时间，可以参照下方示例中的说明填写。
-;before
-:指定目标时间比现在早时的格式，默认为 <code>$1前</code>（<code>$1</code>代指目标时间差值，下同，见[[#示例]]）。
-;after
-:指定目标时间比现在晚时的格式，默认为 <code>还剩$1</code>。
-==示例==
-;代码
-<pre>迪亚马特彗星分裂出的一部分{{Countdown|time=2013-10-04 20:42+09:00|before=在$1之前|after=将在$1后}}坠落于糸守町，摧毁了该城镇。<small>——可以在时刻后指定时区，若写Z则代表UTC时间，即0时区</small>
-{{Countdown|2027-06-25T18+09}}，一行瑠璃就接受了坚书直实的表白。<small>——空格和T都可以分隔日期与时间；时间是整点时，可以省略后续部分</small>
+== 参数 ==
+; time / 匿名参数 1
+: （只可使用其中一个）指定目标时间。支持 ISO 格式（如 2013-10-04）、带时区的格式（+09:00）或仅年份。
+; before
+: 当目标时间'''早于'''现在时（过去）显示的文本格式。使用 <code>$1</code> 作为时间差的占位符。默认为 <code>$1前</code>。
+; after
+: 当目标时间'''晚于'''现在时（未来）显示的文本格式。使用 <code>$1</code> 作为时间差的占位符。默认为 <code>还剩$1</code>。
-{{Countdown|time={{LOCALYEAR}}|before=你醒啦，新年已经结束啦}}<small>——甚至可以只填年份，就会默认为该年1月1日零时整。这里使用系统变量魔术字提供了今年的年份</small>
+== 示例 ==
+{| class="wikitable"
+! 代码 !! 效果
+|-
+| <code><nowiki>{{Countdown|time=2013-10-04 20:42+09:00|before=在$1之前|after=将在$1后}}</nowiki></code>
+| {{Countdown|time=2013-10-04 20:42+09:00|before=在$1之前|after=将在$1后}}
+|-
+| <code><nowiki>{{Countdown|2027-06-25T18+09}}</nowiki></code>
+| {{Countdown|2027-06-25T18+09}}
+|-
+| <code><nowiki>{{Countdown|time={{LOCALYEAR}}|before=新年已过去$1}}</nowiki></code>
+| {{Countdown|time={{LOCALYEAR}}|before=新年已过去$1}}
+|-
+| <code><nowiki>{{Countdown|time={{#expr:{{LOCALYEAR}}+1}}|after=今年还有$1}}</nowiki></code>
+| {{Countdown|time={{#expr:{{LOCALYEAR}}+1}}|after=今年还有$1}}
+|}
-{{Countdown|time={{#expr:{{LOCALYEAR}}+1}}|after=今年还有$1}}，尚待{{ruby|体验|浪费}}<small>——这里是使用解析器函数计算出了明年的年份</small></pre>
+== 注意事项 ==
-;结果
+* 本模板使用客户端时间。如果用户的系统时间不准确，倒计时显示也会随之偏差。
-迪亚马特彗星分裂出的一部分{{Countdown|time=2013-10-04 20:42+09:00|before=在$1之前|after=将在$1后}}坠落于糸守町，摧毁了该城镇。<small>——可以在时刻后指定时区，若写Z则代表UTC时间，即0时区</small>
+* 页面在后台运行（如切换标签页）时会暂停计算以节省 CPU，切回页面时会自动校准。
-{{Countdown|2027-06-25T18+09}}，一行瑠璃就接受了坚书直实的表白。<small>——空格和T都可以分隔日期与时间；时间是整点时，可以省略后续部分</small>
-{{Countdown|time={{LOCALYEAR}}|before=你醒啦，新年已经结束啦}}<small>——甚至可以只填年份，就会默认为该年1月1日零时整。这里使用系统变量魔术字提供了今年的年份</small>
-{{Countdown|time={{#expr:{{LOCALYEAR}}+1}}|after=今年还有$1}}，尚待{{ruby|体验|浪费}}<small>——这里是使用解析器函数计算出了明年的年份</small>