nz_holiday_pay_calculator
Work out New Zealand holiday pay: annual leave, 8% pay as you go, public holidays, or the leave payout on termination.
Use for: 'how is holiday pay calculated NZ', 'holiday pay calculator',
'average weekly earnings vs ordinary weekly pay', '8% holiday pay casual',
'pay as you go holiday pay', 'do I get time and a half on a public holiday',
'alternative holiday day in lieu', 'holiday pay when I leave my job'.
PICK THE MODE. Each has one rule that is regularly got wrong.
annual_leave: leave is paid at the GREATER of ordinary weekly pay and
average weekly earnings (1/52 of the gross earnings for the 12 months
before the last pay period before the holiday). Someone whose overtime or
commission lifts their average above their base is owed the average.
pay_as_you_go: 8% of gross pay BEFORE the loading. $1,200 earns $96, so the
pay is $1,296; 8% of $1,296 is the wrong base. Lawful only for a fixed term
under twelve months or genuinely intermittent or irregular work, written
into the agreement and an identifiable part of each pay. payg_allowed says
whether it is; the loading is shown either way. Pass pay_periods_per_year
(26 fortnightly, 12 monthly) for the annual figure.
public_holiday: worked, at least time and a half for the hours, PLUS an
alternative holiday (a paid day off later) if it was an otherwise working
day. Time and a half is on everything they would have been paid for those
hours; hourly_rate is taken as that. A day the employee would not
otherwise have worked earns the time and a half only. Not worked on an
otherwise working day: relevant daily pay (hourly_rate x normal_hours), or
average daily pay (daily_pay_method="average" with
days_worked_last_52_weeks) where relevant daily pay cannot practicably be
worked out or varies. Alternative holidays do not expire; after 12 months
the employee may ask to exchange one for payment.
termination: ask whether they worked there 12 months. Over 12 months, the
untaken ENTITLEMENT from completed years (untaken_weeks: not a payslip
balance that includes leave accruing since the anniversary) at the
greater of the two weekly rates, plus 8% of gross earnings since the last
anniversary, less holiday_pay_already_paid; those earnings INCLUDE the
leave paid out and any public holidays (public_holidays_in_leave_period,
s40) and alternative holidays (alternative_holidays_owed) paid out, and
earnings_since_anniversary should include final wages, notice pay and
any bonus or commission. Under 12 months, service="under12": 8% of the
earnings since they started. Same code as nz_final_pay_calculator, so the
two agree.
This is the Holidays Act 2003, which applies until the Employment Leave Act
2026 commences on 6 August 2028 (State school board staff on the education
payroll: by Order in Council, no later than 6 August 2036). All figures are
gross. Rules from the Act and Employment New Zealand.
Args:
mode: annual_leave, pay_as_you_go, public_holiday or termination.
ordinary_weekly_pay: What a normal week earns.
gross_earnings_last_52_weeks: 12 months of gross earnings, for AWE and
average daily pay.
leave_weeks: Weeks of leave taken (annual_leave).
gross_pay_period: Gross pay before the 8% loading (pay_as_you_go).
employment_type: casual-genuine, casual-doubtful, fixed-term-under,
fixed-term-over or permanent (pay_as_you_go).
in_agreement: 8% PAYG is in the written agreement.
payslip_identified: The 8% is an identifiable part of the pay.
pay_periods_per_year: Pay periods a year for the annual figure.
worked: The public holiday was worked.
otherwise_working_day: The day would otherwise have been worked.
hours_worked: Hours worked on the public holiday.
hourly_rate: Ordinary hourly rate.
normal_hours: Hours they would have worked that day.
multiplier: Public holiday rate, at least 1.5.
public_holiday_days: Public holidays not worked.
daily_pay_method: auto, relevant or average.
days_worked_last_52_weeks: Days worked or on paid leave, for average
daily pay.
service: over12 or under12 (termination).
untaken_weeks: Untaken entitlement from completed years, in weeks
(termination).
earnings_since_anniversary: Earnings since the last anniversary,
including final wages (termination).
public_holidays_in_leave_period: s40 public holidays (termination).
alternative_holidays_owed: Alternative holidays not taken
(termination).
holiday_pay_already_paid: Holiday pay already paid in advance or as
pay as you go (termination).
Returns:
total_gross for the mode, the working spelled out, the OWP and AWE
comparison where it applies, PAYG eligibility, the daily rate and its
basis, the alternative holiday, and the termination split.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "nz_holiday_pay_calculator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | annual_leave | |
| worked | No | ||
| service | No | over12 | |
| multiplier | No | ||
| hourly_rate | No | ||
| leave_weeks | No | ||
| hours_worked | No | ||
| in_agreement | No | ||
| normal_hours | No | ||
| untaken_weeks | No | ||
| employment_type | No | casual-genuine | |
| daily_pay_method | No | auto | |
| gross_pay_period | No | ||
| payslip_identified | No | ||
| ordinary_weekly_pay | No | ||
| public_holiday_days | No | ||
| pay_periods_per_year | No | ||
| otherwise_working_day | No | ||
| holiday_pay_already_paid | No | ||
| alternative_holidays_owed | No | ||
| days_worked_last_52_weeks | No | ||
| earnings_since_anniversary | No | ||
| gross_earnings_last_52_weeks | No | ||
| public_holidays_in_leave_period | No |