How We Calculate Your Best Annual Leave Plan
A plain-English technical guide to how the calculator scans public holidays, scores leave blocks, and builds annual leave plans.
The short version
The calculator looks for working days trapped between non-working days. Non-working days include weekends and public holidays for your state or territory. When one or more working days sit between those non-working clusters, the tool treats them as a possible leave bridge. It then scores each bridge, removes clashes, and selects the combination that fits your leave balance and chosen strategy.
That sounds simple because the idea is simple. The useful part is doing it consistently across every jurisdiction, across more than one calendar year, and across several different ideas of what a "good" plan means.
Step one: load the right public holidays
Australia does not have one public holiday calendar. It has national holidays, state and territory holidays, and regional holidays. The calculator begins with the jurisdiction you select. If you choose Queensland, it loads Queensland holidays. If you choose Victoria, it loads Victorian holidays. The pages on the site are generated from the same verified data files, so the visible article dates and the calculator logic are working from the same source.
The current data covers 2026 and 2027. That matters because the best blocks often cross a calendar boundary. A Christmas plan in late December may continue into early January, and a calculator that stops at 31 December misses the point. This site plans across the available forward window rather than forcing one isolated calendar year at a time.
Step two: classify each date
For every day in the planning window, the calculator asks a basic question: is this a normal working day or not? Saturdays and Sundays are non-working days. Public holidays in the selected jurisdiction are non-working days. Everything else is treated as a potential leave day.
This is intentionally conservative. The tool does not know your roster, award, enterprise agreement, part-time pattern, employer shutdown, or personal commitments. It assumes a standard Monday-to-Friday pattern because that is the common case for a public holiday leave maximiser. If your work pattern is different, the results are still useful as calendar intelligence, but they need human adjustment.
Step three: find bridge candidates
A bridge candidate is a short run of working days between non-working clusters. Imagine a public holiday on Tuesday. Saturday and Sunday are already off, Tuesday is already off, and Monday is the working day caught between them. Monday becomes a candidate: spend one leave day and receive a four-day break.
The same logic works for larger gaps. A Wednesday public holiday may create two possible two-day bridges: Monday-Tuesday before it or Thursday-Friday after it. Around Christmas, the gaps can span the year boundary. The calculator scans these patterns rather than relying on a fixed list of obvious holidays.
To keep recommendations practical, candidate blocks are bounded. The tool looks for useful bridges rather than treating every possible long holiday as a candidate. That keeps the output focused on the calendar advantage created by weekends and public holidays.
Step four: score each block
Each candidate has a cost and a result. The cost is the number of annual leave days you must book. The result is the total number of calendar days away once weekends and public holidays are included. The core efficiency score is total days off divided by leave days used.
A block that costs one leave day and produces four days off has an efficiency of 4.0. A block that costs four leave days and produces ten days off has an efficiency of 2.5. Both may be excellent, but they serve different planning goals. One creates a compact long weekend; the other creates a proper break.
Step five: apply your strategy
The strategy buttons change how the calculator values blocks. Maximum Days Off favours raw efficiency. Longest Break gives extra weight to longer continuous absences. Balanced Year tries to spread breaks across the calendar instead of stacking everything in one season. Long Weekends favours shorter blocks that use one or two leave days.
This is why two people with the same state and leave balance can receive different recommendations. The calculator is not pretending there is one universal answer. It is translating your planning theory into scoring weights.
Step six: avoid overlapping recommendations
Once blocks are scored, the calculator builds a plan from the strongest non-overlapping options that fit within your leave budget. If two blocks use the same date, both cannot be selected. If a high-scoring block consumes too much of the leave budget and prevents several better smaller blocks, the final plan needs to account for that.
The current selection approach is practical rather than mystical. It is designed to produce useful recommendations quickly in a browser, with results a human can understand. It is not a legal entitlement engine, a payroll system, or an employer approval workflow.
School-holiday weighting
When the school-holidays toggle is on, the calculator gives a bonus to leave blocks that overlap with public school holiday periods in the selected state or territory. This does not make every school-holiday block automatically win. It simply recognises that for parents and carers, a moderately efficient block that aligns with school holidays may be more valuable than a slightly more efficient block during term time.
What happens in your browser
The calculation runs in JavaScript in your browser. The public holiday and school holiday data files are downloaded as static files, and the leave plan is calculated locally. There is no account, no server-side planning engine, and no database of user plans. Exporting an .ics file, copying a request, printing, and generating a share link all happen on your device.
That architecture is deliberate. It keeps the site fast, cheap to host, easy to inspect, and better aligned with the privacy promise. The site can still use ordinary analytics to understand page traffic, but the calculator does not need to send your leave balance or generated plan to a backend service in order to work.
How to read the result
Treat the result as a high-quality planning draft. It is excellent for spotting calendar leverage. It is not the final authority on whether you can take leave. Before booking travel, check your employer's leave system, team coverage, shutdown periods, award or agreement rules, and any regional public holiday limitations that apply to your actual workplace.
Related reading
Leave Maxing · Holiday Leave Theories · Safety and Privacy · Why You Need a Holiday · Long vs Short Breaks
For date-specific planning, start with the complete annual leave guide.