date_difference

Computes the difference between dates.

Target function

Signature

1date_difference(value, when, ...)

Computes the difference between dates.

date_difference is a global callable that can be used wherever an expression is valid. date_difference handles calendar, duration, or formatting behavior. Store values in structured date or duration form and format them only when presenting text.

Parameters

value: Required value. Supply value positionally unless the signature shows a keyword form.
when: Required value. Supply when positionally unless the signature shows a keyword form.
...: Additional values may be supplied after the earlier arguments.

Examples

Basic call

1date_difference(date, date_add(date, -day=1))

The example shows the normal call shape. Adapt variable names, validation, and surrounding error handling to the context.