模板:CountdownFuture

模板描述

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

使用方法

{{CountdownFuture|目标日期|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 (可选)

显示在数字后面的后缀文本

示例

{{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天后"

主要修改

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

典型应用场景

• 显示距离未来重要日期的倒计时
• 计算活动开始剩余时间
• 显示项目截止日期倒计时
• 记录距离特殊事件的剩余时间

注意事项

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