Developer tool

Date Calculator

Measure calendar spans and add or subtract days, weeks, months, or years.

Practical guide

How to use Date Calculator

Date Calculator measures the elapsed span between two date-only values and adds or subtracts calendar units from a starting date. It reports total days, weekdays, weeks plus days, and an inclusive count, while keeping date-only arithmetic separate from clocks and timezone offsets.

Step by step

  1. Choose a start and end date to measure their signed calendar-day difference.
  2. Review total days, inclusive days, weekdays, and the weeks-plus-days representation.
  3. For calendar arithmetic, select a quantity and unit, then verify how month-end or leap-day clamping affects the result.

Example

InputStart 2026-01-31 · add 1 month
Result2026-02-28 because February has no day 31

How it works

Date inputs are converted to UTC calendar components so daylight-saving clock changes do not turn a date-only span into 23 or 25 hours. Month and year operations preserve the intended day when possible and clamp to the last valid day of the target month.

Important limitations

  • Weekdays exclude Saturday and Sunday but do not know national, regional, company, or market holidays.
  • The calculator works with Gregorian date-only values and does not calculate times, durations below one day, or named timezone transitions.
  • Legal deadlines and billing periods can use domain-specific inclusion rules that differ from the displayed arithmetic.

Real workflows

When this tool is useful

Project planning

Measure calendar and weekday spans between milestones before applying an organization's holiday calendar and working-hour policy.

Renewal and expiry

Add a documented number of days, months, or years to a start date and inspect how month-end clamping changes the result.

Editorial timeline

Count inclusive calendar dates for a campaign or event while keeping that convention explicit for collaborators.

Review the result

What to check before using the output

Decide whether the rule uses elapsed days, inclusive dates, weekdays, business days, calendar months, or fixed-hour durations. Test leap years, month ends, reverse order, and jurisdiction-specific holidays.

  • Name the counting convention.
  • Check month-end clamping.
  • Apply official holidays separately.
  • Use timestamp tools for time-of-day work.

Choose the right method

When another tool is better

Use a domain-specific calendar library or authoritative system for legal deadlines, financial day-count conventions, trading calendars, payroll, holidays, and timezone-aware timestamps. This page performs transparent general calendar arithmetic.

Privacy and browser behavior

Date-only values are processed locally. Dates associated with medical events, employment, travel, contracts, or customer records can still be personal information when exposed in screenshots or reports.

Frequently asked questions

Why are inclusive days one larger?

Inclusive counting treats both the start and end dates as counted calendar dates; elapsed-day difference measures the boundaries between them.

How are negative spans handled?

When the end precedes the start, the total is negative while the component summary identifies the direction.

Are public holidays excluded from weekdays?

No. Use an authoritative holiday calendar for the relevant jurisdiction or organization.