# Countdown 倒计时
倒计时,用法与 [Statistic](./statistic) 相同,数值为剩余时间。
## 基础用法
`value` 是结束的时刻(毫秒时间戳或 `Date`)。`format` 默认 `HH:mm:ss`。
## 格式
| 记号 | 含义 |
| ------------ | ---------------------- |
| `D` / `DD` | 天 |
| `H` / `HH` | 时 |
| `m` / `mm` | 分 |
| `s` / `ss` | 秒 |
| `S` 到 `SSS` | 十分之一秒到毫秒 |
| `[文字]` | 原样保留方括号里的文字 |
记号重复一次表示补零。格式里最大的那个单位会吸收溢出:`mm:ss` 在剩 90 分钟时显示 `90:00`,不会丢掉小时。不显示毫秒时按整秒向上取整,所以 60 秒的倒计时从 `60` 开始、到 `0` 时正好结束。
## useCountdown
不需要统计数值的外观时,用组合式函数 `useCountdown` 自己渲染。最常见的就是“重新发送验证码”:
`remaining` 是剩余毫秒数。默认每逢剩余时间的整秒更新一次,显示秒数时不会跳号;需要更细时传 `{ interval: 50 }`。`onFinish` 在归零时调用。
## API
### Countdown Props
| 名称 | 说明 | 类型 | 默认值 |
| -------- | -------- | ---------------- | ------------ |
| `value` | 结束时刻 | `number \| Date` | — |
| `format` | 显示格式 | `string` | `'HH:mm:ss'` |
| `title` | 标签 | `string` | — |
| `prefix` | 前缀 | `string` | — |
| `suffix` | 后缀 | `string` | — |
### Countdown Events
| 名称 | 说明 | 参数 |
| -------- | -------------------- | --------------------- |
| `finish` | 归零 | — |
| `change` | 剩余时间变化(毫秒) | `(remaining: number)` |
### Countdown Slots
与 [Statistic](./statistic#statistic-slots) 相同:`title`、`prefix`、`suffix`、`footer`。
### 键盘与读屏
- 根元素是 `role="timer"`,读屏不会每秒播报一次;需要在结束时提示,可以在 `finish` 里用 [Toast](./toast)。
- 服务端渲染时先显示零,挂载后才开始计时,避免两边时间不同造成的水合不一致。