Liest die Zeitspur aus einem HistoryBase-Ringspeicher.
Syntax
HistoryBaseReadTime(HistoryBaseFile, Machine, TraceGroup, FromTime, ToTime [ , CalendarTime = TRUE ])
Die Syntax der HistoryBaseReadTime-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
|---|---|
HistoryBaseFile |
Zeichenkette die den Pfad der einzulesenden Ringspeicherdatei angibt. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette (Dateiname). |
Machine |
Name eines Computers im Netzwerk auf dem die angegebene Ringspeicherdatei bereits von einer HistoryBase-Komponente verwendet wird. Dieses Argument kann auch ein leerer Text sein. In diesem Fall wird die HistoryBase-Instanz auf dem ausführenden System gesucht bzw. instanziiert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
TraceGroup |
Name der HistoryBase-Grupppe, deren Zeitpspur gelesen werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. |
FromTime |
Der Zeitpunkt des ersten (ältesten) Zeitwertes, der ausgelesen werden soll. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 32-Bit Ganzzahl, 64-Bit Fließkomma und Kalenderzeit. |
ToTime |
Der Zeitpunkt des letzten (jüngsten) Zeitwertes, der ausgelesen werden soll. Dieser Zeitpunkt muss größer als der in FromTime angegebene Zeitpunkt sein. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 32-Bit Ganzzahl, 64-Bit Fließkomma und Kalenderzeit. |
CalendarTime |
Wahrheitswert, der angibt, dass die Zeitwerte als Kalenderzeiten gelesen werden sollen. Andernfalls werden die Zeiten in Sekunden zurückgegeben, wobei FromTime dem Zeitpunkt 0 entspricht. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert TRUE gesetzt. |
Anmerkungen
Das Ergebnis hat immer die Datenstruktur Datenreihe.
Weisang HistoryBase in Version 4 oder höher muss auf dem ausführenden System und ggf. auf dem in Machine angegebenen System installiert sein. Als Ergebnis wird die Zeit im UTC-Format geliefert.
Ist ein Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
HistoryBaseReadTime("C:\RingBuffer.hbf", "RemoteMachine", '1.1.2010 10:00', '1.1.2010 11:00') |