TimePicker

A time of day or a range of them, chosen from scrolling columns or typed into the field.

Basic

Pass value and onChange to control the picker, which opens a panel with hour, minute and second columns.

Sizes

Set size to large or small to match the other fields in your form, with medium as the default.

Variants

Set variant to outlined, filled, text, underlined, borderless or bare, the same six styles Input and Select use. text fills on hover and while focused, and bare draws nothing at all.

Status

Set status to warning or error to color the field's border when its value needs attention.

12-hour clock

Set use12Hours with a matching format like h:mm a to add an AM/PM column, so the field and the panel agree.

Hours and minutes

Set format to HH:mm to leave out seconds, and the panel drops its seconds column to match.

Steps

Set hourStep, minuteStep and secondStep to offer only every second hour, every 15 minutes and every 10 seconds.

Time range

Use TimePicker.RangePicker to pick a start and an end time in one field, with the two kept in order.

Overnight range

Set order={false} so an end before the start, like a shift from 22:00 to 06:00, stays as picked instead of being swapped.

Disabled times

Pass disabledTime to block hours and minutes, like everything outside 9:00 to 18:45 and any minute off the quarter hour.

Change on scroll

Set changeOnScroll to pick a value as soon as a column stops scrolling, with needConfirm={false} so no OK button is needed.

Extra footer

Pass renderExtraFooter to add your own controls under the panel, like a suggested checkout time the guest can pick in one click.

In a form

Put a TimePicker in a Form.Item with a required rule, like a meeting time on a 15-minute grid.

In context

The component inside real screens, with the components it usually sits beside.

Business hours

A weekly opening-hours card with a range picker per day, a Closed switch, and a button that copies one day to all.

API Reference

TimePicker
TimePicker's props. Rows marked antuikit in the Version column are added by the kit.
TimeRangePicker
TimeRangePicker's props where they differ from TimePicker's. Rows marked antuikit in the Version column are added by the kit.