Time
Time fields store one time-of-day value or a time range. They do not store a calendar date.
Use a time field for daily schedules, cutoff times, shift times, appointment windows, or any value that repeats by time of day.
Basic Settings
| Setting | Description |
|---|---|
| Name | The field label shown to users. It is required and should describe the time clearly |
| API Name | The stable technical name used by data APIs, scripts, formulas, imports, and integrations. It is required |
| Required | Requires users to select a time before the record can be saved |
| Readonly | Shows the selected time but prevents users from changing it |
| Disabled | Makes the field unavailable for normal use |
| Hidden | Stores the time while hiding it from normal form pages |
Time Field Config
| Setting | Description |
|---|---|
| Placeholder | Prompt text shown before users select a time |
| Selection Mode | Controls whether users select a single time or a time range |
| Format | Display format for the selected time |
| Range Start Allow Empty | Allows the start value of a range to be empty |
| Range End Allow Empty | Allows the end value of a range to be empty |
| Min Time | Earliest allowed time |
| Max Time | Latest allowed time |
| Min Time Message | Custom message shown when the value is earlier than the minimum |
| Max Time Message | Custom message shown when the value is later than the maximum |
| Hour Step | Hour interval shown by the picker |
| Minute Step | Minute interval shown by the picker |
| Second Step | Second interval shown by the picker |
| Validate Trigger | Controls when validation runs: when the value changes, when the field loses focus, or when the record is submitted |
| Input Status | Adds a visual status to the input, such as warning or error |
| Field Color | Sets the display color used for the field |
| Input Readonly | Prevents manual typing and requires picker selection |
| Use 12-Hour Format | Displays time with 12-hour format when enabled |
| Help Text | Helper copy shown near the field. Use it to explain schedule or cutoff rules |
Common Examples
| Scenario | Suggested Config |
|---|---|
| Work shift | Range mode, minute step 15 |
| Daily cutoff | Single mode, format HH:mm |
| Appointment window | Range mode, hour and minute steps matching booking rules |
Configuration Tips
| Tip | Description |
|---|---|
| Use steps to reduce invalid choices | Hour, minute, and second steps keep users inside expected intervals |
| Use range mode for windows | Range mode is clearer for start-end time periods |
| Add min and max time for business hours | Limits such as 09:00 to 18:00 prevent out-of-hours values |