---
url: /components/time-picker.md
---
# TimePicker 时间选择器

时间（点选面板）选择器：支持时:分:秒与任意 format，范围选择用 `is-range`。日期 + 时间一起选请用 [DatePicker](/components/date-picker)。

## 基础用法

## 范围选择

两端输入框支持手输：合法值走统一确认通道（自动按先后排序输出），非法输入回滚显示。

## 格式与取值格式

`format` 控制展示（不含 ss 即隐藏秒列），`value-format` 控制绑定值格式（缺省绑定 Date 对象）：

## 禁用时间

`disabled-hours` / `disabled-minutes` / `disabled-seconds` 传入函数（返回数字数组），滚轮对应项置灰且不可选中；分钟、秒的禁用集分别接收当前小时、当前小时与分钟作为入参。当前值落在禁用集内时自动让位到最近的可用值。