Time Picker
Prov1.0.0Pick an hour and minute while seeing how busy each hour is.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { TimePicker } from "@/components/ui/notchset/time-picker";
// Load per hour (0–100): busy hours draw muted.
const runLoad = [12, 8, 6, 5, 6, 10, 22, 41, 66, 78, 82, 80, 74, 77, 81, 79, 70, 58, 44, 36, 30, 24, 18, 14];
export function ScheduleTime() {
const [time, setTime] = React.useState("09:00");
return <TimePicker value={time} onValueChange={setTime} load={runLoad} zone="UTC" />;
}Props
value / onValueChange–"HH:MM"24-hour.
load–number[24]0–100 per hour; the strip's heights.
peakAt–numberBusy hours (muted); default 70.
minutes–number[]Up to four stops; default 0, 15, 30, 45.
zone–ReactNodeA label after the time, e.g. UTC.
describeHour–(hour, load) => stringThe readout and value text.
Anatomy
- Base UI and Radix builds: your components.json picks one.
- The strip is the hour slider: no separate hour list.
- Minutes use the Segmented Control's stretching thumb, inline.
TimePickerdata-slot="time-picker-trigger"The trigger.
—data-slot="time-picker-content"The popup.
Source
components/ui/notchset/time-picker.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Build for your project
Code/install build
Installation
pnpm dlx shadcn@latest add @notchset-pro/time-pickerNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Scheduling a job or a send, where the load by hour matters
Use something else when
- Exact minutes: use an input with type=time
Mistakes to avoid
- Pass 24 load values, or the strip draws flat
Agents find it by
- time picker, schedule time, cron start, hour picker, time input, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/time-picker.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← →
- Hour
- Home / End
- 00 / 23
- Enter
- Done
- Esc
- Close
Accessibility
- The strip is a slider (0–23) whose value text includes the load; the minutes are a radiogroup
- Opening focuses the strip; Enter or Esc closes and focus returns to the trigger
Motion
- Hour
- The picked lollipop's head pops (260ms) and its stem thickens
- Minute
- The thumb's leading edge moves first, the trailing edge 80ms later (340ms)
- Time
- The trigger's digits roll, ones first
Responsive
- The popup is 314px wide.
Performance
- One SVG of 24 groups; CSS transitions.
Changelog
v1.0.0 · 2026-10-02
First release
Part of
Included with Pro
Pro is in early access.
