模板:TimeDiff/doc

这是一个基于Lua模块的计时模板，用于计算两个时间点之间的差值。它可以输出纯秒数，也可以格式化为“天/小时/分/秒”的可读文本。

基本语法

{{TimeDiff
| 开始时间 = 2025-11-24T15:38
| 结束时间 = now
| 格式 = 4
}}

参数

• 开始时间：接受时间字符串或 now。如果省略，默认为 now。
  • 注：输入的具体时间会被默认为 UTC+8（北京时间）。
• 结束时间：接受时间字符串或 now。如果省略，默认为 now。
• 格式：控制输出内容的格式。
  • 未填写：输出两个时间相差的原始秒数（可用于自定义的计算）。
  • 1：输出 XX天。
  • 2：输出 XX天XX小时。
  • 3：输出 XX天XX小时XX分钟。
  • 4：输出 XX天XX小时XX分钟XX秒。
  • 5：输出 XX年XX天XX小时XX分钟XX秒。

示例

• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now }} → 239853514
• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now | 格式 = 1}} → 2776天
• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now | 格式 = 2}} → 2776天1小时
• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now | 格式 = 3}} → 2776天1小时58分钟
• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now | 格式 = 4}} → 2776天1小时58分钟34秒
• {{TimeDiff | 开始时间 = 2018-08-07T12:00 | 结束时间 = now | 格式 = 5}} → 7年221天