---
title: TimePicker 时间选择
description: 用于选择某一具体时间点或某一时间段。
isComponent: true
usage: { title: "", description: "" }
spline: message
author: swimly
---

## 基本用法

通过`allowInput`限制是否可以直接输入时间，默认不允许手动输入。

{{ base }}

## 是否允许清空

通过`clearable`控制是否允许清空选中值。

{{ clearable }}

## 格式化

通过`format`可设置不同形式的时间选择，[详细文档](https://day.js.org/docs/en/display/format)，

{{ format }}

## 步长

由时、分两部分组成的选择界面，且分钟刻度步长大于 1。用户对时间精度要求不高的场景，如数据筛选，通过`steps`来设置。

> 例如：数组排列 [小时, 分钟, 秒]，示例：[2, 1, 1] 或者 ['2', '1', '1']

{{ steps }}

## 时间范围

用于某一段时间的选择。用户需要输入一段时间区间时使用。

{{ range }}

## 禁用

通过`disabled`设置禁用

{{ disabled }}
