Date & time, directly
A small input in your form. A celestial experience when you open it. Earth’s revolution selects the day, one chosen planet defines the year range, and Earth’s rotation sets the time. Scrollers and precise −/+ controls share the same picker. Choose the year planet and style every element in settings. Use the header to compare 3D and LCD, switch light or dark appearance, and choose colours. Configure the picker’s units and behaviour below.
Loading the picker configurator…
The form field submits a civil value at the configured precision: a year, year-month, date, time or combined date/time. onChange receives a complete Date or null; hidden units are preserved. Required and range validation integrate with the host form. Controlled fields reset through the host; uncontrolled fields reset to defaultValue. Scroll controls support mouse wheels, trackpads, touch and keyboard input. The 3D components remain available as CelestialDatePicker and CelestialTimePicker, with Jupiter as the default year planet.
Parameters
| Setting | Default | Values |
|---|---|---|
CelestialInput | celestial form input | Celestial scenes, scrolling columns and exact steps together. scene, interactive, planet and complete form configuration. |
CelestialPicker | form field | Compact popover or inline control; nullable value/defaultValue/onChange; name, form, required, clearable and reset support. |
CelestialScrollPicker | standalone | Reusable snapping scroll columns with date/defaultDate/onDateChange or a shared provider. |
CelestialStepper | standalone | Editable units with civil −/+ steps, keyboard support and date rollover. |
units / precision | date | Select any date/time units, including year-only; precision is a convenient finest-unit shorthand. |
steps | 1 | Per-unit increments, including minutes, seconds and years. |
min / max | 1600–2400 | Allowed instants; partial years/months remain selectable when they intersect the range. |
variant | celestial | Textured 3D or a duotone LCD display with flat diagrams and segmented digits. |
colors | theme defaults | Background, text, accent, borders and orbital colours. LCD uses background and foreground as its two inks. |
size / theme | small / dark | 32px, 40px or 44px fields; light, dark or system themes. |
styles / classNames | — | Style every named DOM part, including selected and disabled states. PICKER_PARTS lists the hooks. |
orbitalStyle | — | Canvas palette, stroke weights and planet/Sun sizes. |
popoverPlacement / popoverOffset | auto / 6 | Preferred alignment and gap, with viewport collision handling. |
wheelRowHeight / wheelRows | size / 3 | Scroll geometry; three or five visible rows. |
disabled / readOnly | false | Lock interaction; read-only fields still submit their form value. |
place | Greenwich | Civil-time zone and observer. |