For AI agents: the complete documentation index is available at https://wallarm.github.io/design-system/llms.txt, the full documentation bundle is available at https://wallarm.github.io/design-system/llms-full.txt, and this page is available as Markdown at https://wallarm.github.io/design-system/components/time-input.md.

TimeInput

A time typed segment by segment, the companion to DateInput — showTimeDropdown adds a list of times for when the reader would rather pick than type. It takes React Aria time objects, and hour cycle comes from DateFormatProvider app-wide rather than per input.

Source · Storybook

Usage

import { TimeInput } from '@wallarm-org/design-system/TimeInput';

Examples

States

Default, disabled and error, matching DateInput so a form containing both stays consistent.

Icon

A clock icon as decoration. It opens nothing on its own — the dropdown is a separate opt-in.

Sizes

The shared height scale, so a time field lines up beside a date field.

Filled

A held value beside a placeholder, with the clear affordance appearing only once there is a value.

Granularity

Hour, minute or second. Drop to hour where minutes would imply a precision the system does not honour.

Time dropdown steps

timeStep sets the spacing of the offered times — fifteen, thirty or sixty minutes. Coarser steps make the list scannable; the reader can still type an exact time.

Read only

Value legible, every edit affordance gone, as on DateInput.

Props

PropTypeDefaultDescription
showIconboolean | undefinedtrueWhether to show the leading icon. Default: true.
errorboolean | undefinedfalseWhether the input has an error state. Sets aria-invalid and error styling.
disabledboolean | undefinedfalseWhether the input is disabled. Prevents user interaction.
readOnlyboolean | undefinedfalseWhether the input is read-only. Segments are focusable but not editable.
placeholderstring | undefinedPlaceholder shown when no value is selected.
sizeTemporalInputSize | undefineddefaultVisual size. Default: 'default' (36px).
titlestring | undefined
defaultCheckedboolean | undefined
autoFocusboolean | undefined
idstring | undefined
tabIndexnumber | undefined
relstring | undefined
data-testidstring | undefined
valueTimeValue | null | undefined
defaultValueTimeValue | null | undefined
onChangecomplex
minValueTimeValue | undefined
maxValueTimeValue | undefined
placeholderValueTimeValue | undefined
namestring | undefined
isRequiredboolean | undefinedMarks the field as required in assistive tech and HTML form validation.
showTimeDropdownboolean | undefinedShow dropdown for time selection with arrow navigation.
timeStepnumber | undefined30Time interval in minutes for dropdown options. Default: 30.
granularityTimeInputGranularity | undefinedminuteSmallest editable unit. - 'hour': hours only - 'minute': hours and minutes (default) - 'second': hours, minutes, and seconds