Date - DatePicker

Date picker component

Component properties

Eximee Designer property
Attribute name in Source
Description

Mask presentation (section Styling)

If an input mask is enabled (

Display of mask in the date field (default value "true").

Date format (section Basic properties)

If the field has a custom format set (

Date format. Default set to dd-MM-yyyy. Values from which you can build the date format:

  • yy - last two digits of the year

  • yyyy - year

  • MMMM - full month name

  • MMM - three-letter abbreviated month name (Jan, Feb, Mar etc.)

  • MM - two-digit month number (months 1 to 9 are prefixed with zero)

  • M - month number

  • d - day of the month number

  • dd - two-digit day of the month number (days 1 to 9 are prefixed with zero)

  • EEEE - full name of the weekday

  • EEE or EE - abbreviated weekday name (Mon, Tue etc.)

  • separators e.g. space, dot, hyphen etc.

The default date format for the component follows locale settings.

Note! changing the date format affects how it is displayed in Default value (defaultValue). Any change of format requires fixing the default date.

Date range (section Data quality)

If the field has date selection restrictions (

Narrowing the range of selectable dates. Available options:

  • ALL (all dates)

  • PAST (past dates including today)

  • PAST_WITHOUT_TODAY (past dates excluding today)

  • FUTURE (future dates including today)

  • FUTURE_WITHOUT_TODAY (future dates excluding today)

Date change message (section Other)

dateRangeValidationText

Text shown after changing the date when an invalid value has been entered. The default value is "The date has been changed."

Date set to today (section Other)

defaultValueOnToday

Display in the field as the system date default value (default value "false").

Drop-down for month/year selection (section Other)

useDropDownSelector

Enabled drop-down for month/year selection (default value "false").

With time indicated (section Other)

withTime

Set to "true" means that time in format: 00:00 will appear after the date

Disabled dates

disabledDates

A list of days (as timestamps) separated by commas that should be blocked from selection.

More information about component properties: Common component properties

External data source

We can populate the control using a script; for that we can use an external data source. The external data source can be configured in the Interactions section, and the parameters we can set are:

  • service - the service that will provide data to display the control

  • input parameters - a list of service parameters that we can populate with variables or values from the form

  • output parameters - a list of service output parameters that we can map to component attributes, the list of available attributes is:

    • value - the initial value of the control represented by a timestamp. Example: 1739577600000

    • disabledDates - list of days that the user will not be able to select. The value is a list of timestamps separated by commas. Example: 1739145600000,1739577600000

    • dateRange - range of selectable dates. The range is recorded as two timestamps separated by a comma. Example: 1738800000000,1740009600000

    • disabledInputTyping - will it be possible to type the date? Possible values: true, false.

Example component settings

Set Date format (dateFormat) decides how the date component will be presented on the form, for example:

Setting in Eximee Designer
Appearance on the form

Illustration 1. Other configurations of the example component appearance on the form
Illustration 2. and 3. Example appearance of popups with calendars

Demo form: demoDatePicker

Additional component properties

Eximee Designer property
Attribute name in Source
Description

Display of year in the calendar header (section Other)

showYearInHeadline

In the calendar the year is displayed next to the month (default value "true").

Selection only from calendar (section Other)

disabledInputTyping

Set to "true" means that date selection will be possible only from the popup. It will not be possible to type the date manually into the field. Desktop channel only.

Placeholder (section Data quality)

placeholderText

Text displayed as Placeholder field, by default this is an empty value.

Start view (section Other)

startViewMode

Choosing the "screen" that will appear first after clicking the calendar. Possible values DEFAULT - behavior as before, MULTI_YEAR - display the year selection screen first.

Date format for unfocused field (section Basic properties)

unfocusedFormat

Custom date format for the field that does not have focus.

Allowed formats are the same as in the field with Date format. If the field is empty, then Date format for unfocused field is the same as on the field with Date format. If the field is filled with a format other than Date format, then this value will be visible after leaving the field, and Date format after clicking the field.

Last updated

Was this helpful?