nz_business_days_calculator
Count New Zealand working days between two dates, or add or subtract N working days.
Use for: 'working days between two dates nz', '10 working days from today
nz', 'business days calculator nz', 'how many working days until
christmas', '20 working days notice', 'subtract working days from a date'.
THE END DATE IS COUNTED, THE START DATE IS NOT, unless include_start is
true. Monday to Friday of one week is 4 business days by default.
ADD AND SUBTRACT start from the next (or previous) day, so one business day
after a Friday is the Monday.
HOLIDAYS COME OUT ON THEIR OBSERVED DATES. A Saturday Anzac Day removes the
Monday after it; Christmas and Boxing Day on a weekend remove the Monday and
Tuesday. Waitangi Day and Anzac Day were only Mondayised from 2014, and
Matariki exists only from 2022. A holiday on the weekend itself counts as a
weekend day.
A REGIONAL ANNIVERSARY DAY is excluded only when region is given, on the
day it is OBSERVED that year, by Employment New Zealand's rules: usually
the Monday nearest the anniversary (Auckland 29 Jan observed Monday 26
January 2026), with exceptions such as Southland on Easter Tuesday and
Canterbury on Show Day Friday in November. Available from 2010.
Statutes often define working days with their own extra exclusions, such
as 25 December to 15 January. This does not apply those.
Args:
start_date: ISO date, YYYY-MM-DD.
end_date: ISO date, for mode between. Counted.
mode: between, add or subtract.
days: Business days to add or subtract, at least 1.
include_start: Whether the start date itself counts. Default False.
region: Optional anniversary region key, for example auckland,
wellington, canterbury.
Returns:
Business, calendar, weekend and holiday counts, the holidays met, the
target date for add or subtract, and weeks and days.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start_date": "<start_date>"
},
"name": "nz_business_days_calculator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| mode | No | between | |
| region | No | ||
| end_date | No | ||
| start_date | Yes | ||
| include_start | No |