List the 26 Swiss cantons with their ISO subdivision codes.

Resolve a canton name to the CH-XX code every other tool needs; call this first when the user gives a canton by name.

Use this first to resolve a canton name to the CH-XX code that every other tool expects.

List the Schularten (school types) that publish separate holiday tables.

Discover whether a canton differentiates school holidays by Schulart before querying, so VS/MS/BS/EO filters are used only where they exist.

Only a minority of cantons differentiate. For Zurich the codes are CH-ZH-VS (Volksschulen), CH-ZH-MS (Mittelschulen) and CH-ZH-BS (Berufsfachschulen). Cantons absent from this list publish one table for all school types.

Return school holiday periods for one canton in a date range.

Look up a canton's school holidays for planning within an explicit from/to window (term breaks, parent events, campaigns). Apparent duplicates are the same period per Schulart; set school_type to collapse them. Cantons that do not differentiate return one table.

Args: canton: ISO subdivision code, e.g. CH-ZH. valid_from: Inclusive start date, YYYY-MM-DD. valid_to: Inclusive end date, YYYY-MM-DD. school_type: Optional Schulart suffix -- VS, MS, BS or EO. Use VS for compulsory schooling (Volksschule). language: DE, FR, IT or EN.

Records that look duplicated are usually the same period published for a different Schulart. Set school_type to collapse them.

Return public holidays for one canton and calendar year.

Get a canton's official public holidays for a whole year — cantonal holidays (Berchtoldstag, Fronleichnam) differ, so always pass the canton.

Cantonal holidays such as Berchtoldstag differ substantially across Switzerland, so always pass the canton rather than assuming the federal set.

Public holidays for a single municipality or district, incl. local specifics.

Answer the locality question the canton-level tools flatten away: which holidays are observed only in this town (e.g. Zurich's Sechselaeuten)? scope is 'local' (specific here), 'regional' (canton/district) or 'national' (inherited). Accepts a name or a full subdivision code.

Answers the local question the canton-level tools flatten away: which holidays are observed only here? The city of Zurich, for example, keeps Sechseläuten and Knabenschiessen (both half-day), which the rest of the canton does not.

municipality accepts a name (e.g. "Zürich", "Morschach") or a full subdivision code (e.g. "CH-ZH-ZH-ZH"). The result lists every holiday that applies in that locality; each carries a scope of local (specific to this place), regional (inherited from the canton/district) or national.

Check whether a given date falls into school holidays or a public holiday.

The everyday scheduling question: can we hold the parents' evening on that Thursday? Checks one date against both school and public holidays.

The everyday question behind this tool: "Can we schedule the parents' evening on that Thursday?"

Compare school holiday overlap between cantons for a calendar year.

Quantify inter-cantonal school-holiday overlap (pairwise day counts) for coordinating events or campaigns across cantonal borders.

Returns a pairwise matrix of overlapping holiday days. Defaults to VS (Volksschule) because that is the level most inter-cantonal coordination concerns.

Find date ranges in which all listed cantons are simultaneously on holiday.

Find a common free window across several cantons — joint events, maintenance or campaigns when every listed canton is on holiday.

Useful for planning campaigns, joint events or maintenance windows across cantonal borders.

Return the next upcoming school holiday periods for a canton.

Forward-looking planning: the next N school-holiday periods for a canton from today, without computing a date range by hand.

Return Swiss long weekends and the bridge days needed to create them.

Plan bridge days: which long weekends exist this year and which working days must be taken off to extend them. Computed from federal public holidays (Nager.Date); cantonal-only holidays are not considered.

Sourced from Nager.Date, which computes these from federal public holidays; cantonal-only holidays are not considered.

Report reachability and latency of both upstream sources.

Health check before a batch of queries, or to distinguish 'no data' from 'source down' — always returns an evaluable status.

Always returns an evaluable status rather than an empty result set, so that "no data" can be distinguished from "source down".

Export a canton's holidays for a year as an iCalendar (.ics) document.

Produce a ready-to-import .ics calendar of a canton's holidays for a year, filtered by public/school and Schulart.

Returns a ready-to-save text/calendar document with one all-day event per holiday. include selects all (default), public or school; combine with school_type (VS/MS/BS/EO) to narrow school holidays.

Is today a school or public holiday in the given canton?

One-call convenience for the everyday 'are we off today?' question in a given canton.

Convenience wrapper over check_date for the everyday question "are we off today?".