Categories

← View All Tools

Working Days Calculator

Calculate working days between two dates, excluding weekends and holidays

Key Facts

Category
Utilities
Input Types
text, select, checkbox, number
Output Type
json
Sample Coverage
4
API Ready
Yes

Overview

The Working Days Calculator allows you to accurately determine the number of business days between two dates by automatically excluding weekends and public holidays.

When to Use

  • •Planning project timelines and delivery deadlines.
  • •Calculating payroll or billable hours based on actual work days.
  • •Determining the duration of a contract or service agreement.

How It Works

  • •Enter your start and end dates in the required fields.
  • •Select your country to automatically account for regional public holidays.
  • •Toggle the exclusion settings for weekends and holidays to refine your calculation.
  • •Add specific custom dates to exclude if your organization observes unique non-working days.

Use Cases

Project management for calculating realistic sprint durations.
HR departments determining vacation day accruals.
Freelancers estimating project completion dates for clients.

Examples

1. Project Deadline Estimation

Project Manager
Background
A project manager needs to know how many actual working days are available between the project kickoff and the final delivery date.
Problem
Manual counting is prone to errors due to varying month lengths and public holidays.
How to Use
Input the start date, end date, and select the relevant country to filter out holidays.
Example Config
startDate: 2024-01-01, endDate: 2024-03-31, country: US, excludeWeekends: true, includeHolidays: true
Outcome
The tool provides an exact count of 62 working days, excluding weekends and US federal holidays.

2. Contractual Service Period

Legal Consultant
Background
A consultant is drafting a contract that requires services to be performed over 20 business days.
Problem
Determining the exact end date while accounting for a company-specific holiday.
How to Use
Set the start date and add the specific company holiday date into the custom field.
Example Config
startDate: 2024-05-01, customHolidays: 2024-05-10
Outcome
The calculator identifies the correct end date by skipping the weekend and the specified custom holiday.

Try with Samples

utilities
Windows Date and Time - C# Samples
Comprehensive C# date and time processing examples for Windows platform including DateTime, TimeSpan, TimeZone, and calendar operations
task process
sample
QUIC Protocol Implementation Samples
Comprehensive QUIC protocol samples covering HTTP/3 implementation, UDP reliable transport, connection migration, and performance optimization
keywords working,work
sample
ELK Stack Log Analysis Samples
Comprehensive ELK Stack (Elasticsearch, Logstash, Kibana) samples for log aggregation, processing, and visualization in distributed systems
task process
sample
Pytest Testing Framework
Comprehensive Pytest testing examples including unit tests, integration tests, fixtures, parametrization, mocking, and advanced testing patterns for Python applications
keywords work
sample

Related Hubs

Utilities Convert Tools
Explore 10 utilities tools for convert workflows and compare closely related utilities quickly.

FAQ

Does this tool account for leap years?

Yes, the calculator automatically adjusts for leap years when calculating the span between dates.

Can I exclude specific dates that aren't public holidays?

Yes, use the 'Custom Holidays' field to enter any specific dates you wish to exclude from the count.

What happens if I select 'No public holidays'?

The tool will only exclude weekends (if enabled) and ignore all regional holiday calendars.

Is the start date included in the calculation?

The tool calculates the total number of business days within the inclusive range of your selected start and end dates.

Why is the precision setting useful?

The precision setting allows you to format the result to a specific number of decimal places, which is helpful for financial or payroll reporting.

API Documentation

Request Endpoint

POST /en/api/tools/working-days-calculator

Request Parameters

Parameter Name Type Required Description
startDate text Yes -
endDate text Yes -
country select No -
includeHolidays checkbox No -
excludeWeekends checkbox No -
customHolidays text No -
precision number No -

Response Format

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
JSON Data: JSON Data

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-working-days-calculator": {
      "name": "working-days-calculator",
      "description": "Calculate working days between two dates, excluding weekends and holidays",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=working-days-calculator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

If you encounter any issues, please contact us at [email protected]