health.age-in-months Unreviewed

pub fn age_in_months(birth_date: &str, on_date: &str) -> AgeInMonths

/// A child's age as completed months plus days, and the days since birth.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct AgeInMonths {
    /// completed calendar months since birth
    pub months: i64,
    /// days since the last completed month, 0 or more
    pub days: i64,
    /// days since birth; 0 on the day of birth
    pub total_days: i64,
}

fune!(health.age-in-months@^1);  // then call age_in_months(…)

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::dates_add_days::{add_days, days_between, parse_iso_date};  ← from dates.add-days ^1.0.0 · built alongside by fune
use super::dates_add_months::add_months;  ← from dates.add-months ^1.0.0 · built alongside by fune

/// The day the given number of months is completed. add_months clamps 31
/// January + 1 month to 28 February; a clamped day has not yet reached the
/// birth day, so the month completes the day after it (1 March), the same rule
/// dates.age uses for a 29 February birthday.
fn month_anniversary(birth_date: &str, birth_day: i64, months: i64) -> String {
    let shifted = add_months(birth_date, months);
    if parse_iso_date(&shifted).day < birth_day {
        add_days(&shifted, 1)
    } else {
        shifted
    }
}

/// Completed months and remaining days from `birth_date` to `on_date`.
///
/// # Panics
/// Panics on a malformed or impossible date, or `on_date` before `birth_date`.
pub fn age_in_months(birth_date: &str, on_date: &str) -> AgeInMonths {
    let birth = parse_iso_date(birth_date);
    let on = parse_iso_date(on_date);
    if on_date < birth_date {
        panic!("onDate {} is before birthDate {}", on_date, birth_date);
    }
    let mut months = (on.year - birth.year) * 12 + (on.month - birth.month);
    let mut anniversary = month_anniversary(birth_date, birth.day, months);
    if anniversary.as_str() > on_date {
        months -= 1;
        anniversary = month_anniversary(birth_date, birth.day, months);
    }
    AgeInMonths {
        months,
        days: days_between(&anniversary, on_date),
        total_days: days_between(birth_date, on_date),
    }
}

pub fn age_in_months_to_value(age: &AgeInMonths) -> Value {
    Value::obj(vec![
        ("months", Value::Int(age.months)),
        ("days", Value::Int(age.days)),
        ("totalDays", Value::Int(age.total_days)),
    ])
}

fn date_arg(value: &Value) -> &str {
    match value {
        Value::Str(s) => s.as_str(),
        _ => panic!("{:?} is not an ISO date (YYYY-MM-DD)", value),
    }
}

pub fn fune_vector(args: &[Value]) -> Value {
    age_in_months_to_value(&age_in_months(date_arg(&args[0]), date_arg(&args[1])))
}

Install

fune build

With that line in your source, in a Rust project (language rust in fune.project), fune build resolves it and its 2 dependencies, 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 health.age-in-months

The manifest, vectors and README with only the Rust implementation. Install it without the registry with fune add ./health.age-in-months-1.0.1-rust.fune, or fetch it from a terminal with fune pull health.age-in-months@1.0.1:rust.

The whole function, every language, is one file too: health.age-in-months-1.0.1.fune, 13,308 bytes, sha256 6ba2f856fa499229596115645b913970f63d353863d146ba2c24df0dcfff919e. It installs into a project of any language.

// fune: before health.age-in-months

// fune: after health.age-in-months

// fune: replace dates.add-days in health.age-in-months
// fune: replace dates.add-months in health.age-in-months

// fune: step health.age-in-months after <n|label>

More from the author

Months are always counted from the date of birth, not stepped a month at a time, so a 31st-of-the-month birthday does not decay to the 28th after February: born 31 January, 2 months are completed on 31 March.

A measuring date before the birth date is an error, not a negative age. Dates are ISO `YYYY-MM-DD`; an impossible date (2026-02-30) or a UK-style `15/05/2026` is an error.

Built on `dates.add-months` and `dates.add-days`; no clinical thresholds are applied here.

## Before you rely on this

**Not professional advice.** This capability calculates health figures from published rules. It is a software component for developers, not medical 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 clinician review how you use it, before anyone relies on the output. Provided "as is" under its licence, without warranty.

**Not a medical device.** It is not intended to diagnose, treat or support clinical decisions about any individual. Anyone building it into clinical software is responsible for that software's regulatory status, and must validate it under their own clinical governance.

**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 clinician 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