payroll.pro-rata-salary Unreviewed

def pro_rata_salary(period_salary: Money, fte_basis_points: int, period_start: str, period_end: str, worked_from: str, worked_to: str, method: ProRataMethod, holidays: Sequence[str]) -> ProRata

ProRataMethod = Literal["calendar-days", "working-days"]

@dataclass(frozen=True)
class ProRata:
    """The amount and the fraction it came from."""

    pay: Money
    #: days in the employed part of the period, by the method
    days_counted: int
    #: days in the whole period, by the same method
    days_in_period: int

from fune.payroll.pro_rata_salary import pro_rata_salary  # payroll.pro-rata-salary@^1

from typing import Sequence

from .dates_add_days import add_days, days_between  ← from dates.add-days ^1.0.0 · built alongside by fune
from .dates_business_days_between import business_days_between  ← from dates.business-days-between ^1.0.0 · built alongside by fune
from .math_round_div import round_div  ← from math.round-div ^1.0.0 · built alongside by fune
from .money_amount import Money, money  ← from money.amount ^1.0.0 · built alongside by fune
from .payroll_pro_rata_salary_types import ProRata, ProRataMethod


def _count_days(start: str, end: str, method: str, holidays: Sequence[str]) -> int:
    if method == "calendar-days":
        return days_between(start, end) + 1
    if method == "working-days":
        return business_days_between(start, add_days(end, 1), holidays)
    raise ValueError('unknown pro-rata method "%s"' % (method,))


def pro_rata_salary(
    period_salary: Money,
    fte_basis_points: int,
    period_start: str,
    period_end: str,
    worked_from: str,
    worked_to: str,
    method: ProRataMethod,
    holidays: Sequence[str],
) -> ProRata:
    """Pro-rate a period's salary by time employed and FTE, rounding once."""
    if isinstance(fte_basis_points, bool) or not isinstance(fte_basis_points, int) or not 1 <= fte_basis_points <= 10000:
        raise ValueError("fteBasisPoints must be a whole number from 1 to 10000, received %s" % (fte_basis_points,))
    if days_between(period_start, period_end) < 0:
        raise ValueError("periodEnd is before periodStart")
    if days_between(worked_from, worked_to) < 0:
        raise ValueError("workedTo is before workedFrom")
    if worked_from < period_start or worked_to > period_end:
        raise ValueError("the worked dates must fall inside the pay period")
    days_in_period = _count_days(period_start, period_end, method, holidays)
    if days_in_period == 0:
        raise ValueError("the pay period has no working days to pro-rate over")
    days_counted = _count_days(worked_from, worked_to, method, holidays)
    minor = round_div(period_salary.minor * fte_basis_points * days_counted, 10000 * days_in_period, "half-up")
    return ProRata(pay=money(minor, period_salary.currency), days_counted=days_counted, days_in_period=days_in_period)

Install

fune build

With that line in your source, in a Python project (language python in fune.project), fune build resolves it and its 4 dependencies, pins them in fune.lock, downloads only the Python 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.pro-rata-salary

The manifest, vectors and README with only the Python implementation. Install it without the registry with fune add ./payroll.pro-rata-salary-1.0.1-python.fune, or fetch it from a terminal with fune pull payroll.pro-rata-salary@1.0.1:python.

The whole function, every language, is one file too: payroll.pro-rata-salary-1.0.1.fune, 15,940 bytes, sha256 f8bb34881684fca05492f85329cff6f12cb9fef7c6277d1903e38ba24f5bfdf0. It installs into a project of any language.

# fune: before payroll.pro-rata-salary

# fune: after payroll.pro-rata-salary

# fune: replace dates.add-days in payroll.pro-rata-salary
# fune: replace dates.business-days-between in payroll.pro-rata-salary
# fune: replace math.round-div in payroll.pro-rata-salary
# fune: replace money.amount in payroll.pro-rata-salary

# fune: step payroll.pro-rata-salary after <n|label>

More from the author

computed exactly and rounded half-up to the penny once, at the end (math.round-div), so the fraction of a penny is never rounded twice.

Two methods, because employers use both and they give different answers:

- **calendar-days** counts every day: 14 to 30 September is 17 of 30 days. - **working-days** counts Monday to Friday, less the `holidays` supplied (dates.business-days-between): 14 to 30 September 2026 is 13 of 22 days.

Which one applies is a contractual choice, not a legal one. A third common method, 1/260th or 1/365th of the annual salary per day, is the calendar or working-days method applied to a year-long period: pass the annual salary with the tax year as the period.

Both date ranges are inclusive. The employed range must sit inside the pay period. A working-days period with no working days in it is an error, since the fraction would be 0/0.

## 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.

1.0.1 marks it unreviewed. The code and the tests are unchanged.

Files