SUB_TOD_TOD: Subtracts one time of day value from another

Help Contents

Introduction

Returns the difference between two time of day values as an interval.

Syntax

Informal Syntax:

SUB_TOD_TOD( In1, In2 )

Formal Syntax:

SUB_TOD_TOD( In1:=expression, In2:=expression )

Parameters

Parameter	Type	Description
In1	TIME_OF_DAY	The first time of day value.
In2	TIME_OF_DAY	The second time of day value to subtract from the first.

Return Value

The function SUB_TOD_TOD returns an interval, the result of In1 - In2.

If In2 is greater than In1, the returned interval will be negative. The return value will always be in the range: T#-23h59m59s999ms to T#-23h59m59s999ms.

Examples

Example	Return Value
SUB_TOD_TOD( TOD#12:00:00.000, TOD#13:25:00.000 )	T#-1h25m
SUB_TOD_TOD( TOD#12:00:00.000, TOD#11:40:00.000 )	T#20m
SUB_TOD_TOD( TOD#12:00:00.000, TOD#12:00:00.000 )	T#0

Standards Compliance

IEC 61131-3 Second Edition: Table 30.7b.

IEC 61131-3 Third Edition: Table 35.7b.

Further Information

Date and Time Functions

For other date and time functions.

Glossary

For the meaning of terms used in Fernhill SCADA.