Fields 8 fields you can set on a datePicker control. Every control also takes the shared fields (id, position, span, sync, action).
Fields Field Type Default What it does Look datePickerStylechoice one of 3 compactHow the date and time chooser is drawn
Switches between a small tappable field, a spinning wheel, or a full calendar grid.
compact default a small field that opens a pop-up when tapped wheel spinning columns you scroll to pick graphical a full month calendar shown inline Shows datePickerModechoice one of 3 dateAndTimeWhether you choose a day, a time of day, or both
Chooses which parts can be picked: the day only, the clock time only, or both together.
date day month and year only time hour and minute only dateAndTime default both a day and a clock time Earliest date dateMintext — The earliest day that can be chosen
Greys out and blocks dates before this ISO 8601 moment, such as 2026-01-01T00:00:00Z.
Latest date dateMaxtext — The latest day that can be chosen
Greys out and blocks dates after this ISO 8601 moment, such as 2026-12-31T23:59:59Z.
Label labeltext — The name shown beside the picker
Writes this text next to the date or time field.
Color tintcolor #667eeaThe accent color of the picker
Colors the selected day and highlights in the picker with this color.
Starting date defaultValuetext — The date or time shown before anyone picks
Starts the picker on this ISO 8601 moment when the layout first appears.
Vibration on change hapticchoice one of 7 selectionThe buzz you feel when the value changes
Plays this haptic on the phone each time a new date or time is chosen.
light a small soft tap medium a medium tap heavy a strong thud success the double tap of a success warning a two-pulse warning error a sharp triple buzz of an error selection default the faint tick of picking an item
Theme fields Restyle one control by setting these in its theme object; a layout's theme sets them for every control.
Theme fields Field Type Default What it does Corner roundness theme.cornerRadiusnumber 0–30 pt step 1 12The color of the card outline
Colors the line around the card with this color.
Border width theme.borderWidthnumber 0–5 pt step 0.5 1How big the label text is
Sets the label text size from 8 to 24 points.
Emits and receives What this control sends when you use it, and what it can show or follow when data arrives.
Emits Emits Sends When Type What it sends When you change the date or time valuechange date the date and time you set, as an ISO 8601 string
Example: 2026-01-01T00:00:00Z
Receives Receives Takes From Type What it does value followhub, mqtt, http, store, default date an ISO 8601 date and time to show
the picker jumps to that date and time without sending anything; your next change replaces it
Example: 2026-01-01T00:00:00Z
Examples 5 examples, each one a control you can paste into a layout.
Shows time-only mode with an action. Intended effect: picking a time sends it as an ISO 8601 string to set an alarm.
JSON 10 lines Copy {
"type": "datePicker",
"id": "alarm-time",
"position": [0, 0],
"span": [1, 2],
"datePickerMode": "time",
"datePickerStyle": "compact",
"label": "Wake Up",
"action": { "method": "meshsocket", "mode": "broadcast", "event": "broadcast_request", "payload": { "msg_type": "set_alarm", "time": "{{value}}" } }
}Open in CAR-TER ↗
Rendered by the app Light Dark Shows the graphical calendar with dateMin and dateMax. Intended effect: a full month grid where only days in 2026 can be chosen.
JSON 11 lines Copy {
"type": "datePicker",
"id": "vacation-start",
"position": [0, 0],
"span": [2, 4],
"datePickerMode": "date",
"datePickerStyle": "graphical",
"label": "Start Date",
"dateMin": "2026-01-01T00:00:00Z",
"dateMax": "2026-12-31T23:59:59Z"
}Open in CAR-TER ↗
Rendered by the app Light Dark Shows the wheel look in dateAndTime mode with a starting value. Intended effect: spinning columns for day and clock time that begin on 15 June 2026 at 09:30.
JSON 10 lines Copy {
"type": "datePicker",
"id": "meeting-wheel",
"position": [0, 0],
"span": [2, 4],
"datePickerMode": "dateAndTime",
"datePickerStyle": "wheel",
"label": "Meeting",
"defaultValue": "2026-06-15T09:30:00Z"
}Open in CAR-TER ↗
Rendered by the app Light Dark Shows date mode in the default compact look with a custom accent. Intended effect: a small field that opens a calendar pop-up in green.
JSON 9 lines Copy {
"type": "datePicker",
"id": "due-date",
"position": [0, 0],
"label": "Due",
"datePickerMode": "date",
"datePickerStyle": "compact",
"tint": "#34c759"
}Open in CAR-TER ↗
Rendered by the app Light Dark Shows haptic and confirm. Intended effect: each new time gives a success buzz and a 3-second pill with Undo.
JSON 10 lines Copy {
"type": "datePicker",
"id": "feed-time",
"position": [0, 0],
"label": "Feeding",
"datePickerMode": "time",
"haptic": "success",
"confirm": true,
"action": { "method": "meshsocket", "mode": "send", "event": "route_msg_noreply", "payload": { "target_name": "feeder", "type": "schedule", "payload": { "at": "{{value}}" } } }
}Open in CAR-TER ↗
Rendered by the app Light Dark Try it on your phone carterkit serves a small hub on your computer and pushes one example to CAR-TER on your iPhone or iPad. Pair once with the code it prints.
Install the Python kit.
Copy pip install carterkit Show “Schedule time picker” on your phone.
Copy carterkit demo datePicker --example 'Schedule time picker' Swap in any example name from this page, or leave --example off for the first one.
carterkit quickstart · Get CAR-TER
Styles
Value
Description
"compact"
Inline date display that expands on tap (default)
"wheel"
Spinning wheel picker
"graphical"
Calendar view for date selection
Modes
Value
Components
"date"
Date only
"time"
Time only
"dateAndTime"
Both date and time
Notes
confirm and haptic only act when the value changes; with no action the picker still keeps its local value
Value is always transmitted as ISO 8601 string (e.g., "2026-06-04T15:30:00Z")
The {{value}} substitution in actions outputs the ISO string
Generated from ControlDocs/date-picker.md. Something unclear or missing? Tell me .