Date & Time

Type key: date_time_picker. Renders a combined date and time picker. In the editor this is the Date & Time block.

A question: the question rules apply, and it can sit in a layout row column.

Meta fields

The meta fields of this node type are listed in the request body of Replace the draft document, under pages › nodes, in the date_time_picker tab.

Example

A minimal Date & Time node

{
  "public_id": "nFlt",
  "sort_order": 1,
  "type": "date_time_picker",
  "meta": {
    "question": "<span>When does your flight land?</span>",
    "validation": {
      "required": false
    }
  }
}

Defaults and rules

• The defaults are date_format: "DD/MM/YYYY", time_format: "hh:mm A", time_minute_step: "30", and open date_range and time_range bounds.
• The date fields (date_format, date_range) and the time fields (time_format, time_range, time_minute_step) work as on the Date and Time nodes.
• default_value is { "type": "static", "value": "2026-01-31T09:30:00Z" }, or { "type": "relative" } for the moment the respondent opens the form, snapped to the nearest offered time. A default outside date_range or time_range, or not on an offered time, is ignored.