TimeNE
- Last UpdatedJan 11, 2023
- 1 minute read
- PI System
- PI Server 2018
- PI Server
Find the total time, within a range, when an attribute value is not equal to a specified value. Time returned is in seconds.
Syntax
TimeNE(attname, starttime, endtime, x)
Arguments
-
attname
The name of an attribute with a PI point data reference, enclosed in single quotation marks
-
starttime
time expression representing the beginning of a time range enclosed in single quotes; can be a relative time (such as '-3h') in reference to an absolute endtime
-
endtime
time expression representing the end of a time range enclosed in single quotes; can be a relative time (such as '+1h') in reference to an absolute starttime
-
x
The reference value of the search; must be an enumeration set (string), integer or real number
Returns
The total time (in seconds), within a range, when an attribute value is not equal to a specified value
Exceptions
None
Notes
Bad values are excluded from TimeNE calculation
Example
-
TimeNE('att1', 't', '+1h', 80)
[Find the total time between 12:00 and 1:00am today when 'att1' was not equal to 80]
-
TimeNE('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Find the total time in the past hour when the value of 'att1' was not equal to the value at 8am today. Result is in seconds]
-
TimeNE('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))