UtcTimeQuality_To_String

Konvertiert die Komponenten des strukturierten Typs T_UtcTimeQuality in einen formatierten UTC-Time-Quality-String. Die Zeichenfolge des resultierenden Strings hat folgenden Aufbau: 'UQ#LFC|A[A]'. Sie entspricht der TwinCAT UTC-Time-Quality-String-Formatspezifikation.

Namensraum: Tc3_Collections
Bibliothek: Tc3_Collections (Tc3_Collections.compiled-library)

Syntax

FUNCTION UtcTimeQuality_To_String : STRING(9)
VAR_INPUT
    in     : T_UtcTimeQuality;
END_VAR
VAR_OUTPUT
    bError : BOOL;
END_VAR

UtcTimeQuality_To_String 1: Eingänge

Name

Typ

Beschreibung

in

T_UtcTimeQuality

Die zu konvertierende Information als UTC-Time-Quality-Struktur.

UtcTimeQuality_To_String 2: Ausgänge

Name

Typ

Beschreibung

bError

BOOL

Der Ausgang ist „TRUE“ wenn der Eingangswert nicht fehlerfrei konvertiert werden konnte.

UtcTimeQuality_To_String 3: Rückgabewert

Name

Typ

Beschreibung

UtcTimeQuality_To_String

STRING(9)

Konvertiert Information als UTC-Time-Quality-String.

Beispiel

Der Rückgabewert: 'UQ#001|3' bedeutet, dass Schaltsekunden nicht bekannt sind. Zeitgeber hat keinen Fehler und ist nicht synchronisiert, die Auflösung der Zeitinformation des Bruchteils der Sekunde beträgt 3 Bits.

METHOD UtcTimeQuality_ToFrom_String : BOOL
VAR_INPUT
    fbIED    : REFERENCE TO FB_IED;
END_VAR
VAR
    Quality  : T_UtcTimeQuality;
    sQuality : STRING;
END_VAR
IF NOT __ISVALIDREF(fbIED) THEN
    RETURN;
END_IF

Quality := String_To_UtcTimeQuality('UQ#000|0');
sQuality := UtcTimeQuality_To_String(Quality);(* sQuality := 'UQ#000|0' *)
IF fbIED.Relay.LLN0.Beh.t.sQuality <> sQuality THEN
    Quality := fbIED.Relay.LLN0.Beh.t.Quality;
END_IF

Quality := String_To_UtcTimeQuality('UQ#001|3');
sQuality := UtcTimeQuality_To_String(Quality);(* sQuality := 'UQ#001|3' *)
IF fbIED.Relay.LLN0.Health.t.sQuality <> sQuality THEN
    Quality := fbIED.Relay.LLN0.Health.t.Quality;
END_IF

Quality := String_To_UtcTimeQuality('UQ#000|31');
sQuality := UtcTimeQuality_To_String(Quality);(* sQuality := 'UQ#000|31' *)
IF fbIED.Relay.LLN0.Mod_.t.sQuality <> sQuality THEN
    Quality := fbIED.Relay.LLN0.Mod_.t.Quality;
END_IF

UtcTimeQuality_ToFrom_String := TRUE;