https://osm.bio/index.php?action=history&feed=atom&title=%E6%A8%A1%E6%9D%BF%3ACountdownFuture
模板:CountdownFuture - 版本历史
2026-05-01T22:37:06Z
本wiki上该页面的版本历史
MediaWiki 1.45.1
https://osm.bio/index.php?title=%E6%A8%A1%E6%9D%BF:CountdownFuture&diff=15909&oldid=prev
-光追-：对某模板的定向拓展
2026-04-30T02:08:09Z
<p>对某模板的定向拓展</p>
<p><b>新页面</b></p><div><includeonly>{{#if: {{{1|}}}<br />
|{{#if: {{{utc|}}}<br />
|{{#if: {{#pos:{{{1}}}|:}}<br />
|{{#expr: floor( ({{#time: U | {{{1}}} {{{utc}}} }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}<br />
|{{#expr: floor( ({{#time: U | {{{1}}} 00:00:00 {{{utc}}} }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}<br />
}}<br />
|{{#if: {{#pos:{{{1}}}|:}}<br />
|{{#expr: floor( ({{#time: U | {{{1}}} }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}<br />
|{{#expr: floor( ({{#time: U | {{{1}}} 00:00:00 }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}<br />
}}<br />
}}<br />
|错误：未提供日期参数<br />
}}</includeonly><br />
<br />
<noinclude><br />
<br />
== 模板描述 ==<br />
'''CountdownFuture''' - 计算当前时间到指定未来日期的剩余时间，可自定义输出格式。参考了[[模板:Countdown]]<br />
<br />
=== 使用方法 ===<br />
<pre><br />
{{CountdownFuture|目标日期|utc=时区|time=精度|text=后缀文本}}<br />
</pre><br />
<br />
=== 参数说明 ===<br />
; 1 (必需)<br />
: 目标日期，格式为YYYY-MM-DD或YYYY-MM-DD HH:MM:SS<br />
; utc (可选)<br />
: 时区偏移，例如+8表示UTC+8，-5表示UTC-5<br />
; time (可选)<br />
: 时间精度，可选值：day(天)、hour(小时)、minute(分钟)、second(秒)，默认为day<br />
; text (可选)<br />
: 显示在数字后面的后缀文本<br />
<br />
=== 示例 ===<br />
<pre><br />
{{CountdownFuture|2026-12-31}} → 输出距离2026年12月31日剩余的天数<br />
{{CountdownFuture|2026-12-31|utc=+8}} → 使用UTC+8时区计算剩余天数<br />
{{CountdownFuture|2026-12-31|time=hour}} → 输出剩余小时数<br />
{{CountdownFuture|2026-12-31 11:45:14|time=minute}} → 输出剩余分钟数<br />
{{CountdownFuture|2026-8-21|text=天后}} → 输出"X天后"<br />
</pre><br />
<br />
=== 主要修改 ===<br />
1. 将时间差计算顺序从 `(当前时间 - 目标时间)` 改为 `(目标时间 - 当前时间)`，确保结果为正数（剩余时间）<br />
2. 更新了模板描述和示例，使其更符合"距离指定日期还有xx时间"的语义<br />
<br />
=== 典型应用场景 ===<br />
* 显示距离未来重要日期的倒计时<br />
* 计算活动开始剩余时间<br />
* 显示项目截止日期倒计时<br />
* 记录距离特殊事件的剩余时间<br />
<br />
=== 注意事项 ===<br />
* 日期格式必须正确，否则会报错<br />
* 时区参数需符合±HH格式<br />
* 结果为整数，向下取整<br />
* 如果目标日期已过去，结果将为负数<br />
<br />
[[Category:时间模板]]<br />
</noinclude></div>
-光追-