AddDurationToDateTime

This task takes a DateTime value and adds a Duration value to it, returning the new resulting DateTime. It is used inside a ruleset to shift a date/time value by some amount.

Example: invoice due date

Yo may need to process an incoming invoice and then calculate the payment due date, which is 30 days after the invoice date.

• DateTime = the invoice date field from the document, e.g. 2026-07-01
• Duration = a Duration variable set to 30 days

Running AddDurationToDateTime gives you:

• Result: 2026-07-31

You'd then store that result in a new DateTime variable (e.g. DueDate) and use it downstream - for example, mapping it into an outbound 810 invoice document or a database field.

Null behavior

• If DateTime is null, the action returns null.
• If Duration is null, it just returns the original DateTime unchanged (no-op).

This functionality is particularly useful for common EDI and integration scenarios, such as calculating due dates, expiration dates, SLA deadlines, or scheduling follow-up actions at a fixed offset from an existing timestamp within your data.