Files
timi-tdesign-mobile/docs/components/duration-picker.md
T
2026-09-21 16:05:14 +08:00

1010 B

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 在确认选择时触发:

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

API