Time Picker

TimePicker captures time-of-day as OrbitalDateTime anchored to a calendar day.

Users open the trigger and scroll hour, minute, and second columns (with AM/PM when using 12-hour format). The bound value is an OrbitalDateTime on a calendar day — convert at API boundaries via ToUnixSeconds. Set reference_date in TimePickerAppearance when the field starts empty but must resolve to a specific day; common in scheduling forms paired with DatePicker. For date-only fields, use DatePicker instead.

  • Time-of-day fields on forms and filters
  • Scheduling flows paired with DatePicker
  • 12-hour or 24-hour locale-specific time entry
  • Empty time fields that must anchor to a known calendar day via reference_date
  • Bind Option<OrbitalDateTime> via TimePickerBind.
  • Set format, timezone, and reference_date in TimePickerAppearance.
  • Wrap in Field for labeled form layouts.
Default

12-hour picker with hour/minute/second columns and AM/PM controls.

24-hour format

Uses a 0–23 hour column without AM/PM.

Preselected value

Existing OrbitalDateTime renders as initial trigger value.

Reference date fallback

Uses provided reference date when value is currently None.

Disabled

Trigger cannot open when disabled.

Field composition

Typical labeled usage with Field.

OptionBind from plain value

Preview ergonomics for static initialization.

Empty placeholder

Shows placeholder text when no value is selected.