SUB_DATE_DATE

Returns the difference between two dates as a duration.

Signature

     ┌──────────────┐
IN1 ─┤              │
     │ SUB_DATE_DATE├─ OUT
IN2 ─┤              │
     └──────────────┘

FUNCTION SUB_DATE_DATE : TIME
  VAR_INPUT
    IN1 : DATE;
    IN2 : DATE;
  END_VAR
END_FUNCTION

The return type is TIME. Both inputs are DATE.

Inputs

Name	Type	Description
IN1	DATE	The minuend date.
IN2	DATE	The subtrahend date.

Outputs

Name	Type	Description
Return value	TIME	IN1 minus IN2 as a duration.

Description

Returns the difference IN1 minus IN2 as a TIME duration in milliseconds. The internal subtraction is in seconds, then converted to milliseconds.

Example

Try it

Source

result := SUB_DATE_DATE(D#2000-01-02, D#2000-01-01);
(* result = T#24h *)

See Also

• SUB_DT_DT — difference between two datetimes

References

• IEC 61131-3 §2.5.1.5.8

• CODESYS: SUB (covers time arithmetic)

• Beckhoff TwinCAT 3: SUB (covers time arithmetic)

• Fernhill SCADA: SUB_DATE_DATE