HextaUI
156Get started
HextaUI

Time input (UI SDK): Clock and seconds

The field shows the locale’s clock. hourCycle picks 12 or 24 hours, and granularity adds seconds or shows the hour alone. All of them submit 24-hour values.

import { Label } from "@/components/ui/label"
import { TimeInput } from "@/components/ui/ui-sdk-time-input"

function UiSdkTimeInputClock() {
  return (
    <div className="flex w-full max-w-40 flex-col gap-4">
      <div className="flex flex-col gap-2">
        <Label id="clock-12">12-hour clock</Label>
        <TimeInput
          aria-labelledby="clock-12"
          hourCycle={12}
          defaultValue="18:45"
          locale="en-US"
        />
      </div>
      <div className="flex flex-col gap-2">
        <Label id="clock-24">24-hour clock</Label>
        <TimeInput
          aria-labelledby="clock-24"
          hourCycle={24}
          defaultValue="18:45"
        />
      </div>
      <div className="flex flex-col gap-2">
        <Label id="clock-seconds">With seconds</Label>
        <TimeInput
          aria-labelledby="clock-seconds"
          granularity="second"
          hourCycle={24}
          defaultValue="18:45:30"
        />
      </div>
      <div className="flex flex-col gap-2">
        <Label id="clock-hour">Hour only</Label>
        <TimeInput
          aria-labelledby="clock-hour"
          granularity="hour"
          hourCycle={24}
          defaultValue="18:00"
        />
      </div>
    </div>
  )
}

export { UiSdkTimeInputClock }

Add this example

This adds the example as components/examples/ui-sdk-time-input/clock.tsx, together with the Time input component and the HextaUI theme tokens it needs.

pnpm dlx shadcn@latest add https://hextaui.com/r/ui-sdk-time-input-clock.json

To add only the component, follow the Time input installation.

Props in this example

The Time input props this example sets, from the API reference.

TimeInput

PropTypeDefault
defaultValue
string | null–
hourCycleDefaults to the locale’s clock.
12 | 24–
granularity
"hour" | "minute" | "second""minute"
localeDefaults to the page’s language.
string–

Every prop is in the Time input API reference.

More Time input examples

See them all, with keyboard support and accessibility notes, on the Time input page.

Related components