Date, Week, Month, Quarter, And Year

Date, week, month, quarter, and year fields use the same date picker configuration. The selected field type controls which calendar unit users choose.

Use these fields when the value should be a calendar date or reporting period instead of a precise date-time moment.

Basic Settings

Setting	Description
Name	The field label shown to users. It is required and should describe the date or period 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 value 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

Date Picker Config

Setting	Description
Placeholder	Prompt text shown before users select a value
Selection Mode	Controls whether users select a single value, a range, or multiple values
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 Boundary	Earliest allowed value for the current picker type
Max Boundary	Latest allowed value for the current picker type
Min Boundary Message	Custom message shown when the value is earlier than the minimum
Max Boundary 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 values
Disable Future	Blocks future values
Disable Today	Blocks today's value
No Weekend	Blocks weekend values
Field Color	Sets the display color used for the field
Help Text	Helper copy shown near the field. Use it to explain date rules or business meaning

Field Type Differences

Field Type	Selection Meaning
Date	One calendar date, date range, or multiple dates
Week	One week, week range, or multiple weeks
Month	One month, month range, or multiple months
Quarter	One quarter, quarter range, or multiple quarters
Year	One year, year range, or multiple years

Configuration Tips

Tip	Description
Match format to picker type	A month field should use a month-style display format, and a year field should use a year-style format
Use range mode for periods	Range mode is useful for start-end date windows or reporting periods
Use readonly input for strict picking	It prevents users from typing values that do not match the expected format
Add boundary messages	Custom messages make date limits easier for users to understand