Datetime

Datetime fields store one date-time value or a date-time range. They are used when the selected value must include both calendar date and time.

Use a datetime field for deadlines, appointments, completion moments, event starts, or any workflow that depends on an exact time.

Basic Settings

Setting	Description
Name	The field label shown to users. It is required and should describe the date-time meaning 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 date and time before the record can be saved
Readonly	Shows the selected value but prevents users from changing it
Disabled	Makes the field unavailable for normal use
Hidden	Stores the value while hiding it from normal form pages

Setting	Description
Placeholder	Prompt text shown before users select a value
Selection Mode	Controls whether users select a single value or a range
Format	Display format for the selected value
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 Datetime	Earliest allowed date and time
Max Datetime	Latest allowed date and time
Min Datetime Message	Custom message shown when the value is earlier than the minimum
Max Datetime Message	Custom message shown when the value is later than the maximum
Weekend Message	Custom message shown when weekend selection is blocked
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
Input Readonly	Prevents manual typing and requires picker selection
Disable Past	Blocks past date-time values
Disable Future	Blocks future date-time values
No Weekend	Blocks weekend date-time values
Field Color	Sets the display color used for the field
Help Text	Helper copy shown near the field. Use it to explain deadlines or time rules

Scenario	Suggested Config
Deadline	Single mode, disable past, custom max message when needed
Appointment	Single mode, readonly input, clear display format
Service window	Range mode, range start and end both required
Escalation time	Single mode, help text explaining the trigger

Tip	Description
Use datetime only when time matters	If users only need a day, use a date field
Set boundaries for workflow rules	Min and max datetime limits prevent values outside the process window
Use range mode for windows	Range mode is suitable for maintenance windows, appointments, and time spans