Skip to main content

Time

The time field allows users to input time values in a 24-hour format (HH:mm). It supports validation for format, range, and other constraints.

Example

fields:
  meeting_time:
    type: time
    label:
      en: Select Meeting Time
      de: Wählen Sie eine Besprechungszeit
    min: "09:00"
    max: "17:00"

Field Properties

Name Type Default Description
aria string

Optional aria label for better accessibility.

autofocus bool false

Set autofocus on field.

error string | array

Costum error message for translation or customization.

help string | array

Optional help text below the field

label string | array

The field label can be set as string or associative array with translations

max string

Defines the latest selectable time. Must be in the format HH:mm (e.g., "17:00" for 5 PM).

min string

Defines the earliest selectable time. Must be in the format HH:mm (e.g., "09:00" for 9 AM).

placeholder string | array

Optional placeholder value that will be shown when the field is empty.

required bool

Defines whether the field is mandatory for form submission.

step string

This property is not used in the validation code and thus does not apply here. For example 1800 for 30 minutes.

title string | array

Tooltip displayed when the user hovers over the field (supports multilingual configurations).

width string 1/1

The width of the field in the 12 columns field grid.

Validation Logic

The time field enforces the following rules:

  • Valid Time Format: The input must be in a valid 24-hour format (HH:mm). For example, 09:30 is valid, but 9:3 or 25:00 is not.
  • Minimum Time min: If defined, the input time cannot be earlier than the specified min.
  • Maximum Time max: If defined, the input time cannot be later than the specified max.