Categories

← View All Tools

Holiday Calculator

Calculate holidays for a specific year and country

Key Facts

Category
Date & Time
Input Types
select, text
Output Type
text
Sample Coverage
3
API Ready
Yes

Overview

The Holiday Calculator is a precise utility designed to help you identify public holidays and national celebrations for any given year across multiple countries. Whether you are planning international business operations, scheduling travel, or organizing global team events, this tool provides accurate date information to ensure you never miss a non-working day.

When to Use

  • •Planning international business meetings or project deadlines across different time zones.
  • •Organizing travel itineraries to avoid closures during national public holidays.
  • •Setting up automated out-of-office responses or scheduling team availability for global operations.

How It Works

  • •Select the operation mode: choose 'List All Holidays' to view the full calendar or 'Check if Date is Holiday' for a specific inquiry.
  • •Input the target year to retrieve the relevant holiday schedule for that period.
  • •Select your target country from the provided list to filter results based on local national observances.
  • •If checking a specific date, enter the date in YYYY-MM-DD format to confirm its status as a public holiday.

Use Cases

Global HR teams managing payroll and leave schedules for international employees.
Logistics managers coordinating shipping and delivery timelines to avoid port or office closures.
Travelers verifying if local attractions or government offices will be open during their trip.

Examples

1. Planning a Global Team Meeting

Project Manager
Background
A project manager needs to schedule a sync call with a team distributed across the US and UK in 2026.
Problem
Avoid scheduling meetings on days when either country is observing a public holiday.
How to Use
Run the 'List All Holidays' operation for both 'US' and 'UK' for the year 2026.
Example Config
operation: listHolidays, year: 2026, country: US
Outcome
A complete list of 2026 US holidays is generated, allowing the manager to cross-reference dates with the UK calendar to find mutually available workdays.

2. Verifying Business Availability

Supply Chain Coordinator
Background
An order needs to be placed with a supplier in Japan, but the coordinator is unsure if a specific date is a public holiday.
Problem
Confirming if the office will be open on March 19, 2026.
How to Use
Select 'Check if Date is Holiday', set the country to 'Japan', and input the date '2026-03-19'.
Example Config
operation: checkDate, year: 2026, country: JP, date: 2026-03-19
Outcome
The tool returns a confirmation of whether the date is a public holiday, helping the coordinator decide whether to send the order or wait until the next business day.

Try with Samples

date-&-time
ELK Stack Log Analysis Samples
Comprehensive ELK Stack (Elasticsearch, Logstash, Kibana) samples for log aggregation, processing, and visualization in distributed systems
task process
sample
Text with Date Samples
Text containing various date formats for testing date extraction and parsing
task process
sample
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

FAQ

Which countries are supported?

The tool currently supports major economies including the United States, United Kingdom, Canada, Australia, Germany, France, China, Japan, and Brazil.

Can I check holidays for past years?

Yes, you can input any valid year to retrieve the historical holiday data for the selected country.

Does this tool account for regional holidays?

The calculator focuses on national public holidays. Regional or state-specific holidays may not be included in the primary list.

What format should I use for the date check?

Please use the standard ISO format: YYYY-MM-DD (e.g., 2026-12-25).

Is the data updated for leap years?

Yes, the calculation logic automatically accounts for leap years and varying holiday dates.

API Documentation

Request Endpoint

POST /en/api/tools/holiday-calculator

Request Parameters

Parameter Name Type Required Description
operation select Yes -
year text Yes -
country select Yes -
date text No -

Response Format

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
Text: Text

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-holiday-calculator": {
      "name": "holiday-calculator",
      "description": "Calculate holidays for a specific year and country",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=holiday-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]