| description | Text displayed as a description of the field below it, default is empty. Availability of the feature depends on the license and may not be available in all deployments. |
|
Date change message (section Other)
| dateRangeValidationText | Text displayed 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 the system date as the default value in the field (default value "false"). |
|
Drop-down list for month/year selection (section Other)
| useDropDownSelector |
Enabled drop-down list for month/year selection (default value "false").
|
|
With time indication (section Other)
| withTime | Set to "true" means that time will appear after the date in the format: 00:00 |
| **Unavailable dates** | disabledDates | A comma-separated list of days (as timestamps) whose selection should be blocked. |
> More information about the component properties: [Common component properties](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow)
## External data source
The control can be populated using a script, and for this we can use an external data source. An external data source can be configured in the Interactions section, and the parameters we can set are:
* service - the service that will provide the data to display in the control
* input parameters - a list of service parameters that can be populated with variables or values from the application
* output parameters - a list of service output parameters that can be mapped to component attributes; the list of available attributes is:
* value - initial value of the control represented by a timestamp. Example: 1739577600000
* disabledDates - a 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 possible dates to choose from. The range is written as two timestamps separated by a comma. Example: 1738800000000,1740009600000
* disabledInputTyping - will it be possible to enter the date? Possible values: true, false.
## Example component settings
Set **Date format** (dateFormat) determines which appearance of the date component will be shown in the application, for example:
| Setting in Eximee Designer | Appearance in the application |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
Year display in the calendar header (section Other)
| showYearInHeadline | The year is displayed next to the month in the calendar (default value "true"). |
|
Selection only from the calendar (section Other)
| disabledInputTyping | Set to "true" means that it will only be possible to select a date 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** the field, by default it is empty. |
|
Initial view (section Other)
| startViewMode | Selection of 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 the 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 the unfocused field is the same as in 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 in the field.
|
{% hint style="info" %}
♿WCAG: [WCAG best practices for low-code dev](https://docs.eximee.com/documentation/documentation-en/budowanie-aplikacji/proces-biznesowy/tworzenie-procesu-biznesowego-w-bpmn-2.0/dobre-praktyki)
{% endhint %}
|
|  |  |
