查看“︁Template:Countdown/doc”︁的源代码

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

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

== 示例 ==
{| 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}}
|}

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