Date Calculator
What This Calculator Does
This date calculator has two modes. The Date Difference mode calculates the exact duration between two dates in years, months, days, total days, and weeks. The Add/Subtract mode lets you add or subtract a specified number of days, weeks, months, or years from a starting date to find the resulting date.
Inputs Explained
- Start Date: The beginning date for your calculation, in YYYY-MM-DD format.
- End Date (Difference mode): The ending date. The calculator finds the duration between the start and end dates.
- Amount (Add/Subtract mode): A whole number of units to add or subtract from the start date.
- Unit: The time unit for addition or subtraction — Days, Weeks, Months, or Years.
- Operation: Choose Add (+) to move forward in time, or Subtract (−) to move backward.
How It Works
For date differences, the calculator uses the Luxon library to compute the interval between two dates. It first extracts full years, then full months from the remainder, then the leftover days. Total days and weeks are calculated as simple divisions. For the Add/Subtract mode, the specified number of units is added to (or subtracted from) the start date using calendar-aware arithmetic that handles month-end boundaries and leap years.
Formulas Used
Date Difference = End Date − Start Date → Y years, M months, D days
Total Days = floor(End Date − Start Date) in days
Total Weeks = floor(Total Days ÷ 7)
Add/Subtract: Result Date = Start Date ± Amount × Unit
Total Days = floor(End Date − Start Date) in days
Total Weeks = floor(Total Days ÷ 7)
Add/Subtract: Result Date = Start Date ± Amount × Unit
Calculate duration between two dates.
Add or subtract time from a date.
Step-by-Step Example: Date Difference
Start Date: March 15, 2024
End Date: January 31, 2026
Step 1: Full years from Mar 15, 2024 to Mar 15, 2025 = 1 year.
Step 2: Full months from Mar 15, 2025 to Jan 15, 2026 = 10 months.
Step 3: Remaining days from Jan 15 to Jan 31, 2026 = 16 days.
Result: 1 year, 10 months, 16 days. Total: 687 days (98 weeks, 1 day).
Step-by-Step Example: Add Days
Start Date: January 31, 2026
Operation: Add 90 Days
Result: May 1, 2026 (Thursday)
Use Cases
- Project management: Calculate deadlines by adding working days or weeks to a project start date.
- Pregnancy tracking: Find your estimated due date by adding 280 days (40 weeks) to the first day of your last period.
- Legal deadlines: Compute filing deadlines, notice periods, or statute of limitations expiration dates.
- Event planning: Count down the days until a wedding, graduation, or holiday.
- Financial calculations: Determine the exact number of days between two dates for interest calculations.
Assumptions and Limitations
- All calculations use the Gregorian calendar. Julian calendar dates are not supported.
- When adding months, if the resulting day exceeds the target month's length (e.g., Jan 31 + 1 month), the date rolls to the last valid day of the target month.
- Week calculations are based on 7-day blocks and do not account for business days or weekends.
- The calculator does not account for holidays or business-day conventions.
- Leap years are handled correctly — February 29 is included when applicable.
Frequently Asked Questions
Subtract the start date from the end date and that's your answer. The calculator does the heavy lifting on month lengths, leap years and the calendar's quirks. So between 1 January 2025 and 7 May 2026, you get 491 days. Most tools also offer a years-months-days view, which is handy for things like project timelines or visa stay calculations. If you want the gap to include both endpoints, just add one to the result — that's the inclusive count.
Pick your start date, switch the calculator to "Add" mode, type the number of days and hit calculate. The tool jumps forward exactly that many days, handling month rollovers and leap years for you. So 15 January 2026 plus 100 days lands on 25 April 2026. You can usually add weeks, months or years too — months get a bit tricky because they're different lengths, but the calculator picks the same date in the target month and clamps to the last day if needed.
Switch the calculator to "Subtract" mode, enter your reference date, then type how many days, weeks, months or years you want to roll back. The tool moves backward across the calendar and gives you the resulting date. So 31 December 2025 minus 90 days gives you 2 October 2025. This is genuinely useful for working out things like "when did I start that job?" or "what date was 6 months ago for my warranty?" — anything where you know the end and need the beginning.
First find the total number of days between the two dates, then divide by 7. The whole-number part is your complete weeks, and the remainder is leftover days. Between 1 January 2026 and 7 May 2026 you have 126 days, which is exactly 18 weeks with 0 days left over. If you only care about full weeks, just take the integer part. The calculator usually shows both the precise decimal (like 18.0 weeks) and the weeks-and-days breakdown, so you can pick whichever is more useful.
By default, no — the calculator measures the gap between the two dates, not the dates themselves. So 1 January to 2 January gives you 1 day, not 2. This is the standard "exclusive" count and matches how most people think about durations. If you need the inclusive count (counting both the first and last day, like for a hotel stay or rental period), just add 1 to the result. Some calculators have a checkbox for this — worth checking before you rely on the number for billing or contracts.
February doesn't have a 31st, so the calculator clamps the result to the last valid day of February — that's 28 February in a normal year, or 29 February in a leap year. So 31 January 2026 plus one month becomes 28 February 2026. Different tools handle this slightly differently — a few will roll over to 3 March instead — but month-end clamping is the most common and matches how Excel and most programming languages behave. Worth knowing if you're calculating EMI dates or rent cycles around month ends.
Set today as your start date, choose "Add" mode, enter 90 in the days field and the calculator gives you the exact deadline. From 7 May 2026, that lands on 5 August 2026. One thing to watch — many legal and business deadlines are counted in business days, which exclude weekends and holidays. If your contract says "90 business days", you'll need a workday calculator instead, or you can roughly estimate by adding about 126 calendar days (since business days lose 2 of every 7). Always check the exact rule.
Two ways to do it. Either multiply 12 by 7 to get 84, then add that many days to today, or just select "Weeks" as the unit and add 12 directly. Both give the same result. From 7 May 2026, 12 weeks ahead lands on 30 July 2026. This is handy for things like pregnancy milestones, training programmes, project sprints or trial periods. If your start date isn't today, change it first — the tool calculates from whatever date you set, not just from the current day.
Calendar-day calculators count every day, but business days exclude Saturdays, Sundays and (usually) public holidays. If your tool only does calendar days, a quick rule of thumb is to multiply by 5/7 to estimate business days — so 100 calendar days is roughly 71 working days. For exact counts, use a dedicated workday calculator that lets you skip specific holidays. This matters a lot for contract deadlines, payment terms ("Net 30 business days"), notice periods and court filings, where weekends genuinely don't count.
The calculator counts every actual day on the calendar, including 29 February when it falls inside your range. There's no averaging or rounding — if the leap day exists between your start and end date, it adds one day to the total. So the gap between 1 January 2024 and 1 January 2025 is 366 days, while 1 January 2025 to 1 January 2026 is 365. Over long spans this adds up: a 100-year stretch contains roughly 24 or 25 leap days depending on the years involved (since century years like 1900 aren't leap years).
Sources and References
- ISO 8601 Date and Time Format — International standard defining date representation formats used in this calculator.
- Gregorian Calendar – Encyclopaedia Britannica — Reference for the calendar system underpinning all date arithmetic.
- Luxon Documentation — Date-time library documentation for the calendar-aware math used in calculations.
- ECMAScript Internationalization API — Standard underlying JavaScript's date formatting capabilities.
- Schema.org WebPage Specification — Structured data schema used for this page's metadata.