Skip to content

Date Picker#

Screenshot

Assigns a date input to a View State Parameter

The Date Picker will highlight dates found in the Data Source

Set up#

  1. Assign a view state with a data type containing a date to the Selected Date property.
  2. Optionally set data source with Date data

Basics#

Screenshot

Name
A name for the component provided by the user.
Label
Text label presented with the component in the Dashboard.
Data Source

Data sources Optionally set a list of valid dates that can be chosen by the user. When set, the list of dates in the data source identifies the range of dates presented by the date picker component.

Resulting data

The date picker data source must return values of kdb type "date".

Selected Date
A View State Parameter with a data type containing a date
Horizontal
Horizontal alignment (left, center or right) of date selector inside the component boundaries
Vertical
Vertical alignment (top, middle, bottom) of date selector inside the component boundaries
Tooltip
Text description which appears when user mouses over the Date Picker
Width
Pixel width of dropdown
Label Width

Pixel width of dropdown Label

Tip

If assigned Label Width is narrower than the Label description, text in the Label will wrap.

Validation#

The date picker will verify its value to ensure that it is suitable for use and present an error label if it is not. This inherent validation occurs as the user is typing, when navigating to a different area of the Dashboard, and upon initialization. If the value is not valid, the Selected Date property will not be updated, and one of the following error labels will appear:

Invalid date/time

Screenshot

An "Invalid date/time" error label will appear when the value does not represent an actual calendar day (i.e. '00' for the day) or its time component does not represent an actual time (i.e. '99' for the hour). If the value is not corrected by the user, the date picker will use the previously held value if possible.

Date out of scope

Screenshot

A "Date out of scope" error label will be visible when the date value is not in the list of available dates provided by the date picker data source. This error will remain visible until the user provides a valid value.

Date Picker Validation within a Data Form component#

When using a Date Picker component within a Data Form, date picker validation errors such as "Invalid date/time" or "Date out of scope" must be resolved before the data form validation analytic will execute or the data form can be submitted.

Action#

Actions

Style#

Style for common settings