Forms 2.0 - Time
caution
This page is preliminary and subject to change as Forms 2.0 continues to be developed.
Use to select just the time (no date). It renders with a clock icon that opens an interactive time picker for selecting the time with the mouse, and the time can also be typed directly into the field.
Adding a Time field
Drag the Time tile from the field palette onto the Canvas - see Build for more on adding and arranging fields in general.
Parameters
Only Time-specific parameters are listed below. See Common Field Settings for the settings shared with other field types.
| Field | Description |
|---|---|
| Initial Value | The time to preload. Supports HH:mm, h:mm tt, and Tokens. |
| Time Format Mode | How the time is displayed and entered: Portal Locale (12-hour or 24-hour, based on the portal language), AM/PM (for example 2:20 pm), or 24hr Format (for example 14:20). |
| Minimum Time | The earliest time a user can enter or select (inclusive). Format HH:mm. Supports Tokens. Leave blank to allow all times. |
| Maximum Time | The latest time a user can enter or select (inclusive). Format HH:mm. Supports Tokens. Leave blank to allow all times. |
| Minute Increment | The minute step used by the time picker and scrolling. Defaults to 5. Supports Tokens. |
| Popup Time Picker | When enabled (the default), a pop-up picker is available for click-based time selection. When disabled, the time must be typed directly into the field. |
| Root CSS Classes | One or more CSS class names, separated by spaces, applied to the field's root element only. Supports Tokens. |
Common settings that apply to Time
A Time field supports these Common Field Settings:
- General (Label, Name, and Hint)
- Active
- Visibility settings
- Enabled settings
- Field Automations - Value and On Change (Time does not support On Click)
- Field Validators
Tokens
A Time field returns several tokens, referenced using the field's Name - for example, if the field's Name is AppointmentTime:
| Token | Description |
|---|---|
[AppointmentTime] | The stored time value. |
[AppointmentTime:Hour] | The hour, in 24-hour format. |
[AppointmentTime:Minute] | The minute. |
[AppointmentTime:FormattedTime] | The time formatted using the field's effective time format. |
[AppointmentTime:UtcOffset] | The browser's UTC offset, in minutes. |