Liefert den Zeitpunkt des ersten (ältesten) verfügbaren Messwerts aus einem HistoryBase-Ringspeicher.
Syntax
HistoryBaseFirstTime(HistoryBaseFile, [ TraceGroup = "" ] [ , Machine = "" ])
Die Syntax der HistoryBaseFirstTime-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). |
TraceGroup |
Name der HistoryBase-Grupppe, deren Zeitpspur zugrunde gelegt werden soll. Wenn die Gruppe nicht angegeben wird, wird die erste Zeit aller HistoryBase-Gruppen zurückgeliefert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert "" gesetzt. |
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. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert "" gesetzt. |
Anmerkungen
Das Ergebnis hat immer die Datenstruktur Einzelwert.
Weisang HistoryBase in Version 4 oder höher muss auf dem ausführenden System und ggf. auf dem in Machine angegebenen System installiert sein. Wenn der Ringspeicher aktuell beschrieben wird hält die Funktion einen dynamisch berechneten Sicherheitsabstand ein, damit der gelieferte Zeitpunkt für eine gewisse Zeit als Anfangszeitpunkt für die Funktionen HistoryBaseRead und HistoryBaseReadTime verwendet werden kann.
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
HistoryBaseFirstTime("C:\HistoryBase.hbf", "RemoteMachine") |