FindNE (Tag-based PE function)

Find the first time, within a range, when a point is unequal to a given value.

Syntax

FindNE(tagname, starttime, endtime, value)

Arguments

tagname

A tagname.

starttime

Beginning of the time range to search; time expression or time relative to endtime if endtime is a timestamp.

endtime

End of the time range to search, time expression or time (in seconds) relative to starttime if starttime is a time. If this time is earlier than starttime, the range is searched backwards.

value

Must be an integer or real number or digital state (character string), the value to search for.

Returns

The timestamp closest to starttime, within the given range, for which the point was unequal to the given value.

Exceptions

If the point was always equal to the given value, FindNE returns an error value.

Example

FindNE('tag1', 'y', '*',40.0)

FindNE('tag1', '14-Dec-97', '*',40.0)

FindNE('tag1', '14-Dec-97', 'Monday',40.0)