DT_TO_DATE-Baustein

Kurz-Information

Name	`DT_TO_DATE`
→POE-Typ	→Funktion
Kategorie	Standard (non-safe), Convert, Baustein mit interner Fehlerdiagnose
Konform zur →IEC-Norm	keine Einschränkungen, aber: implementierungsabhängige Realisierung; siehe "Funktionalität"
Grafische Schnittstelle
Verfügbar ab	Version 1.65.0 (für Neuron Power Engineer) – Anfangsvariante Version 3.8.0 (für Bibliothek `Standard (non-safe)`): Baustein in diese Bibliothek verschoben

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 Neuron Power Engineer 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:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft den Wert, der am Eingang anliegt. Ab 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.