add_working_days

Move N working days from a date, skipping weekends and holidays; returns the end date and every skipped day with its reason. Delivery promises, SLA clocks, payment terms in business days. Example: start_date '2026-12-23', days 5, country 'DE', subdivision 'BY'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
days*	integer	Working days to add; negative counts backwards.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.
categories	any	Holiday categories to count as non-working; default ['public']. Others per country: bank, government, school, optional, half_day, catholic…
start_date*	string	ISO date to count from.
subdivision	any	Sub-national code (US 'CA', DE 'BY', AE 'DU', CA 'ON', AU 'NSW', IN 'KA'…). See list_calendars.
extra_holidays	any	Additional non-working ISO dates (company closures, contract-specific days).
count_start_day	boolean	If true and start_date is a working day it counts as day 1. Default false (start the day after).
include_estimated_holidays	boolean	Count projected lunar/moon-sighted holidays as non-working (true) or ignore them until announced (false).

Input schema (JSON)

{
  "type": "object",
  "title": "add_working_daysArguments",
  "required": [
    "start_date",
    "days"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "title": "Days",
      "description": "Working days to add; negative counts backwards."
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Market",
      "default": null,
      "description": "Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country."
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country",
      "default": null,
      "description": "ISO 3166-1 alpha-2 country code. Required unless market is given."
    },
    "weekend": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Weekend",
      "default": null,
      "description": "Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend."
    },
    "language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Language",
      "default": null,
      "description": "Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own."
    },
    "categories": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Categories",
      "default": null,
      "description": "Holiday categories to count as non-working; default ['public']. Others per country: bank, government, school, optional, half_day, catholic…"
    },
    "start_date": {
      "type": "string",
      "title": "Start Date",
      "description": "ISO date to count from."
    },
    "subdivision": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Subdivision",
      "default": null,
      "description": "Sub-national code (US 'CA', DE 'BY', AE 'DU', CA 'ON', AU 'NSW', IN 'KA'…). See list_calendars."
    },
    "extra_holidays": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Extra Holidays",
      "default": null,
      "description": "Additional non-working ISO dates (company closures, contract-specific days)."
    },
    "count_start_day": {
      "type": "boolean",
      "title": "Count Start Day",
      "default": false,
      "description": "If true and start_date is a working day it counts as day 1. Default false (start the day after)."
    },
    "include_estimated_holidays": {
      "type": "boolean",
      "title": "Include Estimated Holidays",
      "default": true,
      "description": "Count projected lunar/moon-sighted holidays as non-working (true) or ignore them until announced (false)."
    }
  }
}

compute_deadline

Compute the end of a period ('within 30 calendar days', '10 working days', '3 months') from a start date under explicit counting rules, roll it by the chosen convention when it lands on a non-working day, and return raw vs final deadline, skipped days and a step-by-step explanation plus a disclaimer. Pass the rules the contract/law states; defaults are the common ones. Example: start_date '2026-11-26', period 7, unit 'calendar_days', country 'GB'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
unit*	string	calendar_days \| working_days \| months.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
period*	integer	Length of the period; negative counts backwards.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend

is_working_day

Say whether a date is a working day in a country/subdivision or market, and why not (weekend, holiday name, holiday observed, projected lunar holiday). Example: date '2027-03-10', country 'SA'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
date*	string	ISO date YYYY-MM-DD.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.

list_calendars

Discover calendars: without arguments, all 250 countries and 30 markets; with a country code, its legal weekend, subdivision codes, holiday categories, languages, year range and public sources. Free. Example: country 'US'. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
country	any	Country code or market MIC for details (weekend, subdivisions, categories, languages, sources). Omit to list all 250 countries and 30 markets.

Input schema (JSON)

{
  "type": "object",
  "title": "list_calendarsArguments",
  "properties": {
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Country",
      "default": null,
      "description": "Country code or market MIC for details (weekend, subdivisions, categories, languages, sources). Omit to list all 250 countries and 30 markets."
    }
  }
}

list_holidays

All holidays of a year for a country/subdivision/categories or a market, each with local and English names, whether it is observed/shifted, projected (lunar), on a weekend, and whether it counts as non-working. Example: year 2027, country 'IN', subdivision 'KA'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
year*	integer	Calendar year.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.

next_holiday

The next N holidays on or after a date with days_until and projection flags. Example: from_date '2026-11-01', country 'JP', count 3. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
count	integer	How many upcoming holidays to return.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.
from_date*

roll_date

Apply a business-day convention (following, modified following, preceding, modified preceding) to a date on a country or market calendar — payment dates, coupon dates, settlement, SLA due dates. Example: date '2026-05-31', convention 'modified_following', market 'XLON'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
date*	string	ISO date to adjust.
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.

working_days_between

Count working days between two dates with endpoint control; lists the non-working days. Leave cost, lateness, elapsed business days. Example: '2026-05-18' → '2026-06-05', country 'AE', inclusive 'both'. Calendar selection: country (ISO 3166-1 alpha-2, e.g. 'SA', 'DE', 'US') or market (MIC, e.g. 'XNYS', 'XLON'); optional subdivision (state/province/emirate code from list_calendars), categories (e.g. ['public','bank']), weekend override (['FRI','SAT']), extra_holidays (company/contract dates). Weekend defaults to the country's legal weekend. Response: result plus data_confidence (high = fixed-date calendar; medium = a lunar/moon-sighted or projected holiday is involved, or the caller overrode the weekend), estimated_items[] naming each projected date, sources[] (public references behind the calendar), data_version and warnings[].

read-only

Argument	Type	Description
market	any	Financial market MIC (XNYS, XLON, XETR, XHKG, XJPX, XSAU…) — trading/settlement calendar instead of a country.
country	any	ISO 3166-1 alpha-2 country code. Required unless market is given.
weekend	any	Override the weekend, e.g. ['FRI','SAT'] or ['SUN']. Default: the country's legal weekend.
end_date*	string	ISO date; may be before start_date (negative result).
language	any	Language for holiday names where available (e.g. 'ar', 'de', 'en_US'). Default: the country's own.

Business-Day Oracle

Try it

add_working_days Read-only

Business-Day Oracle

Try it

add_working_days Read-only

Install

Tools (8)

Security checkA100/100