ant-design/components/time-picker/index.en-US.md

category	type	title	cover
Components	Data Entry	TimePicker	https://gw.alipayobjects.com/zos/alicdn/h04Zsl98I/TimePicker.svg

To select/input a time.

When To Use

---

By clicking the input box, you can select a time from a popup panel.

API

---

import moment from 'moment';

<TimePicker defaultValue={moment('13:30:56', 'HH:mm:ss')} />;

Property	Description	Type	Default	Version
allowClear	allow clearing text	boolean	true
autoFocus	get focus when component mounted	boolean	false
bordered	whether has border style	boolean	true
className	className of picker	string	''
clearText	clear tooltip of icon	string	clear
defaultValue	to set default time	moment	-
disabled	determine whether the TimePicker is disabled	boolean	false
disabledHours	to specify the hours that cannot be selected	function()	-
disabledMinutes	to specify the minutes that cannot be selected	function(selectedHour)	-
disabledSeconds	to specify the seconds that cannot be selected	function(selectedHour, selectedMinute)	-
format	to set the time format	string	"HH:mm:ss"
getPopupContainer	to set the container of the floating layer, while the default is to create a div element in body	function(trigger)	-
hideDisabledOptions	hide the options that can not be selected	boolean	false
hourStep	interval between hours in picker	number	1
inputReadOnly	Set the readonly attribute of the input tag (avoids virtual keyboard on touch devices)	boolean	false
minuteStep	interval between minutes in picker	number	1
open	whether to popup panel	boolean	false
placeholder	display when there's no value	string | [string, string]	"Select a time"
popupClassName	className of panel	string	-
popupStyle	style of panel	CSSProperties	-
secondStep	interval between seconds in picker	number	1
suffixIcon	The custom suffix icon	ReactNode	-
clearIcon	The custom clear icon	ReactNode	-
use12Hours	display as 12 hours format, with default format h:mm:ss a	boolean	false
renderExtraFooter	called from time picker panel to render some addon to its bottom	() => ReactNode	-
value	to set time	moment	-
onChange	a callback function, can be executed when the selected time is changing	function(time: moment, timeString: string): void	-
onOpenChange	a callback function which will be called while panel opening/closing	(open: boolean): void	-
showNow	Whether to show 'Now' button on panel	boolean	-	4.4.0

Methods

Name	Description	Version
blur()	remove focus
focus()	get focus

RangePicker

Same props from RangePicker of DatePicker. And includes additional props:

Property	Description	Type	Default	Version
order	Order start and end time	boolean	true	4.1.0

FAQ

• How to use TimePicker with customize date library like dayjs