TimestampFormatting Funktion

Alternativ zur internen Formatierungsfunktion kann eine benutzerdefinierte Formatter-Funktion erstellt werden, um den Zeitstempel zu formatieren. Die Funktion erhält den Zeitstempel des Bildes und gibt einen formatierten String zurück, der in der Bildliste angezeigt wird. Das folgende Beispiel zeigt, wie eine solche Funktion angelegt wird und welche Schnittstellen diese haben muss.

Die allgemeine Verwendung von Funktionen wird in der HMI-Dokumentation erklärt.

Nach dem Erstellen der Typescript Funktion muss ein Parameter vom Typ „Number“ angelegt werden. Dieser bekommt den Zeitstempel analog zur ImageTimestamp-Eigenschaft des ImageWatch-Controls übergeben.

Die Funktion muss einen Wert vom Typ „String“ zurückgeben, der dann in der Bildliste angezeigt wird. Die Funktion wird pro Listeneintrag immer dann aufgerufen, wenn ein neuer Zeitstempel angezeigt werden muss.

Im folgenden Codebeispiel wird der Zeitstempel in ein lokales Datumsformat mit Uhrzeit umgewandelt und zurückgegeben.

namespace TcHmi {
    export namespace Functions {
        export namespace TcHmiProject {
            export function Formatter(timestamp: number) {
                return new Date(timestamp).toLocaleString();
            }
        }
    }
}
TcHmi.Functions.registerFunctionEx('Formatter', 'TcHmi.Functions.TcHmiProject', TcHmi.Functions.TcHmiProject.Formatter);

Um eine selbsterstellte Formatter-Funktion zu benutzen, klicken Sie bei der TimestampFormat-Eigenschaft auf den Auswahl-Button und wählen in dem Function Editor ihre soeben erstellte Funktion aus.