build69
build69  /  Components  /  Date & Time  /  TimeClock

TimeClock

v1.0.7Updated 27 Aug 2026

Analog clock-face time picker (MUI TimeClock equivalent). A round face where the user clicks a number to pick hours, then minutes — the classic two-step interaction. Supports 12h (AM/PM) and 24h (two concentric rings), o

Preview

Live · 10 stories
DefaultOpen ↗
Why this is recommendedtimepickerclockanalog+4

The default, out-of-the-box TimeClock.

Recommended for+14
  • Touch-friendly time entry
  • Appointment / meeting time pickers
  • Settings where an analog clock reads naturally
Tags+6
timepickerclockanaloghoursminutesmuidefault
Features+4
  • Analog clock face with selectable numbers + pointing hand
  • Two-step hour → minute flow with auto-advance
  • 12-hour mode with AM/PM toggle
  • 24-hour mode with inner / outer ring (00..23)
  • Optional seconds view
  • minutesStep granularity
  • Controlled or uncontrolled value + controlled view
  • Keyboard increment / decrement (arrows / PageUp / PageDown)
  • Disabled / readOnly states
Not recommended for−2
  • Fast keyboard-only entry of precise times (use a text time field)
  • Date selection (use DatePicker)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "TimeClock" })

Usage

import { TimeClock } from '@/components/inputs/time-clock';

<TimeClock value={time} onChange={setTime} ampm minutesStep={5} />

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
value

Controlled value

Date | null
onChange

Fired on hours / minutes / seconds change

(date: Date) => void
defaultValue

Uncontrolled initial value

Date | null
ampm

12-hour with AM/PM (default true) vs 24-hour

boolean
minutesStep

Granularity of the minutes view

number
view

Controlled active view

'hours' | 'minutes' | 'seconds'
onViewChange

Fired when the active view changes

(view) => void
views

Available views in order

('hours' | 'minutes' | 'seconds')[]
disabled

Disable interaction

boolean
readOnly

Read-only (no value changes)

boolean
size

Clock-face diameter in px

number

Related