LWORD_To_UtcTime

Converts the binary data of the type LWORD into the components of the structured type T_UtcTime. 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 LWORD_To_UtcTime : T_UtcTime
VAR_INPUT
    in : LWORD;
END_VAR

LWORD_To_UtcTime 1: Inputs

Name

Type

Description

in

LWORD

The time information to be converted as UTC-Time binary data.

LWORD_To_UtcTime 2: Return value

Name

Type

Description

LWORD_To_UtcTime

T_UtcTime

Converted time information as UTC-Time structure.

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;