TimeDifference has two inputs (In1 and In2), each requiring an absolute time (AbsTime) value. The TimeDifference component
subtracts In2 from In1, and outputs it as a StatusNumeric, in milliseconds. You may link a CurrentTime object to one of the inputs for a “countdown” or “count-up” type output.
The following types of properties are used in the TimeDifference component:
-
Out
This property displays the numeric value (in milliseconds) that represents the time difference between In1 property value and In2 property value.
-
In1
This is the property value from which In2 is subtracted.
-
In2
This is the property value that is subtracted from In1.
Figure 48, shows an example use of the TimeDifference component:
Note the following about the example wiresheet view in Figure 48:
-
This example shows the configuration of a TimeDifference component that is used to keep a running count of the “Days until Christmas”.
-
A fixed target date (December 25) is set into the In1 property.
-
A CurrentTime component is used to link into In2. This date is “subtracted from” the date in In1.
-
The Out value is linked to three separate conversion components that convert the time difference Out value from milliseconds into Weeks, Days, and Minutes.
-
After December 25, the Out value is negative
The TimeDifference component is in the Timer folder of the kitControl palette.