# 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. Unofficial. Not affiliated with or endorsed by Time and Date. - Page: https://fous.com/methods/timeanddate.com/count-business-days - Method: `timeanddate.com/count_business_days`, version 1 - Website: timeanddate.com - Returns: calendar days, weekend days, skipped holidays, business days, holiday calendar link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `region` | string | no | `"California"` | State or province for regional public holidays, such as California; omit for nationwide holidays only. Default "". | | `country` | string | yes | `"US"` | Country name or two-letter code, such as United States or US. | | `end_date` | string | yes | `"2026-11-30"` | Last date to count (YYYY-MM-DD), such as 2026-11-30. | | `start_date` | string | yes | `"2026-11-23"` | First date to count (YYYY-MM-DD), such as 2026-11-23. | | `include_end_date` | boolean | no | `true` | Whether to count the end date, for example true. Default true. | ## Output From a run on Oct 31, 2026. Its input: ```json { "region": "California", "country": "US", "end_date": "2026-11-30", "start_date": "2026-11-23", "include_end_date": true } ``` Its output: ```json { "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 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"timeanddate.com/count_business_days","input":{"region":"California","country":"US","end_date":"2026-11-30","start_date":"2026-11-23","include_end_date":true}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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? ## Input schema ```json { "type": "object", "required": [ "start_date", "end_date", "country" ], "properties": { "region": { "type": "string", "default": "", "description": "State or province for regional public holidays, such as California; omit for nationwide holidays only." }, "country": { "type": "string", "description": "Country name or two-letter code, such as United States or US." }, "end_date": { "type": "string", "description": "Last date to count (YYYY-MM-DD), such as 2026-11-30." }, "start_date": { "type": "string", "description": "First date to count (YYYY-MM-DD), such as 2026-11-23." }, "include_end_date": { "type": "boolean", "default": true, "description": "Whether to count the end date, for example true." } } } ``` ## Output schema ```json { "type": "object", "required": [ "country", "region", "total_calendar_days", "weekend_days", "holidays_skipped", "business_days", "page_link" ], "properties": { "region": { "type": [ "string", "null" ], "description": "Region used for regional holidays, or null for national holidays only." }, "country": { "type": "string", "description": "Country used for the calculation." }, "page_link": { "type": "string", "description": "Country holiday calendar used to count the dates." }, "weekend_days": { "type": "integer", "description": "Saturday and Sunday dates in the selected range." }, "business_days": { "type": "integer", "description": "Calendar days minus weekends and distinct weekday holiday dates." }, "holidays_skipped": { "type": "array", "items": { "type": "object", "required": [ "date", "name", "page_link" ], "properties": { "date": { "type": "string", "format": "date" }, "name": { "type": "string" }, "page_link": { "type": "string" } }, "additionalProperties": false }, "description": "Public holidays on weekdays that were skipped." }, "total_calendar_days": { "type": "integer", "description": "Number of calendar days in the selected range." } }, "additionalProperties": false } ``` ## See more - [Time and Date API: Convert time between cities](https://fous.com/methods/timeanddate.com/convert-time-between-cities.md): 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. - [Time and Date API: Get sunrise and sunset](https://fous.com/methods/timeanddate.com/get-sunrise-and-sunset.md): 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. - [Time and Date API: Get time in city](https://fous.com/methods/timeanddate.com/get-time-in-city.md): 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. - [Investing.com API: Get economic calendar](https://fous.com/methods/investing.com/get-economic-calendar.md): 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. - [Nager.Date API: Check public holiday](https://fous.com/methods/date.nager.at/check-public-holiday.md): 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. - [NASA API: List near-Earth asteroids](https://fous.com/methods/nasa.gov/list-near-earth-asteroids.md): Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status. - [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. - [GOV.UK API: List bank holidays](https://fous.com/methods/gov.uk/list-bank-holidays.md): 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. - [All Time and Date methods](https://fous.com/methods/timeanddate.com.md)