The Date Control provides a calendar picker to allow agents to easily find and select a date, and optionally a time picker too.
It appears similarly to a Text Box until selected, at which point the picker slides out from it. The agent can then select the desired date and/or time from the picker.
This Control is part of the Basic Control pack, and will always be available.
How To
Add a Date to the Page. The options and style can be configured in the Options tab and Styling tab of the Field Properties, and Validation can be applied if desired.
Date Fields can be styled in a Stylesheet by referencing the control-date class.
The Date Control has nine unique options available in its Options tab:
Option
Description
Date Format
This specifies how the date selected from the calendar picker is then displayed to the agent and stored within Intelligent Agent. It offers a range of options to suit different cultural and usage scenarios.
Minimum Date
Specify the minimum selectable date in YYYY-MM-DD format. Leave blank to not restrict the minimum date. Can reference a Field or Variable, and the value will be evaluated at Page load.
Maximum Date
Specify the maximum selectable date in YYYY-MM-DD format. Leave blank to not restrict the maximum date. Can reference a Field or Variable, and the value will be evaluated at Page load.
Allow Weekends
Choose whether weekend dates (Saturday and Sunday) are selectable.
Change Month
Choose whether a drop-down list is offered to select the month.
Change Year
Choose whether a drop-down list is offered the select the year.
Years In Past
How many years in the past to allow in the year-selection list, back to 1st January of that year. Permissible values can be found in the jQuery API. Note that if the value isn't set to the "c-nn" format, then this can also restrict the Minimum Date. Can reference a Field or Variable, and the value will be evaluated at Page load.
Years In Future
How many years in the future to allow in the year-selection list, up to 31st December of that year. Permissible values can be found in the jQuery API. Note that if the value isn't set to the "c+nn" format, then this can also restrict the Maximum Date. Can reference a Field or Variable, and the value will be evaluated at Page load.
Time Picker
Choose whether to display a time picker for the agent to select the time as well as date.
Notes
Despite its initial appearance, it's not possible to directly type into the Field itself.
If both Minimum Date/Maximum Date and Years In Past/Years In Future are set simultaneously, then the most restrictive range produced from all of the combined options is the one that is used.
