UtcTimeStamp_To_String

Konvertiert die Komponenten des strukturierten Typs T_UtcTime in einen formatierten UTC-Zeitstempel-String. Die Zeichenfolge des resultierenden Strings hat folgenden Aufbau: 'US#YYYY-MM-DD-hh:mm:ss.nnnnnnnnn':
YYYY:=Jahr
MM:=Monat
DD:=Tag
hh:=Stunde
mm:=Minuten
ss:=Sekunden
nnnnnnnnn:=Nanosekunden (9 Dezimalstellen).
Die T_UtcTime.Quality-Komponente wird nicht in den String konvertiert.

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

Syntax

FUNCTION UtcTimeStamp_To_String : STRING(32)
VAR_INPUT
    in     : T_UtcTime;
END_VAR
VAR_OUTPUT
    bError : BOOL;
END_VAR

UtcTimeStamp_To_String 1: Eingänge

Name

Typ

Beschreibung

in

T_UtcTime

Die zu konvertierende Zeitinformation als UTC-Time-Struktur.

UtcTimeStamp_To_String 2: Ausgänge

Name

Typ

Beschreibung

bError

BOOL

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

UtcTimeStamp_To_String 3: Rückgabewert

Name

Typ

Beschreibung

UtcTimeStamp_To_String

STRING(32)

Konvertierte Zeitinformation als formatierter UTC-Zeitstempel-String.

Beispiel

PROGRAM MAIN
VAR
    tUtc             : T_UtcTime;
    sUtc             : STRING;
    bError           : BOOL;
    secondSinceEpoch : DT;
    fractionOfSecond : T_UINT24;
END_VAR
tUtc:=String_To_UtcTimeStamp(in:='US#2022-09-15-16:12:34.750000000' , bError=>bError, secondSinceEpoch=>secondSinceEpoch, fractionOfSecond=>fractionOfSecond);
sUtc:=UtcTimeStamp_To_String(in:=tUtc, bError=>bError);(* => sUtc = 'US#2022-09-15-16:12:34.750000000' *)

tUtc.secondSinceEpoch:=DT#2022-09-15-00:00:00;
tUtc.fractionOfSecond[0]:=0;
tUtc.fractionOfSecond[1]:=0;
tUtc.fractionOfSecond[2]:=0;
sUtc:=UtcTimeStamp_To_String(in:=tUtc, bError=>bError);(* => sUtc ='US#2022-09-15-00:00:00.000000000' *)