Skip to content

Time and Date API: Count business days

Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar.

timeanddate.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Time and Date.

Inputs

Values from the run on Oct 31, 2026, shown under Output.

Region optionalregion

State or province for regional public holidays, such as California; omit for nationwide holidays only.

California

Default .

Country, requiredcountry

Country name or two-letter code, such as United States or US.

US

End Date, requiredend_date

Last date to count (YYYY-MM-DD), such as 2026-11-30.

2026-11-30

Start Date, requiredstart_date

First date to count (YYYY-MM-DD), such as 2026-11-23.

2026-11-23

Include End Date optionalinclude_end_date

Whether to count the end date, for example true.

true

True or false. Default true.

Output

From a run on Oct 31, 2026.
{  "region": "California",  "country": "United States",  "page_link": "https://www.timeanddate.com/holidays/us/2026",  "weekend_days": 2,  "business_days": 4,  "holidays_skipped": [    {      "date": "2026-11-26",      "name": "Thanksgiving Day",      "page_link": "https://www.timeanddate.com/holidays/us/thanksgiving-day"    },    {      "date": "2026-11-27",      "name": "Day After Thanksgiving",      "page_link": "https://www.timeanddate.com/holidays/us/day-after-thanksgiving"    }  ],  "total_calendar_days": 8}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
timeanddate.com/count_business_days
Returns
calendar days, weekend days, skipped holidays, business days, holiday calendar link

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method timeanddate.com/count_business_days with the inputs above.

Ask your agent

  • How many working days are there between March 2, 2026 and April 17, 2026 in Germany, not counting public holidays?
  • Using timeanddate.com, count the business days from 2026-12-01 to 2026-12-31 in Canada, including Ontario provincial holidays.
  • I need the number of weekdays between June 15 and August 28, 2026 in Australia (New South Wales), minus public holidays — also show how many weekend days and which holidays were skipped.
  • Check Time and Date for how many working days fall between 2026-11-23 and 2026-11-30 in the US, excluding the end date.
  • Our contract says delivery within business days from January 5, 2027 to February 19, 2027 in the UK — how many is that once bank holidays are excluded?
  • Converts a meeting time in one city to local times in other cities, with time zones and 09:00-17:00 working-hours status. Supports dates from 1970 to 2030; ambiguous clock-change times use the first occurrence.

    timeanddate.com/convert_time_between_cities
  • Gets daily sunrise, sunset, solar noon, day length and civil twilight for a place from Time and Date, for one or more consecutive days. Times are local with UTC offset; days without sunrise or sunset are marked.

    timeanddate.com/get_sunrise_and_sunset
  • Gets the current local time, time zone, and next daylight saving change for a city listed on Time and Date. Add a state or country to distinguish cities with the same name.

    timeanddate.com/get_time_in_city
  • Lists scheduled and recent economic releases from the Investing.com economic calendar for a date range (up to 31 days, default this week), countries and importance, with actual, forecast and previous values as displayed, in the requested time zone.

    investing.com/get_economic_calendar
  • Checks whether a date is a public holiday or weekend in a country. By default only nationwide holidays count; give a region to include holidays observed there.

    date.nager.at/check_public_holiday
  • Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status.

    nasa.gov/list_near_earth_asteroids
  • Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.

    finance.yahoo.com/get_earnings_calendar
  • Lists GOV.UK bank holidays for a UK region and year, including substitute days and notes, plus the next upcoming holiday. Years GOV.UK does not publish return an empty list and the published years.

    gov.uk/list_bank_holidays