Skip to content
Version 2026.25

Date / Time Range ​

Picks a start and end time for trends, reports and tables.

In Studio ​

In Studio, double-click Date / Time Range in the Components category of the Components panel. It is added to the open view, where you can drag it into place.

When to use ​

Use Date / Time Range wherever an operator chooses a window: pick presets for quick spans, fields for exact times, calendar for shift and day reports.

Properties ​

PropertyTypeDefaultDescription
LabelStringRangeThe accessible name of the control.
Variantpresets, fields, calendarpresetsHow it looks: presets (default; Custom opens the field picker), fields (exact start and end) or calendar (click a first and last day).
Presets (comma-sep)String1 h,8 h,24 h,7 d,CustomThe preset buttons, comma-separated. A span such as 8 h, 24 h, 7 d or 15 min is relative to the moment it is picked; any other entry (Custom) opens the field picker.
Default PresetString8 hThe preset selected when the screen opens.
Quality Markstandard, dimstandardHow a lost link is marked when a value this component shows has Stale or Bad quality. standard (the default) draws the quality outline and glyph over the value. dim keeps the last good value on screen, faded, with nothing drawn over it: it suits a dense panel where one lost link turns a whole column Bad. The value still reads as not live, and a binding that fails to evaluate keeps its outline either way.

Binding ​

This component has no single value binding.

The range is an OUTPUT: start and end (epoch milliseconds) and preset are published as live values, so a property binding such as {dateRange.start} can feed a Data Table's range, a Named Query parameter or a script. It also fires On Action Performed with the range.