show / hide menu

DateTimePicker

The datetimepicker allows you to display a calendar control from where the user can select the date. This control can also be extended to capture the time (Hour:Minutes:Seconds).

Control Name: DatePicker
Group: Standard

General
S.NoProperty NameData TypeDescription
1Control NameString  Specifies the unique identifier for the datetimepicker control within a form. 
2Control TypeString  Indicates the type of control.  
3ID  IntegerIdentifies a control in the form 
4Date Format  String  Specifies how the date value is displayed in the Date-Time Picker (DTP) control. 
5Time PickerBooleanDisplays a time picker to the right side of the DateTimePicker when the checkbox is checked. This helps to give time as an input in the format of hh:mm:ss AM/PM
6TooltipStringThe texts that need to be displayed when the user hover the mouse pointer over the control, without clicking it.
7Tab IndexIntegerSets the Tab order for the control within its container.
8RemarksStringTo add descriptive notes or comments for a DTP control.
9Check DirtyBooleanUsed to indicate whether the control’s value has changed 
10SendAsJson  BooleanWhen enabled (true), the value of the Date-Picker control is included/sent in the form submission payload as a JSON object, rather than as a simple string or single value.  
11Enable Mask  Boolean When set to True, the user input is constrained to the specified date format pattern (for example “dd/MM/yyyy”) while typing. When set to False (default), the input behaves as free text or standard date‑picker behaviour (selecting from calendar/time‑picker)  
12Start Date  DateSpecifies the initial date that the Date‑Picker control displays when the form is rendered.
13End Date  DateSpecify the latest date that can be selected by the control. When set, the picker will restrict user input to dates on or before this value.
Style
S.NoProperty NameData TypeDescription
14WidthIntegerSets the suggested width or thickness of the control. It determines the horizontal size of the DTP.
15HeightIntegerSets the suggested height of the control. This specifies how tall the DTP appears in the form.
16MarginIntegerDefines the outer spacing around the DTP control.
17PaddingIntegerSpecifies the internal spacing between the content text of the DTP and its borders.
18Box ShadowIntegerSpecifies the shadow effect applied to the DTP control’s border.
19Enable Custom FontBooleanSpecifies whether the DTP control should use a custom font instead of the default system font. On enabling this, the “Font” property below will change to “Custom Font” where the font can be provided.
20FontStringSets the font style of the text on the DTP.
21Custom FontStringSets the custom font style of the text on the DTP. This will be available only on enabling “Enable Custom Font” property.
22Font SizeIntegerSpecifies the size of the text displayed on the DTP.
23Font ColorStringSpecifies the color of the text displayed on the DTP.
24Background ColorStringSpecifies the color that fills the DTP background area.
25VisibleBooleanSets the visibility of the DTP while rendering.
26EnableBooleanSets the accessibility of DTP during rendering.
27BoldBooleanTo make the control text Bold.
28ItalicBooleanItalicize the control text.
29Column SpanIntegerSpecifies how many columns a DTP should occupy in a grid.
30Corner RadiusIntegerSpecifies the roundness of the DTP corners. It allows the DTP to have rounded edges instead of sharp, square corners, enhancing the visual style and modern look of the UI.
31Enable BorderBooleanDetermines whether the border of the DTP is displayed. When set to true, the DTP shows a visible border according to its border properties (color, thickness, and style).
32Border ThicknessIntegerSets the border thickness on enabling the “Enable Border” property.
33Border StyleStringThe border style can be chosen from the listed options on enabling the “Enable Border” property.
34Border ColorStringThe border style can be chosen by enabling the “Enable Border” property.
Attached Label
S.NoProperty NameData TypeDescription
35Show LabelBooleanTo display the attached label along with the control.
36Label TextStringSets the text displayed next to the DTP. 
37Label PositionStringTo place the label attached in various positions around the control.
38Label WidthIntegerSets the suggested width or thickness of the label attached to the control.
39Label HeightIntegerSets the suggested height of the label attached to the control.
40Text AlignmentStringTo align the texts inside the label attached to different positions within the control. It controls whether the DTP label text appears left, center, or right aligned.
41VTextAlignment  StringDetermines the vertical positioning of text content within the attached label of DTP is editable or display area. 
42MarginIntegerDefines the space between the label and surrounding elements. 
43Padding  IntegerDefines the amount of space between the attached label content (text or selected item) and the inside edges (borders) of the control. 
44Box Shadow  IntegerDefines the shadow effect that appears around the edges of an attached label. 
45FontStringDetermines the appearance of the text displayed next to the DTP. 
46Font SizeStringSets the size of the text in the label attached to a DTP. 
47BoldBooleanTo make the attached label text Bold.
48ItalicBooleanItalicize the attached label text.
49UnderlineBooleanUnderline the attached label text.
50Font ColorStringSets the color of the text in the label attached to a DTP.
51Background ColorStringDetermines the color displayed behind the DTP including its box and the area around it. 
52Enable Border  BooleanDetermines whether a visible border is displayed around the attached label of DTP control. 
Rules
S.NoProperty NameData TypeDescription
53RulesAfter selecting the control, If the user clicks the Rules tab it will be expanded and displays a Rules property. Create Rule can be selected from a drop down list. On clicking the Create Rule link button will navigate the user to the Rules Engine. The same control will be added as a trigger by default to execute the Rule.
Validation
S.NoProperty NameData TypeDescription
54Is RequiredBooleanHelps to check whether the user has to give input in the control or not. If this property is enabled, this will not allow the user to save a form without giving the input.
55Required MessageStringIf the Is Required property was enabled and input was given in this property, the validation message will be displayed to the next right of the control when the user is trying to save a form without entering a value in the control.
56Message Position  StringThe Message Position property of a DTP control determines where validation messages appear relative to the control.  
57 Invalid Message String An invalid message is displayed based on the value provided in the Invalid Message property when the user enters an invalid date format in DateTimePicker. Keeping this empty will not throw invalid message.
Reports
S.NoProperty NameData TypeDescription
58Control ReportControl Report will redirect to the Reports tab that will display all the configurations, rules and datasources details associated with the selected control.
Template
S.NoProperty NameData TypeDescription
59Inherit TemplateBooleanSpecifies whether the DTP control should inherit the visual and behavioral template from a parent or base template.
Custom Style
S.NoProperty NameData TypeDescription
60CSS ClassStringThis enables the DTP to adopt predefined styles from CSS, providing flexibility in visual appearance and behavior.
Custom Property
S.NoProperty NameData TypeDescription
61HTML AttributeStringThe HTML Attribute property of a DTP control allows you to add custom HTML attributes to the control’s underlying HTML element.
Responsive Options
S.NoProperty NameData TypeDescription
62Template NameStringRepresents the template name of the control shown in the Responsive UI configuration. The template name is the same as the control’s name.