# DurationPicker 时长选择

按时长值选择并回填，单位与候选项由组件内部推导。

## 基础用法

:::preview 基础用法 || 选择后回填的是毫秒数

demo-preview=../demos/duration-picker/basic.vue

:::

## 何时使用

需要让用户选择一个时间跨度（缓存有效期、超时时长等）时使用。对外只暴露毫秒值，单位换算是内部细节。

## 取值与单位

`modelValue` 是**毫秒数**。组件内置了年 / 天 / 小时 / 分钟 / 秒 / 毫秒六个单位，各自带有取值范围与步长：

| 单位 | 范围 | 步长 |
| --- | --- | --- |
| 年 | 1 - 100 | 1 |
| 天 | 1 - 364 | 1 |
| 小时 | 1 - 23 | 1 |
| 分钟 | 1 - 59 | 1 |
| 秒 | 1 - 59 | 1 |
| 毫秒 | 50 - 950 | 50 |

默认值为 1000 毫秒（1 秒）。

## 两个事件

`update:modelValue` 在滚动选择时触发，`change` 在确认选择时触发：

```vue
<duration-picker v-model="duration" @change="onConfirm" />
```

## API

<api-table name="DurationPicker" />