Functional explanation
DateTimePickerObject is an interactive picker for date, time, or combined date-time values. It reads and writes a datetime variable directly from the page.
It is used when the operator must select a structured time value instead of typing a free-form string. The control can be configured for different display and input modes so it matches the required process or schedule format.
Use it for timestamps, start and end times, and any setting that must remain a valid datetime value.
Object name
Set the object name shown in the datetime picker decorator context.
| Setting | Description | Example | Units |
|---|---|---|---|
| Object Name | Name used to identify the DateTimePicker object. | ShiftStartPicker | Text |
No rows match the filter.
Variable
Configure the datetime variable bound to the picker.
| Setting | Description | Example | Units |
|---|---|---|---|
| Variable | Datetime variable or expression bound to the picker. | PLC1.ShiftStart | Expression |
No rows match the filter.
Settings
Configure the date and time mode, formatting, and picker colors.
13 rows
| Setting | Description | Example | Units |
|---|---|---|---|
| Mode | Picker mode such as DateTime. | DateTime | Mode |
| Display Format | Text format shown in the control. | yyyy-MM-dd HH:mm:ss | Format string |
| Is Utc | Treats values as UTC when true. | false | Boolean |
| Text Color | Base text color for the picker display. | #212529 | Color |
| Background Color | Base background color for the picker display. A gradient can be used here as well as a single color; see the Gradients section of the Color Library article. | #FFFFFF | Color |
| Picker Background Color | Base picker calendar background color. | #FFFFFF | Color |
| Picker Text Color | Base picker calendar text color. | #212529 | Color |
| Selected Background Color | Selected value background color. | #0d6efd | Color |
| Selected Text Color | Selected value text color. | #FFFFFF | Color |
| Today Background Color | Today marker background color. | #0d6efd | Color |
| Today Text Color | Today marker text color. | #FFFFFF | Color |
| Hover Background Color | Hover state background color. | #f3f3f3 | Color |
| Hover Text Color | Hover state text color. | #6c757d | Color |
No rows match the filter.
Text
Configure the text appearance of the date and time shown in the DateTimePicker object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Font Family | Font family used for the displayed date and time. | Arial | Font family name |
| Font Align | Horizontal alignment of the displayed date and time: Left, Center or Right. | Left | Selection |
| Font Weight | Font weight used for the displayed date and time. | 400 | CSS font weight |
| Font Size | Font size used for the displayed date and time. A number without a unit is applied in px. | 14 | px |
| Padding | Space between the border and the displayed date and time. Enter one to four values in the order top, right, bottom, left, for example 4 8 for 4 px at the top and bottom and 8 px at the left and right. A number without a unit is applied in px. | 4 8 | px |
No rows match the filter.
Position / Size
Configure the position and size of the DateTimePicker object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Top | Top position of the object. | 100 | px |
| Left | Left position of the object. | 220 | px |
| Width | Width of the object. | 220 | px |
| Height | Height of the object. | 32 | px |
| Z-index | Layer order of the object. Higher values appear in front of lower values. | 10 | Number |
No rows match the filter.
Border
Configure the border styling for the DateTimePicker object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Border Color | Border color used for the picker. | #CED4DA | Color |
| Border Color States | Dynamic border color state rules JSON array. | [{"state":"alarm","color":"#dc3545"}] | JSON array |
| Border Width | Border width used for the picker. | 1 | px |
| Border Radius | Corner radius of the picker border. | 4 | px |
| Border Visibility | Expression controlling whether the border is visible. | SYSTEM.UserGroups == "Operators" | Expression |
| Border Blink | Expression or boolean controlling border blinking. | PLC1.AlarmActive | Boolean or expression |
| Border Blink Speed | Blink speed used for the border. | 500 | ms |
| Border Blink Offset | Blink offset used to stagger border blinking between objects. | false | Boolean |
No rows match the filter.
Animate Position / Size
Configure the runtime animation settings for height, width, top, and left of the DateTimePicker object.
22 rows
| Setting | Description | Example | Units |
|---|---|---|---|
| Animate Height Variable | Variable or expression that drives runtime height animation. | PLC1.Level | Variable or expression |
| Animate Height Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Height Maximum Raw | End of the raw value span. The animated height reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Height Minimum px | Start of the pixel span. The animated height runs from 0 px up to the difference between Maximum px and Minimum px. | 20 | px |
| Animate Height Maximum px | End of the pixel span. With Minimum px at 0, this is the height at full scale. | 60 | px |
| Animate Height Reverse | Sets the edge the height grows from. Cleared grows the object upwards from the bottom edge, which suits level and fill graphics. Selected grows it downwards from the top edge. | false | Boolean |
| Animate Width Variable | Variable or expression that drives runtime width animation. | PLC1.Value | Variable or expression |
| Animate Width Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Width Maximum Raw | End of the raw value span. The animated width reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Width Minimum px | Start of the pixel span. The animated width runs from 0 px up to the difference between Maximum px and Minimum px. | 80 | px |
| Animate Width Maximum px | End of the pixel span. With Minimum px at 0, this is the width at full scale. | 220 | px |
| Animate Width Reverse | Sets the edge the width grows from. Cleared grows the object to the right from the left edge. Selected grows it to the left from the right edge. | false | Boolean |
| Animate Top Variable | Variable or expression that drives runtime top-position animation. | PLC1.PositionTop | Variable or expression |
| Animate Top Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Top Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Top Minimum px | Start of the pixel span. A rising value moves the object upwards from its resting position by up to the difference between Maximum px and Minimum px. To move the object downwards, set Minimum px above Maximum px. | 100 | px |
| Animate Top Maximum px | End of the pixel span. A rising value moves the object upwards by up to the difference between Maximum px and Minimum px. | 260 | px |
| Animate Left Variable | Variable or expression that drives runtime left-position animation. | PLC1.PositionLeft | Variable or expression |
| Animate Left Minimum Raw | Start of the raw value span. The animation scales the variable value across the difference between Maximum Raw and Minimum Raw, so keep this at 0 for a direct mapping from 0 to the Maximum Raw value. | 0 | Raw value |
| Animate Left Maximum Raw | End of the raw value span. The offset reaches full scale when the variable value reaches the difference between Maximum Raw and Minimum Raw. | 100 | Raw value |
| Animate Left Minimum px | Start of the pixel span. A rising value moves the object to the right from its resting position by up to the difference between Maximum px and Minimum px. To move the object to the left, set Minimum px above Maximum px. | 200 | px |
| Animate Left Maximum px | End of the pixel span. A rising value moves the object to the right by up to the difference between Maximum px and Minimum px. | 420 | px |
No rows match the filter.
Access Control
Configure access control for the DateTimePicker object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Access Control Enable | Enables access control evaluation for the object. | true | Boolean |
| Access Control | Expression controlling who can use or see the object. | SYSTEM.UserGroups == "Operators" | Expression |
| Access Control Filter | CSS filter applied when access control is used to alter the object appearance. | blur(0px) contrast(30%) | CSS filter |
No rows match the filter.
Visibility
Configure the runtime visibility and blinking behavior for the DateTimePicker object.
| Setting | Description | Example | Units |
|---|---|---|---|
| Visibility | Expression controlling whether the object is visible. | PLC1.PickerVisible | Expression |
| Blink | Expression or boolean controlling picker blinking. | PLC1.AlarmActive | Boolean or expression |
| Blink Speed | Blink speed used during runtime. | 500 | ms |
| Blink Offset | Blink offset used to stagger blinking between objects. | false | Boolean |
No rows match the filter.