> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clock

> A visual time selector used inside DateTimePicker or standalone for time-only input. Handles hour and minute selection — only include seconds when the use case genuinely requires that level of precision.

## Clock

<Badge color="blue">v1.0.0</Badge> | *Storybook link coming soon*

### When to use

* Time-only input where a visual selector is clearer than free text.
* Paired with [Calendar](/aura-design-system/primitives/calendar) when both date and time are required.

### When not to use

* When only a date is needed, use a [Calendar](/aura-design-system/primitives/calendar) instead.

Dos and don'ts

* Do match the clock format (12hr/24hr) to the user's locale or application setting — don't hardcode one.
* Do include AM/PM selection clearly when using 12-hour format; ambiguity here causes real errors.
* Don't include seconds unless the context requires it (log timestamps, precise scheduling) — it adds complexity most users don't need.
* Don't use Clock for time range input — pair two instances with clear "start" and "end" labels, or use a dedicated range primitive.

### Behavior

* When paired with [Calendar](/aura-design-system/primitives/calendar), the date and time should feel like one composed input — changes to either should update a single combined value, not two separate ones.
* If the time value has constraints (e.g. only future times, business hours only), disable invalid times rather than letting users select them and fail on submit.

### Often used with

* [Calendar](/aura-design-system/primitives/calendar) when both date and time are required and [DateTimePicker](/aura-design-system/primitives/date-and-time-picker).