DT_TO_DATE-Baustein

Kurz-Information

Name

DT_TO_DATE

→POE-Typ

→Funktion

Kategorie

IEC-Baustein, Convert, Baustein mit interner Fehlerdiagnose

Konform zur →IEC-Norm

images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/check.svg keine Einschränkungen , aber: images/s/b2ic8e/9012/1ca6q62/_/images/icons/emoticons/information.svg i mplementierungsabhängige Realisierung; siehe "Funktionalität"

Grafische Schnittstelle

images/download/thumbnails/414781023/DT_TO_DATE-version-1-modificationdate-1534929456717-api-v2.png

Verfügbar ab

Version 1.65.0 (für logi.CAD 3)

Funktionalität

Der Baustein dient zur expliziten Konvertierung des an IN anliegenden Datums inkl. Uhrzeit (DATE_AND_TIME) in einen Wert vom Datentyp DATE.

Der Baustein verwirft die Uhrzeit und liefert nur das Datum.

Implementierungsabhängige Realisierung

Die IEC-Norm definiert, dass es ein Fehler ist, wenn der anliegende Wert nicht im gemeinsamen Wertbereich des Eingangsdatentyps und des Ergebniswerts liegt, aber auch dass es sich dabei um ein implementiererspezifisches Verhalten handelt. In logi.CAD 3 kann bei diesem Baustein ein Fehler für den gemeinsamen Wertbereich auftreten. Der Fehler tritt ab einem Datum 1.1.10000 auf. In diesem Fall liefert der Baustein den Wert DT#9999-12-31 (der Baustein schneidet auf den anliegenden Wert ab) und der Ausgang ENO wird auf den Wert FALSE gesetzt.

Eingänge, Ergebniswert


Bezeichner

→Datentyp

Beschreibung

Eingänge:

IN

DATE_AND_TIME

zu konvertierendes Datum inkl. Uhrzeit

Ergebniswert:

DATE


Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

Interne Fehlerdiagnose für Baustein

Der Baustein prüft den Wert, der am Eingang anliegt. A b einem Datum 1.1.10000 wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt. (In diesem Fall liefert der Baustein außerdem den Wert DT#9999-12-31 .)

Beispiel für Verwendung im ST-Editor

Die berechneten Werte werden mit Hilfe des Assert-Bausteins ausgewertet.

FUNCTION_BLOCK ExampleDtToDate
VAR
result : DATE;
END_VAR
result := DT_TO_DATE(IN := DT#1970-01-01-00:00:12);
Assert(result = D#1970-01-01);
END_FUNCTION_BLOCK

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.