Date Time Picker (deprecated)

Edit online

Date Time Picker 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 control to a coach or coach view, it has default values and looks like this screen capture in the layout.
Date Time Picker control

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. Data binding for Date Time Picker
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.
Screen size
A configuration property that has the Screen Sizes icon The Screen Sizes icon beside the property name 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.
Table 2. Date Time Picker control configuration properties
Configuration property Description Data type
Show Calendarscreen sizes icon 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 Pickerscreen sizes icon 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 Formatscreen sizes icon 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)