查看“︁模板:CountdownFuture”︁的源代码

<includeonly>{{#if: {{{1|}}}
  |{{#if: {{{utc|}}}
    |{{#if: {{#pos:{{{1}}}|:}}
      |{{#expr: floor( ({{#time: U | {{{1}}} {{{utc}}} }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
      |{{#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|}}}
    }}
    |{{#if: {{#pos:{{{1}}}|:}}
      |{{#expr: floor( ({{#time: U | {{{1}}} }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
      |{{#expr: floor( ({{#time: U | {{{1}}} 00:00:00 }} - {{#time: U}}) / {{#switch: {{{time|day}}}|day=86400|hour=3600|minute=60|second=1|#default=86400}} )}}{{{text|}}}
    }}
  }}
  |错误：未提供日期参数
}}</includeonly>

<noinclude>

== 模板描述 ==
'''CountdownFuture''' - 计算当前时间到指定未来日期的剩余时间，可自定义输出格式。参考了[[模板:Countdown]]

=== 使用方法 ===
<pre>
{{CountdownFuture|目标日期|utc=时区|time=精度|text=后缀文本}}
</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>
{{CountdownFuture|2026-12-31}} → 输出距离2026年12月31日剩余的天数
{{CountdownFuture|2026-12-31|utc=+8}} → 使用UTC+8时区计算剩余天数
{{CountdownFuture|2026-12-31|time=hour}} → 输出剩余小时数
{{CountdownFuture|2026-12-31 11:45:14|time=minute}} → 输出剩余分钟数
{{CountdownFuture|2026-8-21|text=天后}} → 输出"X天后"
</pre>

=== 主要修改 ===
1. 将时间差计算顺序从 `(当前时间 - 目标时间)` 改为 `(目标时间 - 当前时间)`，确保结果为正数（剩余时间）
2. 更新了模板描述和示例，使其更符合"距离指定日期还有xx时间"的语义

=== 典型应用场景 ===
* 显示距离未来重要日期的倒计时
* 计算活动开始剩余时间
* 显示项目截止日期倒计时
* 记录距离特殊事件的剩余时间

=== 注意事项 ===
* 日期格式必须正确，否则会报错
* 时区参数需符合±HH格式
* 结果为整数，向下取整
* 如果目标日期已过去，结果将为负数

[[Category:时间模板]]
</noinclude>