UtcTime_To_LWORD

Converts the components of the structured type T_UtcTime into the binary data of the type LWORD. The coding of the components in LWORD corresponds to the TwinCAT UTC-Time LWORD format specification.

Namespace: Tc3_Collections
Library: Tc3_Collections (Tc3_Collections.compiled-library)

Syntax

FUNCTION UtcTime_To_LWORD : LWORD
VAR_INPUT
    in : T_UtcTime;
END_VAR

Inputs

Name	Type	Description
in	T_UtcTime	The time information to be converted as a UTC-Time structure.

Return value

Name	Type	Description
UtcTime_To_LWORD	LWORD	Converted time information as UTC-Time binary data.

Sample

METHOD UtcTime_ToFrom_LWORD : BOOL
VAR
    tValue : T_UtcTime;
    sValue : STRING;
END_VAR

tValue := LWORD_To_UtcTime(0);
sValue := UtcTime_To_String(tValue);(* sValue := 'UT#1970-01-01-00:00:00.000000000|000|0' *)

IF UtcTime_To_LWORD(tValue) = 0 THEN
    tValue.secondSinceEpoch := DT#2000-01-01-00:00:0;
    tValue.fractionOfSecond := LTIME_TO_UtcTimeFractionOfSecond( LTIME#0MS );
    tValue.quality.LeapSecondsKnown := FALSE;
    tValue.quality.ClockFailure := FALSE;
    tValue.quality.ClockNotSynchronized := TRUE;
    Accuracy_To_UtcTimeQualityAccuracy( E_UtcTimeAccuracy._03, 
                                        bAccuracy0=>tValue.quality.Accuracy0, 
                                        bAccuracy1=>tValue.quality.Accuracy1, 
                                        bAccuracy2=>tValue.quality.Accuracy2, 
                                        bAccuracy3=>tValue.quality.Accuracy3, 
                                        bAccuracy4=>tValue.quality.Accuracy4 );
    sValue := UtcTime_To_String(tValue);(* sValue := 'UT#2000-01-01-00:00:00.000000000|001|3' *)
END_IF


UtcTime_ToFrom_LWORD := TRUE;