payroll.notice-period Unreviewed

export function statutoryNotice(startDate: string, noticeDate: string): StatutoryNotice

/** The minimum each side must give under ERA 1996 s.86. */
export interface StatutoryNotice {
  /** completed years of continuous service on noticeDate */
  readonly serviceYears: number;
  /** minimum notice the employer must give: 0 under one month's service */
  readonly employerWeeks: number;
  /** minimum notice the employee must give: 1 week from one month's service, never more */
  readonly employeeWeeks: number;
}

import { statutoryNotice } from "#fune/payroll.notice-period@^1";

import { lengthOfService } from "./hr_length_of_service.ts";  ← from hr.length-of-service ^1.0.0 · built alongside by fune
import { type StatutoryNotice } from "./payroll_notice_period_types.ts";

/**
 * ERA 1996 s.86 minimum notice. Below one month's service the section does
 * not apply at all, which is different from one week: an employer who
 * dismisses on day 20 owes no statutory notice.
 */
export function statutoryNotice(startDate: string, noticeDate: string): StatutoryNotice {
  const service = lengthOfService(startDate, noticeDate);
  const atLeastOneMonth = service.years > 0 || service.months > 0;
  let employerWeeks = 0;
  if (atLeastOneMonth) employerWeeks = service.years < 2 ? 1 : Math.min(service.years, 12);
  return { serviceYears: service.years, employerWeeks, employeeWeeks: atLeastOneMonth ? 1 : 0 };
}

Install

fune build

With that line in your source, in a TypeScript project (language typescript in fune.project), fune build resolves it and its 1 dependency, pins them in fune.lock, downloads only the TypeScript package of each, and builds the code above into your project’s .fune/build, one readable file per capability with a header linking back here. Or pin a range in fune.project and build in one step:

fune add payroll.notice-period

The manifest, vectors and README with only the TypeScript implementation. Install it without the registry with fune add ./payroll.notice-period-1.0.1-typescript.fune, or fetch it from a terminal with fune pull payroll.notice-period@1.0.1:typescript.

The whole function, every language, is one file too: payroll.notice-period-1.0.1.fune, 9,748 bytes, sha256 ca1fdef6192d38555bd6dfbb1ba5da45d5d0a66e60ca7817499cf6a8715afeaa. It installs into a project of any language.

// fune: before payroll.notice-period

// fune: after payroll.notice-period

// fune: replace hr.length-of-service in payroll.notice-period

// fune: step payroll.notice-period after <n|label>

More from the author

Service is measured with hr.length-of-service up to and including the day notice is given, so the extra week arrives on the anniversary itself.

A contract can give longer notice, never shorter; this returns only the statutory floor. It does not cover summary dismissal for gross misconduct, payment in lieu, or s.86(4) (fixed-term contracts of a month or less treated as indefinite after three months' service). Northern Ireland has its own equivalent legislation and is not covered.

Source: Employment Rights Act 1996 s.86, "Rights of employer and employee to minimum notice", https://www.legislation.gov.uk/ukpga/1996/18/section/86.

## Before you rely on this

**Not professional advice.** This capability calculates payroll figures from published rules. It is a software component for developers, not tax or legal advice. Rules change and every rate here has an effective date. Check that the dates cover your case. Verify results against the official sources listed above, and have a payroll specialist review how you use it, before anyone relies on the output. Provided "as is" under its licence, without warranty.

**Unreviewed.** This capability's implementations agree in every language and pass its published test vectors, which were worked out from the official sources cited. But no qualified payroll specialist has yet checked those vectors, or confirmed that the capability covers the cases it claims. Treat it as a draft. Do not use it for real people, money or decisions without your own expert review. Once a qualified reviewer signs off, this notice is replaced with their name, qualification and the date. Each new version needs fresh sign-off.

## Notices

Contains public sector information licensed under the Open Government Licence v3.0 (https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/).

Legislation: Crown copyright and database right.

1.0.1 marks it unreviewed and adds its attribution notices (NOTICE). The code and the tests are unchanged.

Files