Guide / Controls / Inputs

Date & time

Pick a day or a time

When to use it. A date and/or time selection control. Stores a .string value (ISO 8601 format).

Type
datePicker
Also titled
Date Picker
Default size
1 row × 2 columns
Symbol
calendar
Docs
Docs complete
Search for it as
  • calendar
  • time
  • date
  • schedule
  • clock
  • day
Date & time: Schedule time picker
Rendered by the app

Fields

8 fields you can set on a datePicker control. Every control also takes the shared fields (id, position, span, sync, action).

Fields
FieldTypeDefaultWhat it does
LookdatePickerStylechoiceone of 3compact

How the date and time chooser is drawn

Switches between a small tappable field, a spinning wheel, or a full calendar grid.

  • compact defaulta small field that opens a pop-up when tapped
  • wheelspinning columns you scroll to pick
  • graphicala full month calendar shown inline
ShowsdatePickerModechoiceone of 3dateAndTime

Whether 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.

  • dateday month and year only
  • timehour and minute only
  • dateAndTime defaultboth a day and a clock time
Earliest datedateMintext—

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 datedateMaxtext—

The latest day that can be chosen

Greys out and blocks dates after this ISO 8601 moment, such as 2026-12-31T23:59:59Z.

Labellabeltext—

The name shown beside the picker

Writes this text next to the date or time field.

Colortintcolor#667eea

The accent color of the picker

Colors the selected day and highlights in the picker with this color.

Starting datedefaultValuetext—

The date or time shown before anyone picks

Starts the picker on this ISO 8601 moment when the layout first appears.

Vibration on changehapticchoiceone of 7selection

The buzz you feel when the value changes

Plays this haptic on the phone each time a new date or time is chosen.

  • lighta small soft tap
  • mediuma medium tap
  • heavya strong thud
  • successthe double tap of a success
  • warninga two-pulse warning
  • errora sharp triple buzz of an error
  • selection defaultthe 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
FieldTypeDefaultWhat it does
Corner roundnesstheme.cornerRadiusnumber0–30 ptstep 112

The color of the card outline

Colors the line around the card with this color.

Border widththeme.borderWidthnumber0–5 ptstep 0.51

How 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
SendsWhenTypeWhat it sends
When you change the date or timevaluechangedate

the date and time you set, as an ISO 8601 string

Example: 2026-01-01T00:00:00Z

Receives

Receives
TakesFromTypeWhat it does
valuefollowhub, mqtt, http, store, defaultdate

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.

Schedule time picker

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
{
  "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

Date & time: Schedule time picker
Rendered by the app

Date range picker with bounds

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
{
  "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

Date & time: Date range picker with bounds
Rendered by the app

Wheel look for date and time

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
{
  "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

Date & time: Wheel look for date and time
Rendered by the app

Date only, compact, with tint

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
{
  "type": "datePicker",
  "id": "due-date",
  "position": [0, 0],
  "label": "Due",
  "datePickerMode": "date",
  "datePickerStyle": "compact",
  "tint": "#34c759"
}

Open in CAR-TER

Date & time: Date only, compact, with tint
Rendered by the app

Haptic and confirmation with Undo

Shows haptic and confirm. Intended effect: each new time gives a success buzz and a 3-second pill with Undo.

JSON 10 lines
{
  "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

Date & time: Haptic and confirmation with Undo
Rendered by the app

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.

  1. Install the Python kit.

    pip install carterkit
  2. Show “Schedule time picker” on your phone.

    carterkit demo datePicker --example 'Schedule time picker'
  3. 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.