Selecting Date and Time

Note: The following information applies for date/time selectors with a variety of names, for example, Select Install Date for adding meters to your system, Select Filter Starting Date/Time for file imports, or Select Date and Time in many other locations throughout your CygNet applications. The time element is not enabled for every usage.

See Date and Time Wildcards for more information about date and time wildcards used in CygNet applications and dialog boxes.

See Time Zone Page in the Devices section for more information about selecting date and time in remote device editors.

Click on selector icons throughout CygNet to access the date/time selector dialog box to configure date/time information for your specific usage.

Note: In some instances the time fields are not enabled, as they do not apply.

Configuring Date/Time

Dates can be configured as Absolute Date/Time, Relative Date/Time, or Relative Day.

Note: If either Relative Date/Time or Relative Day are used, the applicable Current Time, Adjusted Time, and Relative Time will be displayed at the bottom of the dialog box, as configured by your selections.

Absolute Date/Time

The date selector supports configuring an Absolute Date/Time by defining the Date and Time. In some cases, the time field is dimmed since it does not apply to the current usage.

Date is defined by typing the date directly into the text box in the format mm/dd/yyyy, or by using the drop-down calendar date selector.

Time is defined by clicking to select the portion of the default time you want to change, then either typing the value into the text box in the format HH:MM:SS plus AM/PM, or using the up/down arrows to navigate to the desired value.

Relative Date/Time

The date selector supports configuring a Relative Date/Time offset from the current date/time, for Year, Month, Day, Hour, Minute, and/or Second. In some cases, the time fields are dimmed since they do not apply to the current usage.

Adjustment operators and acceptable Value ranges for the Set Equal option are as follows for each parameter.

Note: The Value field is disabled when None is the selected adjustment operator.

Parameter	Adjustment Operator	"Set Equal" Value Range
Year (y)	None Subtract Add Set Equal	0 - 2100
Month (m)	None Subtract Add Set Equal	1 - 12
Day (d)	None Subtract Add Set Equal Last Day	1 - 31
Hour (H)	None Subtract Add Set Equal	0 - 23
Minute (M)	None Subtract Add Set Equal	0 - 59
Second (S)	None Subtract Add Set Equal	0 - 59

The applicable Current Time, Adjusted Time, and Relative Time will be displayed at the bottom of the dialog box, as configured by your selections.

Relative Day

The date selector supports configuring a Relative Day offset from the current date (Today, also represented as T), for a selected number of Days. In some cases, the time does not appear in the Adjusted Time field since it does not apply to the current usage.

Options for Adjustment operators include None, Subtract, or Add.

Select Subtract or Add to enable the Value field, then type the number of Days into the value text box.

The applicable Current Time, Adjusted Time, and Relative Time will be displayed at the bottom of the dialog box, as configured by your selections.

The result will appear as T-7 to represent a data view from "7 days earlier than (before) Today."

Relative Time Dialog Box Scripting

The following scripting options are available for data interface functions related to the Relative Time dialog box.