findTimeOff()
Returns time off over a period of time, either for one individual person or across the org. Any time off that overlaps part of the date range being queried will be returned.
Syntax
findTimeOff(from, until[, person])
Parameters
Return Type
Examples
findTimeOff(date, "+1m").count()
Returns the number of time off requests (including those pending and not approved) that are occurring in the next 30 days.
findTimeOff("2025-10-01", "2025-11-01").filter{status:approved}.count()
Returns the number of time off requests that have been approved that occur in the month of October.
findTimeOff("2025-10-01", "2025-11-01", person).filter{status:approved}.sum{days}
Returns the total number of days off for a particular person for time off overlapping the month of October.
findTimeOff("2025-01-01", "2026-01-01").filter{status:approved and policy.name:"UK Sick Policy"}.sum{days}
Returns the total number of days off taken for approved time off requests for the "UK Sick Policy" that overlap the calendar year 2025.
