Lee el registro de tiempo desde un búfer circular de HistoryBase.
Sintaxis
RingBufferReadTime(HistoryBaseFile, Machine, FromTime, ToTime, [ CalendarTime = TRUE ] [ , SubRate = 1 ])
La sintaxis de la función RingBufferReadTime consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
HistoryBaseFile |
Cadena que especifica la ruta del archivo de búfer circular que se va a leer. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena (nombre del archivo). |
Machine |
Nombre de un ordenador de la red en el que el archivo de búfer circular especificado ya está siendo utilizado por un componente de HistoryBase. Este argumento también puede ser un texto vacío. En este caso, la instancia de HistoryBase es buscada o instanciada en el sistema ejecutor. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. |
FromTime |
El instante del primer valor de tiempo (el más antiguo) que se va a leer. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Entero de 32 bits, En coma flotante de 64 bits y Tiempo de calendario. |
ToTime |
El instante del último valor de tiempo (el más joven) que se va a leer. Este instante debe ser posterior al instante especificado en FromTime. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Entero de 32 bits, En coma flotante de 64 bits y Tiempo de calendario. |
CalendarTime |
Valor booleano que especifica que los valores de tiempo deben leerse como tiempos de calendario. En caso contrario, los tiempos se devuelven en segundos, donde FromTime corresponde al instante 0. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Se establece el valor predeterminado TRUE si no se especifica el argumento. |
SubRate |
Valor entero que especifica el factor de subtacto. La pista de tiempo se reduce según el subtick especificado para proporcionar los valores de tiempo de un registro de un grupo con un factor de subtacto. Este parámetro solo se evalúa cuando se utiliza con HistoryBase 3 o superior. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos enteros. El valor debe ser mayor o igual que 1. Se establece el valor predeterminado 1 si no se especifica el argumento. |
Notas
El resultado siempre tiene la estructura de datos Serie de datos.
La versión 2.4 o superior de Weisang HistoryBase debe estar instalada en el sistema de ejecución y, en su caso, en el sistema especificado en Machine. Como resultado, se devuelve la hora en formato UTC.
Si un argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
RingBufferReadTime("C:\RingBuffer.rbf", "RemoteMachine", '1.1.2010 10:00', '1.1.2010 11:00') |