# TimePicker API

> Auto-generated API reference for `TimePicker` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/time-picker

## Related

- https://0.vuetifyjs.com/components/forms/time-picker
- https://0.vuetifyjs.com/composables/forms/create-time-picker
- https://0.vuetifyjs.com/components/forms/number-field

## TimePicker.Root

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace shared with the field components. |
| `disabled` | `boolean \| undefined` | `false` | no | Ignore every edit, show the value as given, and never emit. |
| `readonly` | `boolean \| undefined` | — | no | Ignore every edit, show the value as given, and never emit. |
| `hourCycle` | `any` | `"h23"` | no | `h12` shows 1–12 and a meridiem. `h23` shows 0–23. |
| `seconds` | `boolean \| undefined` | `false` | no | Show the second field and include seconds in the value. |
| `hourStep` | `number \| undefined` | `1` | no | Hour interval. The hour moves on its multiples. |
| `minuteStep` | `number \| undefined` | `1` | no | Minute interval. The minute moves on its multiples. |
| `secondStep` | `number \| undefined` | `1` | no | Second interval. The second moves on its multiples. |
| `min` | `string \| null \| undefined` | `null` | no | Inclusive lower bound, `HH:mm` or `HH:mm:ss`. |
| `max` | `string \| null \| undefined` | `null` | no | Inclusive upper bound, `HH:mm` or `HH:mm:ss`. |
| `name` | `string \| undefined` | — | no | Set it to submit the displayed time with a form. |
| `form` | `string \| undefined` | — | no | Id of the form the hidden input belongs to, when it sits outside it. |
| `required` | `boolean \| undefined` | — | no | Fail validation while a field is still empty. Root reads it once, at setup. |
| `rules` | `any[] \| undefined` | `[]` | no | Validation rules. Each receives the model value. Root reads them once, at setup. |
| `validateOn` | `any` | `"blur"` | no | When 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. |
| `error` | `boolean \| undefined` | `false` | no | Force the invalid state, whatever the rules say. |
| `errorMessages` | `any` | — | no | Error messages that come before the ones the rules produce. |
| `formNamespace` | `string \| undefined` | `"v0:form"` | no | Namespace of the parent Form to register with. |
| `id` | `string \| undefined` | `useId()` | no | Id of the group element. |
| `ariaLabel` | `string \| undefined` | — | no | Accessible name for the group. Falls back to the locale catalog. |
| `ariaLabelledby` | `string \| undefined` | — | no | Id of the element that labels the group. Replaces `ariaLabel`. |
| `ariaDescribedby` | `string \| undefined` | — | no | Id of the element that describes the group. |
| `modelValue` | `string \| null \| undefined` | `null` | no | — |

### Events

| Name | Type | Description |
|---|---|---|
| `update:model-value` | `[value: string \| null]` | — |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerRootSlotProps` | — |

## TimePicker.Description

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `id` | `string \| undefined` | `useId()` | no | Unique identifier. The component generates one when you pass none. |
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to parent TimePicker.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerDescriptionSlotProps` | — |

## TimePicker.Error

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `id` | `string \| undefined` | `useId()` | no | Unique identifier. The component generates one when you pass none. |
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to parent TimePicker.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerErrorSlotProps` | — |

## TimePicker.HiddenInput

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to TimePicker.Root. |

## TimePicker.Hour

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to TimePicker.Root. |
| `id` | `string \| undefined` | — | no | Id of the spinbutton. Defaults to the Root id plus the part name. |
| `ariaLabel` | `string \| undefined` | — | no | Accessible name. Falls back to the locale catalog. |
| `ariaLabelledby` | `string \| undefined` | — | no | Id of the element that labels the spinbutton. Replaces `ariaLabel`. |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerHourSlotProps` | — |

## TimePicker.Minute

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to TimePicker.Root. |
| `id` | `string \| undefined` | — | no | Id of the spinbutton. Defaults to the Root id plus the part name. |
| `ariaLabel` | `string \| undefined` | — | no | Accessible name. Falls back to the locale catalog. |
| `ariaLabelledby` | `string \| undefined` | — | no | Id of the element that labels the spinbutton. Replaces `ariaLabel`. |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerMinuteSlotProps` | — |

## TimePicker.Period

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to TimePicker.Root. |
| `id` | `string \| undefined` | — | no | Id of the spinbutton. Defaults to the Root id plus the part name. |
| `ariaLabel` | `string \| undefined` | — | no | Accessible name. Falls back to the locale catalog. |
| `ariaLabelledby` | `string \| undefined` | — | no | Id of the element that labels the spinbutton. Replaces `ariaLabel`. |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerPeriodSlotProps` | — |

## TimePicker.Second

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:time-picker"` | no | Namespace for connecting to TimePicker.Root. |
| `id` | `string \| undefined` | — | no | Id of the spinbutton. Defaults to the Root id plus the part name. |
| `ariaLabel` | `string \| undefined` | — | no | Accessible name. Falls back to the locale catalog. |
| `ariaLabelledby` | `string \| undefined` | — | no | Id of the element that labels the spinbutton. Replaces `ariaLabel`. |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `TimePickerSecondSlotProps` | — |
