ant-design/components/time-picker/index.zh-CN.md

2.0 KiB

category subtitle type title
Components 时间选择框 Data Entry TimePicker

输入或选择时间的控件。

何时使用


当用户需要输入一个时间,可以点击标准输入框,弹出时间面板进行选择。

API


import moment from 'moment';
<TimePicker defaultValue={moment('13:30:56', 'HH:mm:ss')} />
参数 说明 类型 默认值
defaultValue 默认时间 moment
value 当前时间 moment
defaultOpenValue 无选中值时,面板打开时高亮的值 moment moment()
open 面板是否打开 boolean false
onOpenChange 面板打开/关闭时的回调 (open: boolean): void
placeholder 没有值的时候显示的内容 string "请选择时间"
onChange 时间发生变化的回调 function(time: moment, timeString: string): void
format 展示的时间格式 string "HH:mm:ss"
disabled 禁用全部操作 boolean false
disabledHours 禁止选择部分小时选项 function()
disabledMinutes 禁止选择部分分钟选项 function(selectedHour)
disabledSeconds 禁止选择部分秒选项 function(selectedHour, selectedMinute)
hideDisabledOptions 隐藏禁止选择的选项 boolean false
getPopupContainer 定义浮层的容器,默认为 body 上新建 div function(trigger)
addon 选择框底部显示自定义的内容 function
use12Hours 使用 12 小时制,为 true 时 format 默认为 h:mm:ss a boolean false
className 选择器类名 string ''
popupClassName 弹出层类名 string ''