Relative Expiration
The Relative Expiration plugin expires time off a fixed number of months after it was accrued. This creates a rolling expiration window that’s relative to when the time was earned.
When to use
Use this plugin when:
- Time off should expire a fixed period after earning it
- You want a simple rolling expiration window
- Different accruals can have different expiration dates based on when they were earned
Parameters
| Parameter | Description | Default |
|---|---|---|
| Months from accrual | Number of months after the accrual date when time expires. The expiration always occurs at the end of the month. | Required (minimum: 1) |
How it works
The plugin calculates expiration by:
- Taking the accrual date
- Adding the specified number of months
- Setting expiration to the last day of that month
Example
With Months from accrual set to 16:
| Accrual Date | Expiration Date | Notes |
|---|---|---|
| January 15, 2025 | May 31, 2026 | 16 months later, end of May |
| March 1, 2025 | July 31, 2026 | 16 months later, end of July |
| December 20, 2025 | April 30, 2027 | 16 months later, end of April |
Examples
12-month expiration
Time off expires one year after being earned:
- Add the Relative Expiration plugin to your policy
- Set Months from accrual
to
12
18-month expiration
Longer window for employees to use their time:
- Add the Relative Expiration plugin
- Set Months from accrual
to
18
Comparison with other plugins
| Plugin | Expiration logic |
|---|---|
| Relative Expiration | N months after each accrual |
| Period End Expiration | End of fiscal/vacation year + grace period |
| Never Expires | Time never expires |
| Formula Expiration | Custom calculation |