Period End Expiration
The Period End Expiration plugin expires accruals at the end of a vacation or fiscal year, plus an optional grace period. This is commonly used for policies aligned with specific calendar or vacation year boundaries.
When to use
Use this plugin when:
- Time off expires at the end of a vacation or fiscal year
- You need a grace period after the year ends
- All accruals from the same year expire on the same date
- You want to override the expiration from an accrual plugin
Parameters
| Parameter | Description | Default |
|---|---|---|
| Year start month | The month when the vacation or fiscal year begins (e.g., “September” for Danish vacation year) | Required |
| Grace period months | Number of months after the year ends before expiration (e.g., 4 for Danish carryover rules) | 0 |
How it works
The plugin:
- Determines which vacation/fiscal year the accrual belongs to based on the accrual date
- Calculates when that year ends (12 months after start)
- Adds the grace period
- Sets expiration to the last day of that month
Example: Danish vacation year
With Year start month = September and Grace period months = 4:
| Accrual Date | Vacation Year | Year Ends | Expiration Date |
|---|---|---|---|
| October 1, 2025 | 2025/2026 | August 31, 2026 | December 31, 2026 |
| January 15, 2026 | 2025/2026 | August 31, 2026 | December 31, 2026 |
| September 1, 2026 | 2026/2027 | August 31, 2027 | December 31, 2027 |
All accruals from the 2025/2026 vacation year expire on the same date (December 31, 2026), regardless of when during the year they were earned.
Examples
Danish vacation system
Replicate Danish vacation law expiration rules:
- Add the Period End Expiration plugin to your policy
- Set Year start month
to
September - Set Grace period months
to
4
Note: The Danish Holiday accrual plugin already includes this expiration logic. Only use this expiration plugin if you’re using a different accrual plugin.
Calendar year with no grace period
Expires at the end of the calendar year when earned:
- Add the Period End Expiration plugin
- Set Year start month
to
January - Set Grace period months
to
0
Fiscal year with 6-month grace
For a fiscal year starting in July with a 6-month carryover window:
- Add the Period End Expiration plugin
- Set Year start month
to
July - Set Grace period months
to
6
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 |