# Shadcn Date & Time

> Date and time

- Type: example, free and open source (MIT)
- Component: [Time Picker](https://reui.io/components/time-picker.md)
- Page: https://reui.io/components/time-picker/c-time-picker-13
- Docs (Base UI): https://reui.io/docs/components/base/time-picker.md
- Docs (Radix UI): https://reui.io/docs/components/radix/time-picker.md
- MCP: `get_example("c-time-picker-13")`
- Registry item: https://reui.io/r/styles/base-nova/c-time-picker-13.json
- Uses: Button, Calendar, Card, Time Picker

## Best for

A day and a time merged into one summary line, with 7 row columns, no footer and a Schedule button

## Agent notes

- `FIRST_MONTH` and `SUGGESTED_DAY` are fixed to October 2026; replace them with dates from your app
- The Schedule `Button` only stores the summary in local `scheduled` state; send the date and `time` to your API there

## When not to use

- A day of the month picked with no hour or minute: use [Calendar](https://reui.io/components/calendar.md) (`get_component("calendar")`)

## Third-party libraries

- React DayPicker v9: [API reference](https://daypicker.dev/v9/api), [docs](https://daypicker.dev/v9/start), through shadcn Calendar

## Install

```bash
npx shadcn@latest add @reui/c-time-picker-13
```

## About Shadcn Time Picker

### When to use

- Appointment, pickup and delivery slots kept on minute steps inside opening hours
- Recurring times of day in settings, such as a daily digest, a standup or a shift start
- Meeting start and end times, and a publish time set beside a chosen day

### When not to use

- A booking card with a day, a list of open slots, a duration and a confirm step: use the [Schedule blocks](https://reui.io/blocks/application/schedule.md)
- A day or a range of days picked with no time of day: use [Calendar](https://reui.io/components/calendar.md) (`get_component("calendar")`)
- A whole data entry page where the time is one field among many: use the [Form blocks](https://reui.io/blocks/application/form.md)

### Agent notes

- A `value` or `defaultValue` set in code shows as given, never snapped to the steps, `min` or `max`; only picks, typing and Now snap
- On `TimePickerTrigger`, `aria-label` replaces the shown value in the accessible name; point `aria-labelledby` at a visible label
- Inside a right to left `dir` wrapper, pass `dir` to `TimePickerContent` too, because the popover portals out of the wrapper

Every ReUI item has a twin like this one; the index is https://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.
