Reads a section of a time trace from a HistoryBase ring buffer.
Syntax
HistoryBaseReadTime(HistoryBaseFile, Machine, TraceGroup, FromTime, ToTime [ , CalendarTime = TRUE ])
The syntax of the HistoryBaseReadTime function consists of the following parts:
Part |
Description |
|---|---|
HistoryBaseFile |
String with the path of the ring buffer file to be read. Permitted data structures are Scalar value. Supported data types are String (file name). |
Machine |
Name of a computer in the network on which the specified ring buffer file is already being used by a HistoryBase component. This argument can also be an empty text. In this case, the HistoryBase instance of the ring buffer will be searched or, if necessary, instantiated on the executing machine. Permitted data structures are Scalar value. Supported data types are String. |
TraceGroup |
Name of the trace group whose time trace should be read. Permitted data structures are Scalar value. Supported data types are String. |
FromTime |
The date and time of the first (oldest) time value to be read. Permitted data structures are Scalar value. Supported data types are 32-bit integer, 64-bit floating point und Calendar time. |
ToTime |
The date and time of the last (most recent) time value to be read. This date and time must be greater than the date and time specified in FromTime. Permitted data structures are Scalar value. Supported data types are 32-bit integer, 64-bit floating point und Calendar time. |
CalendarTime |
Boolean value specifying that the time data are to be read as calendar times. Otherwise, the time is provided in seconds where FromTime corresponds to zero. Permitted data structures are Scalar value. Supported data types are Boolean value. If this argument is omitted, it will be set to the default value TRUE . |
Remarks
The result always has the data structure Data series.
Weisang HistoryBase version 4 or higher has to be installed on the executing system and, if applicable, on the system specified by Machine. The result is provided in UTC time format.
If an argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.
Available in
FlexPro View, Basic, Professional, Developer Suite
Examples
HistoryBaseReadTime("C:\RingBuffer.hbf", "RemoteMachine", '1.1.2010 10:00', '1.1.2010 11:00') |