Skip to main content
Urbicon UI

TimeInputbeta

Segmented time-of-day field — hour / minute (/ second) cells in one unified control, with per-segment Arrow-key stepping, digit auto-advance, and 12- or 24-hour display. The value is always a canonical 24-hour HH:MM string.

Playground

Time
Format
Size
Variant
Loading...
Loading syntax highlighting...

01 Examples

24-hour — the default

The bound value is a canonical 24-hour HH:MM string, or null when the field is empty.
Start

Value: 09:30

Loading...
Loading syntax highlighting...

12-hour display

format="12h" adds an AM/PM segment for display only — the bound value stays a canonical 24-hour string (14:15 shows as 02:15 PM but binds as 14:15).
Meeting
AM

Value (24h): 14:15

Loading...
Loading syntax highlighting...

With seconds

withSeconds appends a seconds segment; the value widens to HH:MM:SS.
Duration

Value: 13:45:30

Loading...
Loading syntax highlighting...

Range bounds

Values below min or above max clamp back into range when the field loses focus.
Appointment
Office hours

Value: 09:00

Loading...
Loading syntax highlighting...

Sizes

Three field heights via the size prop — sm, md (default), lg.
Small
Medium
Large
Loading...
Loading syntax highlighting...

Error state

Pass error to colour the field danger, override the helper, and mark the segments aria-invalid; the message is announced via role="alert".
Time

Value:

Loading...
Loading syntax highlighting...

02 Date + Time

TimeInput closes the last gap in the form family: Calendar, DatePicker and DateRangePicker cover dates; TimeInput covers the time of day. It edits a time in isolation, so pair it with a DatePicker as two separate fields when you need a full timestamp — each keeps its own canonical value (an ISO date from the picker, an HH:MM string from the time field), which you combine at the boundary.

Date and time side by side

A DatePicker for the day and a TimeInput for the time — two independent fields, two independent values.
Time

Date: 2026-08-15 · Time: 14:30

Loading...
Loading syntax highlighting...

03 Customization

Reach for named presets registered on <BlocksProvider> for a reusable look, or slotClasses to retouch individual parts — the slots are wrapper, label, field, icon, segment, separator, meridiem, and message. For a full ground-up restyle, set unstyled to drop every default class and rebuild from the slots.

showIcon={false} hides the leading clock icon, and fullWidth stretches the field to fill its container instead of hugging its content.

04 Accessibility

  • The field is a role="group" named by its label (or aria-label).
  • Each segment — hour, minute, and (when present) second — carries its own aria-label.
  • Arrow Up / Down steps the focused segment (with wrap); Arrow Left / Right moves between segments; typing digits auto-advances to the next segment.
  • The AM/PM segment toggles by click, Arrow keys, or the A / P keys.
  • Out-of-range values clamp to min / max when the field loses focus.
  • The error message is announced via role="alert".

05 API Reference

28 props
28 props

No matching properties

No matching properties

06 Installation

Import

Loading...
Loading syntax highlighting...