Business Days & Holidays

Offline business-day and public-holiday calculator for Dify. Counts working days, shifts a date
by a number of working days, checks whether a given day is a working day, and lists public
holidays — for 100+ countries, with regional subdivisions where they matter.

No network access. No credentials. No account. All holiday data is bundled and evaluated
locally.

Why this plugin exists

Language models are unreliable at calendar arithmetic. "What is 30 working days after
2026-03-12 in Bavaria?" requires knowing that Corpus Christi is a public holiday in Bavaria but
not in Berlin, and then counting correctly around it. This plugin does that deterministically,
and the answer can be checked against a wall calendar in seconds.

Setup

1. Install the plugin from the Dify Marketplace.
2. There is nothing to configure. No API key, no OAuth, no endpoint, no host.

Tools

Is a given date a working day?

Returns whether the day is a business day, and if not, why — weekend or the name of the public
holiday.

How many working days lie between two dates?

Parameters: , , , optional , ,
(default ).

Returns the number of business days, calendar days, weekend days, the number of public holidays
that actually cost a working day, and the list of holidays in the range.

Note: a public holiday that falls on a weekend is listed in but is not
counted in , because it costs no working day.

What date is N working days from a given date?

Parameters: , (may be negative), , optional ,
.

returns the start date if it is a working day, otherwise the next working day.
Returns the resulting date and the list of days that were skipped, each with a reason.

Which public holidays fall in a date range?

Parameters: , , , optional , .

Country and subdivision codes

Countries use ISO 3166-1 alpha-2 codes. Subdivisions use the codes of the underlying
library — for Germany, for example, , ,
, . An unknown country or subdivision code produces an explicit error; it never silently
returns "no holidays".

Limitations

• Public holidays only. The plugin does not know about company holidays, school holidays,
  regional observances that are not public holidays, or individual leave.
• Holiday data comes from the bundled library and is as accurate as that library.
  For legally binding deadlines, verify against an official calendar.
• Historic and far-future dates are supported by the library but are less reliable the further
  they are from the present.
• The plugin does not handle times of day or time zones; it works on whole calendar dates.

Dependencies

• (MIT) — bundled public-holiday data.
• — the plugin SDK.

No other runtime dependencies. No network calls.

Privacy

See PRIVACY.md. The plugin collects, stores, logs and transmits nothing.

Source repository and contact

Source, issue tracker and contact: https://github.com/peppe1337/dify-plugin-business-days

Please raise questions and bug reports as GitHub issues in that repository.

License

MIT

Development and maintenance

This plugin is developed and maintained with the help of an automated agent operating on the
repository owner's behalf. Every calculation it performs is covered by the test suite in
, and the holiday data comes from the upstream library rather than from a
model. Issues and pull requests are read and answered.

Run the tests with: