List bank holidays in a yearList every bank holiday one part of the UK keeps in a calendar year. Each one comes back with the date, the weekday, whether it is a substitute for a holiday that fell at a weekend, and whether bunting goes out for it. Narrow to a name, to the bunting days, or to the substitute days, and order it either way round. England and Wales keep eight most years, Scotland nine and Northern Ireland ten.
List bank holidays between two datesList the bank holidays one part of the UK has between two dates, whether or not they fall in the same year: a quarter, a sprint, a delivery window or the next six months in one step. GOV.UK publishes a rolling window of years, so a range reaching past it is trimmed to what exists and the result says so rather than quietly coming back short.
Get the next bank holidayGet the single next bank holiday for one part of the UK, returned flat so a later step can read the name, the date and how many days away it is without indexing into a list. Answers 'when is the next day off' in one step, and a scheduled workflow can act a fortnight before one. Counts from today unless you give it a date to count from.
Check whether a date is a bank holidayCheck one date in one part of the UK and get three plain answers: is it a bank holiday, is it a weekend, is it a working day. Use it to gate a workflow on whether an office is open, or to hold a message back until the next working day. It defaults to today, so 'is today a bank holiday' needs nothing filled in but the place. A date outside the years GOV.UK publishes is refused rather than answered no, because those are not the same thing.
Find a bank holiday by nameFind the dates a named bank holiday falls on, year by year: 'when is the Early May bank holiday', 'when is Christmas Day in Scotland'. Searching forwards from today by default, because that is usually the question. Names are matched loosely, so a partial name, a different case or a typed apostrophe all find it, and every match says how it matched. Watch for substitute days in the answer: Christmas Day 2027 comes back as 27 December, because that is the bank holiday.
Count working daysCount the working days between two dates, with weekends and the local bank holidays taken out. Use it for an SLA window, a notice period, a payroll run or a project estimate. It also hands back which bank holidays cost a working day and which fell at a weekend anyway, and the working week is a setting, so a business that trades on Saturday counts its own.
Add working days to a dateWork out the date a number of working days from another one, stepping over weekends and the local bank holidays. This is the deadline sum: 'we will reply within five working days' from a ticket's date, a payment due date, a notice period. Counting starts the day after the start date, which is how a deadline is written. A negative number counts backwards, for working out when to start in order to finish on time.
Compare a date across the UKAsk all three UK calendars about one date at once, and get a ready-made sentence saying who has the day off and who does not. This is the action for a business with people in more than one of them, because the calendars really do disagree: Easter Monday closes London and not Edinburgh, 2nd January closes Edinburgh and not London, and St Patrick's Day closes Belfast alone. Defaults to today.
List the calendars and the years coveredList the three bank holiday calendars GOV.UK publishes, the countries each one applies in, how many bank holidays each holds, the next one coming up in each, and the years the data reaches. The years matter, because they are a rolling window: nothing outside them can be answered. It is also the one-step check that the connection works.
