Search...

Search documentation...

Time Picker

Time Picker

An HH:MM(:SS)[ AM/PM] segmented time input, operating directly on a Date — type digits (auto-advances after 2), Up/Down to step, Left/Right to move between segments. Pairs with Calendar/DatePicker to build a full date+time picker (see DateTimePicker), or stands alone for a time-only field.

import { TimePicker } from "@pompeitech/vesuvius-ui";

24-hour

:

12-hour, with seconds

::

API

TimePicker

PropTypeDefaultDescription
dateDate | undefinedThe full date whose time-of-day portion this component edits — only the hour/minute/second fields change, the date portion passes through untouched.
onChange(date: Date) => voidFires with the updated Date on every segment edit.
hourFormat"12" | "24""24""12" adds an AM/PM segment.
showSecondsbooleanfalseAdds a Seconds segment.
disabledbooleanfalse

Plus every native <div> prop on the root wrapper.

Accessibility

Each segment is a real native <input>, so it's focusable and reachable by Tab like any text field. Within a segment, ←/→ move to the adjacent segment, ↑/↓ step its value, and typing digits fills it directly (auto-advancing after two digits) — all via a manual onKeyDown handler rather than native spinbutton semantics, so pair each TimePicker with a visible or aria-labeled caption of its own (as DateTimePicker does) describing what the time represents.