---
category: Components
type: UI Views
component: Form
chinese: 时间选择器
english: TimePickerField
source: next-time-picker
---
当用户需要输入一个时间，可以点击标准输入框，弹出时间面板进行选择。
## API
| 参数 | 说明 | 类型 | 默认值 |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------- |
| prefix | 样式的品牌前缀 | String | 'next-' |
| className | 自定样式名 | String | - |
| size | 输入框尺寸
**可选值**:
'small', 'medium', 'large' | Enum | 'medium' |
| value | 时间 | any | - |
| defaultValue | 默认时间 | any | - |
| onChange | 时间值改变时的回调
**签名**:
Function(date: String, formatDate: String) => void
**参数**:
_date_: {String} 日期值
_formatDate_: {String} 格式化后的日期值 | Function | () => {} |
| defaultOpen | 默认是否展开 | Boolean | - |
| open | 展开 | Boolean | - |
| onOpenChange | 展开状态改变时的回调
**签名**:
Function(open: Boolean) => void
**参数**:
_open_: {Boolean} 是否展开 | Function | () => {} |
| format | 展示的时间格式，目前只支持 24 小时值 | String | 'HH:mm:ss' |
| disabled | 禁用全部操作 | Boolean | - |
| popupStyle | 弹层样式 | Object | - |
| popupAlign | 弹层对齐方式 | String | 'tl tl' |
| popupOffset | 弹层偏移 | Array | [0, 0] |
| disabledHours | 禁止选择指定分小时
Function() => Array
**签名**:
Function() => void | Function | - |
| disabledMinutes | 禁止选择指定分钟
Function() => Array
**签名**:
Function() => void | Function | - |
| disabledSeconds | 禁止选择部分秒
Function() => Array
**签名**:
Function() => void | Function | - |
| hasClear | 是否显示清空按钮 | Boolean | true |
| label | label 标签的文本 | ReactNode | - |
| labelCol | label 标签布局，通 `` 组件，设置 span offset 值，如 {span: 8, offset: 16}，该项仅在垂直表单有效 | Object | - |
| help | 提示信息，如不设置，则会根据校验规则自动生成. 如果设置会受控（ps: 可以利用这点自定义错误位置,详细看demo自定义错误) | ReactNode | - |
| validateStatus | 校验状态，如不设置，则会根据校验规则自动生成**可选值**:'''success'(成功)'error'(失败)'loading'(校验中) | Enum | - |
| hasFeedback | 配合 validateStatus 属性使用，是否展示校验状态图标, 目前只有Input支持 | Boolean | false |
| wrapperCol | 需要为输入控件设置布局样式时，使用该属性，用法同 labelCol | Object | - |
| extra | 额外的提示信息，和 help 类似，当需要错误信息和提示文案同时出现时，可以使用这个。 位于错误信息后面 | ReactNode | - |
| inputStyle | 表单输入框自定义内联样式 | Object/String | null |
| showValidateType | 应用于Field 类元素后，指定其展示错误的方式，可选值有 `help`、`tooltip` 两种| String | `help` |
| name | `walle 模式下才支持` 可以配合表单Form 收集表单元素的数据，要求表单必须指定 field 属性 | String | '' |
| rules | `walle 模式下才支持` 配置表单规则，可以配置多个规则，可参考：[async-validator](https://github.com/yiminghe/async-validator#rules)，注意Form 表单必须配置field 属性才会生效 | Array | null |
| x-bind | `walle 模式下才支持` 双向绑定某一个变量 | state | null |