duration

格式化秒数或 ISO 8601 时长。

语法

{{ value | duration }}
{{ value | duration:"H:mm:ss" }}

用法

• 可选的格式支持用于小时的 H 和 HH、用于分钟的 m 和 mm，以及用于秒的 s 和 ss。
• 不指定格式时，至少一小时的时长使用 HH:mm:ss；更短的时长使用 mm:ss。
• 数据可以是 ISO 8601 时长，也可以是秒数。

示例

ISO 8601 时长

Data

{
  "duration": "PT1H30M"
}

Template

{{ duration | duration:"HH:mm:ss" }}

Output

01:30:00

秒数

Data

{
  "seconds": 3665
}

Template

{{ seconds | duration:"H:mm:ss" }}

Output

1:01:05

默认格式

Data

{
  "duration": "PT5M30S"
}

Template

{{ duration | duration }}

Output

05:30

超过 24 小时

Data

{
  "duration": "P1DT2H"
}

Template

{{ duration | duration:"HH:mm:ss" }}

Output

26:00:00

时长格式

Knap 支持下面六个格式符。小时表示总时长，可以超过 23；分钟和秒是剩余的分量。不支持其他 Day.js 时长格式符以及方括号转义。参见 Day.js 时长格式。

格式符	含义	3665 秒的输出
H	总小时数	1
HH	总小时数，至少两位	01
m	剩余分钟（0–59）	1
mm	剩余分钟，补零（00–59）	01
s	剩余秒数（0–59）	5
ss	剩余秒数，补零（00–59）	05

相关过滤器

• date