Short summary

Name	`SUB_TIME`
→POU type	→function
Category	IEC-block, Time
Conform to →IEC-standard	no restrictions
Graphical interface
Available since	Version 1.64.0 (für logi.CAD 3)

Functionality

The block subtracts the time value entered at input IN2 from the time value entered at input IN1 (= IN1 - IN2). The block returns the result of this subtraction in format TIME.

No check of invalid connections

For some blocks, invalid connections are not checked by logi.CAD 3. Therefore, enter code in your application to detect invalid connections (e.g. IF-statements).

See "IEC-blocks for the application" for information what the consequences of an invalid connection might be.

An invalid connection due to →overflows or →underflows might occur during a calculation using SUB_TIME . As your used →target system might influence the usage of →time literals in logi.CAD 3 (see "Properties and restrictions specific to the target system") , an overflow/underflow might occur for different return values when using different target systems.

Inputs, return value

	Identifier	→Data type	Description
Inputs:	`IN1`	`TIME`	1st value
Inputs:	`IN2`	`TIME`	2nd value
Return value:	–	`TIME`

Input EN and output ENO are available when →calling the block. See "Execution control: EN, ENO" for information on input EN and output ENO.

Example for usage within ST-editor

The calculated values are evaluated by using the Assert block .

FUNCTION_BLOCK ExampleSubTime
  VAR
    result : TIME;
  END_VAR
  result := SUB_TIME(IN1 := TIME#4s, IN2 := TIME#3s);
 
  Assert(result = TIME#1s);
END_FUNCTION_BLOCK

When creating your application within the ST-editor, enter a call of a block by typing the text as requested by the syntax or use Content Assist.