payroll.notice-period

pub fn statutory_notice(start_date: &str, notice_date: &str) -> StatutoryNotice

/// The minimum each side must give under ERA 1996 s.86.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct StatutoryNotice {
    /// completed years of continuous service on noticeDate
    pub service_years: i64,
    /// minimum notice the employer must give: 0 under one month's service
    pub employer_weeks: i64,
    /// minimum notice the employee must give: 1 week from one month's service, never more
    pub employee_weeks: i64,
}

fune!(payroll.notice-period@^1);  // then call statutory_notice(…)

use super::funejson::Value;  ← the fune runtime: the JSON value the test vectors use; fune build keeps it only where a signature takes one
use super::hr_length_of_service::length_of_service;  ← from hr.length-of-service ^1.0.0 · built alongside by fune

/// 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.
///
/// # Panics
/// Panics on a malformed date or a notice date before the start date.
pub fn statutory_notice(start_date: &str, notice_date: &str) -> StatutoryNotice {
    let service = length_of_service(start_date, notice_date);
    let at_least_one_month = service.years > 0 || service.months > 0;
    let employer_weeks = if !at_least_one_month {
        0
    } else if service.years < 2 {
        1
    } else {
        service.years.min(12)
    };
    StatutoryNotice {
        service_years: service.years,
        employer_weeks,
        employee_weeks: if at_least_one_month { 1 } else { 0 },
    }
}

pub fn fune_vector(args: &[Value]) -> Value {
    let n = statutory_notice(args[0].as_str(), args[1].as_str());
    Value::obj(vec![
        ("serviceYears", Value::Int(n.service_years)),
        ("employerWeeks", Value::Int(n.employer_weeks)),
        ("employeeWeeks", Value::Int(n.employee_weeks)),
    ])
}

Install

fune build

With that line in your source, in a Rust project (language rust in fune.project), fune build resolves it and its 1 dependency, pins them in fune.lock, downloads only the Rust 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. A crate’s build.rs runs it before every compile. 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 Rust implementation. Install it without the registry with fune add ./payroll.notice-period-1.0.0-rust.fune, or fetch it from a terminal with fune pull payroll.notice-period@1.0.0:rust.

The whole function, every language, is one file too: payroll.notice-period-1.0.0.fune, 8,084 bytes, sha256 2ffa1493b724e7a2ad4e78005fe7800be20ff73a78fe669ee042abed9ce74163. 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.

Files