SUB_DT_DT-Baustein

Kurz-Information

Name	`SUB_DT_DT`
→POE-Typ	→Funktion
Kategorie	Standard (safe), Time
Konform zur →IEC-Norm	derzeit eingeschränkt (IEC fordert eine Fehlerbehandlung, falls das Ergebnis des Bausteins den Wertebereich des Ausgangsdatentyp überschreitet. Siehe "Keine Prüfung von ungültigen Beschaltungen" für das Verhalten in Neuron Power Engineer.)
Grafische Schnittstelle
Verfügbar ab	Version 1.109.0 (für Neuron Power Engineer) – Anfangsvariante Version 3.8.0 (für Bibliothek `Standard (safe)`): Baustein in diese Bibliothek verschoben

Funktionalität

Der Baustein subtrahiert das Datum mit Uhrzeit, das über Eingang IN2 eingegeben wird, vom Datum mit Uhrzeit, das über Eingang IN1 eingegeben wird (= IN1 - IN2). Der Baustein liefert die Differenz im Format TIME.

Keine Prüfung von ungültigen Beschaltungen

Bei einigen Bausteinen werden ungültige Beschaltungen von Neuron Power Engineer nicht geprüft. Geben Sie deshalb Code in Ihrer Anwendung ein (z.B. IF-Anweisungen im ST-Code), mit denen ungültige Beschaltungen erkannt werden.

Lesen Sie unter "Standardbausteine für die Anwendung" nach, welche Auswirkungen eine ungültige Beschaltung haben könnte.

Während der Berechnung mit Hilfe von SUB_DT_DT kann aufgrund eines →Überlaufs oder →Unterlaufs eine ungültige Beschaltung entstehen. Da Ihr eingesetztes →Zielsystem die Verwendung von →Zeitliteralen in Neuron Power Engineer beeinflussen kann (siehe "Zielsystemspezifische Eigenschaften und Einschränkungen"), kann ein Überlauf/Unterlauf für unterschiedliche Zielsysteme bei unterschiedlichen Ergebniswerten auftreten.

Eingänge, Ergebniswert

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`IN1`	`DATE_AND_TIME`	1. Wert
Eingänge:	`IN2`	`DATE_AND_TIME`	2. Wert
Ergebniswert:	–	`TIME`

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.

Beispiel für Verwendung im ST-Editor

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

FUNCTION_BLOCK ExampleSubDtDt

VAR

      result : TIME;

   END_VAR

   result := SUB_DT_DT(IN1 := DT#2017-08-30-00:00:01, IN2 := DT#2017-08-29-23:59:59);

   Assert(result = TIME#2s);

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.