# Days Between Dates Calculator MCP MCP

> Days Between Dates Calculator lets you accurately calculate time intervals between any two dates, breaking down spans into years, months, weeks, and days. Beyond simple counting, it calculates only working days—and optionally filters out regional holidays for both US and European markets. It also verifies if a date is a recognized national holiday in your selected region. This MCP handles complex temporal math so you don't have to manually check calendars or build custom spreadsheet formulas.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** date, calendar, intervals, business-days, holidays

## Description

Need to know the exact time span between two project milestones? Don't waste time toggling between calendar apps and spreadsheets. This MCP provides specialized tools that calculate precise date intervals, giving you a detailed breakdown of years, months, weeks, and days passed. If your work depends on business hours—say, calculating payroll or tracking contractor time—you can determine the total number of working days while excluding weekends and specific regional holidays. Need to know if next quarter's launch date is a public holiday? You can verify that status instantly against national calendars for US or European regions. Integrating this through Vinkius means your AI client accesses all these functions from one place, letting you get accurate dates fast.

## Tools

### count_business_days
Calculates the total count of weekdays between two specified dates.

### get_date_breakdown
Provides a detailed, granular breakdown of time elapsed across years, months, weeks, and days.

### verify_holiday_status
Checks if an exact date is marked as a national holiday within a selected country or region.

## Prompt Examples

**Prompt:** 
```
How many days are between 2023-01-01 and 2023-12-31?
```

**Response:** 
```
You can use `get_date_breakdown` with startDate: '2023-01-01' and endDate: '2023-12-31' to see the exact breakdown.
```

**Prompt:** 
```
Check if 2024-07-04 is a holiday in the USA.
```

**Response:** 
```
The `verify_holiday_status` tool can confirm this by checking targetDate: '2024-07-04' and region: 'USA'.
```

**Prompt:** 
```
Calculate working days between 2024-01-01 and 2024-01-10, excluding holidays.
```

**Response:** 
```
Use `count_business_days` with startDate: '2024-01-01', endDate: '2024-01-10', and excludeHolidays: true.
```

## Capabilities

### Determine Interval Breakdown
Gets a detailed breakdown of the time elapsed between two specific calendar dates.

### Count Working Days
Calculates the total number of working days, automatically skipping weekends and specified holidays within a date range.

### Check Holiday Status
Verifies if any given date is officially recognized as a national holiday for a selected region (USA or Europe).

## Use Cases

### Calculating project duration with holidays
A Project Manager needs to tell a client that their phase two milestone is 45 working days away, but they must account for US federal holidays and weekends. They ask their agent using `count_business_days`, and the MCP returns the exact number, guaranteeing accuracy without manual calendar checks.

### Auditing contract timelines
An HR Specialist needs to know if a one-year notice period for an employee crosses any recognized national holidays in their state. They run `verify_holiday_status` against the entire year, and the MCP flags every date that isn't a working day.

### Comparing historical time spans
A Finance Analyst needs to compare the elapsed time between two quarterly reports. Instead of just counting years, they use `get_date_breakdown` to see exactly how many months and weeks separated the dates.

## Benefits

- Stop guessing on deadlines. The `get_date_breakdown` tool gives you a full Y/M/W/D breakdown of any two dates, perfect for explaining timelines to stakeholders who don't understand date math.
- Automate compliance checks: Use the `verify_holiday_status` function to instantly confirm if an important deadline or payment date conflicts with a national holiday in the US or Europe.
- Accurate time tracking is key. The `count_business_days` tool ensures your project timelines only count actual working days, cutting out weekend guesswork and manual exclusion.
- Consistency matters for reporting. By centralizing these calculations, you ensure that every date calculation—whether a full breakdown or just a day count—follows the same set of rules.
- It saves time on complex math. You never have to write `WORKDAY.INTL` formulas again; your agent handles all the regional holiday logic for you.

## How It Works

The bottom line is you get accurate time metrics for planning, payroll, or reporting without writing any formulas yourself.

1. Specify the starting and ending dates, along with any required regional settings.
2. Your AI client sends these parameters to the MCP's date calculation tools.
3. The system returns a precise output: either a full breakdown (Y/M/W/D), a filtered count of working days, or a simple true/false holiday status.

## Frequently Asked Questions

**How do I check if a date is a holiday using verify_holiday_status?**
You provide the target date and the region (USA or Europe). The MCP confirms whether that specific date is recognized as a national day off, saving you from checking multiple government websites.

**Can count_business_days handle holidays?**
Yes. You can use `count_business_days` to calculate working days between two points while specifying which regional holidays should be excluded from the count.

**What is the difference between get_date_breakdown and count_business_days?**
`get_date_breakdown` gives you a full structural breakdown (Y/M/W/D). `count_business_days` only gives you the total number of working days, ignoring weekends and holidays.

**Which tool do I use if I need to count business days in Europe?**
Use the `count_business_days` tool. You'll specify the European region when setting up your parameters, ensuring regional holiday exclusions are applied correctly.

**What happens if I use `get_date_breakdown` with improperly formatted date strings?**
It returns an explicit error message detailing the format issue. You must pass all dates using the standard YYYY-MM-DD format for accurate time calculation.

**How does `count_business_days` define a working day interval?**
It counts Monday through Friday, excluding both weekends and any specific regional holidays you choose to exclude. If you don't specify exclusions, it only accounts for standard weekend closures.

**When calling `verify_holiday_status`, do I need to pre-configure the region?**
No. You simply pass the desired regional code directly in the tool call. The MCP automatically checks for national holidays based on that specific region's established calendar rules.

**Is there a performance limit when using `get_date_breakdown` for very large date ranges?**
While there isn't a strict hard limit, the calculation performs best over periods spanning less than several years. For massive time spans, break your request into smaller, manageable chunks.