TimePicker API
Segmented hour, minute, and optional second spinbuttons. A meridiem control appears in 12-hour mode, and a named field submits the 24-hour value.
Explore these related pages for additional context and usage patterns.
string | undefinedNamespace shared with the field components.
Default: "v0:time-picker"
boolean | undefinedIgnore every edit, show the value as given, and never emit.
Default: false
boolean | undefinedIgnore every edit, show the value as given, and never emit.
anyh12 shows 1–12 and a meridiem. h23 shows 0–23.
Default: "h23"
boolean | undefinedShow the second field and include seconds in the value.
Default: false
number | undefinedHour interval. The hour moves on its multiples.
Default: 1
number | undefinedMinute interval. The minute moves on its multiples.
Default: 1
number | undefinedSecond interval. The second moves on its multiples.
Default: 1
string | null | undefinedInclusive lower bound, HH:mm or HH:mm:ss.
Default: null
string | null | undefinedInclusive upper bound, HH:mm or HH:mm:ss.
Default: null
string | undefinedSet it to submit the displayed time with a form.
string | undefinedId of the form the hidden input belongs to, when it sits outside it.
boolean | undefinedFail validation while a field is still empty. Root reads it once, at setup.
any[] | undefinedValidation rules. Each receives the model value. Root reads them once, at setup.
Default: []
anyWhen to validate. Focus moving between the fields is not a blur. Input is an edit, a value from outside, or the picker normalizing a value that has a validity, from a validation or from error / errorMessages. The picker reads a late-accepting parent's answer as a value from outside.
Default: "blur"
boolean | undefinedForce the invalid state, whatever the rules say.
Default: false
anyError messages that come before the ones the rules produce.
string | undefinedNamespace of the parent Form to register with.
Default: "v0:form"
string | undefinedId of the group element.
Default: useId()
string | undefinedAccessible name for the group. Falls back to the locale catalog.
string | undefinedId of the element that labels the group. Replaces ariaLabel.
string | undefinedId of the element that describes the group.
string | null | undefined Default: null
string | undefinedUnique identifier. The component generates one when you pass none.
Default: useId()
string | undefinedNamespace for connecting to parent TimePicker.Root
Default: "v0:time-picker"
TimePickerDescriptionSlotPropsstring | undefinedUnique identifier. The component generates one when you pass none.
Default: useId()
string | undefinedNamespace for connecting to parent TimePicker.Root
Default: "v0:time-picker"
string | undefinedNamespace for connecting to TimePicker.Root.
Default: "v0:time-picker"
string | undefinedNamespace for connecting to TimePicker.Root.
Default: "v0:time-picker"
string | undefinedId of the spinbutton. Defaults to the Root id plus the part name.
string | undefinedAccessible name. Falls back to the locale catalog.
string | undefinedId of the element that labels the spinbutton. Replaces ariaLabel.
string | undefinedNamespace for connecting to TimePicker.Root.
Default: "v0:time-picker"
string | undefinedId of the spinbutton. Defaults to the Root id plus the part name.
string | undefinedAccessible name. Falls back to the locale catalog.
string | undefinedId of the element that labels the spinbutton. Replaces ariaLabel.
TimePickerMinuteSlotPropsstring | undefinedNamespace for connecting to TimePicker.Root.
Default: "v0:time-picker"
string | undefinedId of the spinbutton. Defaults to the Root id plus the part name.
string | undefinedAccessible name. Falls back to the locale catalog.
string | undefinedId of the element that labels the spinbutton. Replaces ariaLabel.
TimePickerPeriodSlotPropsstring | undefinedNamespace for connecting to TimePicker.Root.
Default: "v0:time-picker"
string | undefinedId of the spinbutton. Defaults to the Root id plus the part name.
string | undefinedAccessible name. Falls back to the locale catalog.
string | undefinedId of the element that labels the spinbutton. Replaces ariaLabel.
TimePickerSecondSlotProps