Tenure calculator
From 1 March 2018 to 20 August 2024 is 6 years, 5 months and 19 days, or 2,364 days in total. Enter a hire or start date and an as-of date to get length of service the way a personnel file writes it. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Start date
- 2018-03-01
- End date
- 2024-08-20
- Years
- 6
- Months
- 5
- Days
- 19
- Total days
- 2,364
Tenure is the elapsed civil time between a start date and an end date, written as completed years, leftover months, and leftover days. Payroll files, service-award lists, loan statements, visa applications, and union seniority boards all ask for that breakdown rather than a raw total of days. This tenure calculator accepts two strict ISO calendar days, validates them on the proleptic Gregorian calendar including leap Februaries, and returns years, months, days, the total civil-day span, and a short readable tenure string.
How civil tenure is counted in years, months, and days
Civil tenure is the completed calendar gap between a hire, origination, or commencement date and an as-of or last-working day, written the way a personnel file writes length of service: years, then leftover months, then leftover days. A raw subtraction of day counts divided by three hundred sixty-five point two five does not produce that form, because months have unequal lengths and February changes in leap years. This calculator parses two strict ISO calendar dates of the form year-month-day with four, two, and two digits.
Each year must lie between one and nine thousand nine hundred ninety-nine, each month between one and twelve, and each day must exist in that month under proleptic Gregorian leap rules: a year is a leap year when it is divisible by four, except that a century year is a leap year only when it is also divisible by four hundred. That rule makes the twenty-ninth of February legal in two thousand twenty-four and two thousand, and illegal in two thousand twenty-three and nineteen hundred.
After both dates are valid, the engine counts calendar months from the start toward the end, adding those months with an end-of-month clamp so the thirty-first of January plus one month lands on the twenty-eighth or twenty-ninth of February rather than on an impossible day. If the clamped date still sits after the end date, the month count walks back by one so tenure never claims a month that has not completed. Leftover days are the integer Julian-day remainder from that last complete month-add to the end date.
Years are the month count divided by twelve; leftover months are the remainder.
Where a tenure calculator is used in HR, finance, and compliance
Human-resources and people-operations teams compute length of service for probation gates, service awards, vesting cliffs, and seniority boards, and they need years-months-days rather than a raw day count. Payroll and benefits engines store a hire ISO date and an as-of day when they print a tenure line on a payslip or a benefits statement. Mortgage and personal-loan servicers report how long a facility has been outstanding from origination to a statement date, which is a different search from an EMI calculator that takes tenure as an input term in months.
Immigration, union, and public-sector desks often require completed years and leftover months of continuous service as of a filing day. Curriculum authors teaching calendar arithmetic want one oracle that rejects inverted dates and impossible Februaries instead of a spreadsheet that silently rolls overflow days. If you later need civil age from a birth date, a completed anniversary number, whole months only, or a signed day difference, treat those as separate search intents and landings rather than overloading this tenure page.
The search people type is tenure calculator; the contract they get is two ISO dates in and a years-months-days breakdown out.
What you can do with it
Employment length of service
From a hire ISO date and an as-of day, get completed years, leftover months, leftover days, and a readable tenure phrase for probation gates, service awards, and seniority lists.
Outstanding loan or facility period
Measure how long a loan, lease, or facility has been outstanding from origination to a statement date as years, months, and days—not as an EMI term in months.
Continuous service and filing dates
Compute completed civil tenure for immigration, union, or public-sector filings that ask for length of continuous service as of a specific calendar day.
FAQ
How do I calculate tenure between two dates?
The same calendar day on both sides is zero tenure.
What happens if the end date precedes the start date?
Elapsed tenure cannot be negative; an inverted pair is a client error and is not billed.
Is the start day counted as a full day of tenure?
Tenure is completed civil time, like age: the start day itself is zero years, zero months, zero days.
How are month-end and leap-day start dates handled?
Adding calendar months clamps the day to the last day of the destination month, so 31 January plus one month is 28 or 29 February. A 29 February start observed in a common year clamps to 28 February. Impossible dates such as 2023-02-29 are rejected.
Why not just divide the total days by the length of a year?
Because months have unequal lengths and February changes in leap years, so a division does not give years, months and days. The calculator counts whole calendar months first, then the leftover days.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/fin/tenure \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"start_date":"2018-03-01","end_date":"2024-08-20"}'const res = await fetch("https://api.kit.forhosting.com/fin/tenure", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"start_date": "2018-03-01",
"end_date": "2024-08-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/tenure",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"start_date": "2018-03-01",
"end_date": "2024-08-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/tenure", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"start_date":"2018-03-01","end_date":"2024-08-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"start_date":"2018-03-01","end_date":"2024-08-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/tenure", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"start_date": "2018-03-01",
"end_date": "2024-08-20"
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.tenure",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Limits
year_min | 1 |
year_max | 9999 |
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
When the end date precedes the start date the task fails with invalid_input instead of inventing a negative duration.
Input contract, response shape, and inverted-date errors
The first is the commencement, hire, or origination calendar day; the second is the as-of or last day of the interval. Each value must be a strict ISO calendar day such as two thousand eighteen hyphen zero three hyphen zero one. The same calendar day on both sides is legal and returns zero years, zero months, zero days, and zero total days—the interval has started but no civil day has completed. Wire the free browser form for desk checks, then call the identical contract from scripts when you need bulk service-length lists. Send two required strings, start_date and end_date. Aliases including start, from, begin, and hire_date for the first field, and end, to, until, as_of, and reference_date for the second, are accepted by the same core so payroll scripts and search forms can keep familiar names without changing the math. Missing fields, empty strings, non-strings, strings that do not match the four-two-two digit pattern, years outside one through nine thousand nine hundred ninety-nine, months outside one through twelve, and days that do not exist in that month (the thirty-first of April, the twenty-ninth of February in a common year) all fail with invalid_input naming the field, and those failures are not billed. If end_date precedes start_date the task also fails with invalid_input: elapsed tenure cannot be negative, and an inverted pair is treated as a client error rather than a signed duration. On success the body echoes the normalized start_date and end_date ISO strings; integer years, months, and days; total_days as the non-negative civil-day span; a short English tenure phrase with correct singular and plural units; and a formula string documenting the civil-month algorithm. Successful API calls use the published base of $0.002 per item; validation failures do not consume prepaid balance.
Where a tenure calculator is used in HR, finance, and compliance
Because this capability is a pure parse engine, every successful call costs the published $0.002 base price with no model tokens and no outbound network, and failed validation does not consume prepaid balance.
Technical questions
What does the tenure calculator cost?
The browser tool is free. API requests use prepaid KIT balance at $0.002 per successful call; invalid input is not billed.