FindLT (Tag-based PE function)

Find the first time, within a range, when a point is less than a given value.

Syntax

FindLT(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 time.

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 less than the given value.

Exceptions

If the point was never less than the given value, FindLT returns an error value.

Notes

FindLT interpolates between Archive events, if necessary, to find the value it is looking for.

Example

FindLT('tag1', 't', 3600,40.0)

FindLT('tag1', -1h, '*',40.0)

FindLT('tag1', '14-Dec-97 01:00:00.0001, '*',40.0)