---
url: /components/countdown.md
---
# Countdown 倒计时

目标时刻倒计时，到点自动停在零值并触发 `finish` 事件，适合秒杀开始、订单支付剩余时间、活动截止提醒等场景。与 Statistic 同族排版，可直接并排使用。

## 基础用法

`value` 传目标时刻（Date、时间戳或可解析的日期字符串），组件自动走秒：

## 格式与前后缀

`format` 令牌：`HH` 总小时（可超过 24）、`mm` 分、`ss` 秒，其余字符原样输出；`prefix` / `suffix` 适合「还剩 / 截止」类提示语：

## 结束事件与重置

到点触发 `finish`；运行中每次走秒触发 `change`（载荷为剩余毫秒）。改 `value` 即重新计时：