Date Time Picker stock control

This stock control creates an input text field and a calendar to select dates and times for a web form. The picker supports localized calendars, blackout dates, and different presentation options.

When you add a Date Time Picker stock control to a coach or coach view, it has default values and looks like this screen capture in the layout.

Restrictions and limitations

Limitations: Attention: If the user types in content that is not a complete date or not in a valid format, the bound data item is null when the user triggers a boundary event such as clicking a button. If the flow returns to the coach, the control is empty. Any other controls bound to the same data item are also empty.

Data binding

Set the data binding for the control in the General properties tab.

Table 1. Date Time Picker stock control data binding
Binding description	Data type
Contains the initial date and time to display and stores updates to this value.	`Date`

Configuration properties

Set or modify control configuration in the Configuration properties tab.

Configuration properties that have the screen sizes icon can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value. If you are using the Process Designer desktop editor, you are setting the value for the large screen size. The other screen sizes inherit this value.

Table 2. Date Time Picker stock control configuration properties
Configuration property	Description	Data type
Show Calendar	Select how to display the calendar for the picker: `On Click` (default) shows the calendar only when the user clicks the text field or clicks the icon next to the text field. `Inline` shows the calendar inline and hides the input text field. `Never` shows the input text field and hides the calendar	`ShowClalendarSelection`
Calendar Type	Select the type of calendar: `Gregorian` (default) `Hebrew` `Islamic`	`CalendarType`
Include Time Picker	Select whether to add a time picker to the date time picker. The default is to not show the time picker (`False)`. Important: If the Include Time Picker property is set to `False`, the time will default to midnight. Notes: Dates specified without a time have a time portion that is set to midnight in the client's time zone, which may be different from the server's time zone. You should consider this when performing business logic on the server. It is always best to use UTC when doing date/time-based calculations. Be aware that dates that do not change after selection, for example, birth dates, might change between time zones. For example, a birth date selected by a user in the US Eastern time zone might shift to 11 PM the previous day on a server located in the US Central time zone. To avoid this issue, consider using the `String` data type instead of Date.	`Boolean`
Date Format	Set the format used to display and parse text that is entered into the text field, such as `MM/dd/yyyy` or `dd/MM/yyyy`. This configuration option supports the same formats as the Java `SimpleDateFormat`.	`String`
Blackout Dates	Set one or more dates that the user cannot select.	`Date (List)`