Dates & business calendar

Inputs

• date date · required — The starting date (YYYY-MM-DD).
• days integer · required — How many business days to add; negative to go back.
• weekend_days list of strings — Days that are not business days (names such as Saturday, or ISO numbers 1 = Monday … 7 = Sunday).
• holidays list of strings — Dates that are not business days, as YYYY-MM-DD (a list, or one per line).

Outputs

• date date — The resulting business day.
• weekday string — Monday … Sunday.
• calendar_days integer — Calendar days between the start and the result (negative when going back).

Inputs

• start date & time · required — When the clock starts (ISO 8601). Without Z or an offset it is local time in Time zone.
• hours number · required — The SLA in working hours (decimals allowed, e.g. 0.5).
• working_hours string — Start and end of the working day, e.g. 09:00-17:00 (use 00:00-24:00 for round the clock).
• working_days list of strings — Weekdays that have working hours (names or ISO numbers 1–7).
• time_zone string — IANA time zone of the working hours and holidays.
• holidays list of strings — Dates that are not business days, as YYYY-MM-DD (a list, or one per line).

Outputs

• due date & time — The due moment as an ISO 8601 UTC instant.
• due_local string — The due moment in the time zone, with its offset, e.g. 2026-11-09T14:30:00+13:00.
• due_date date
• start_local string — The start in the time zone, with its offset.
• calendar_hours number — Elapsed real time from start to due, in hours.

Inputs

• from date & time · required — Date (YYYY-MM-DD) or date-time.
• to date & time — Date or date-time; empty for now.
• time_zone string — Time zone for dates and times without an offset, and for counting calendar days.
• weekend_days list of strings — Days that are not business days (names such as Saturday, or ISO numbers 1 = Monday … 7 = Sunday).
• holidays list of strings — Dates that are not business days, as YYYY-MM-DD (a list, or one per line).

Outputs

• days integer — Whole calendar days.
• business_days integer — Business days after From up to and including To.
• hours number — Elapsed hours (2 decimals).
• minutes integer — Elapsed whole minutes.
• human string — For example "36 years, 3 months, 17 days" or "2 hours, 15 minutes".
• age_years integer — Whole years (age).
• age_months integer — Months after the whole years.
• age_days integer — Days after the whole months.

Inputs

• datetime date & time · required — ISO 8601. Without Z or an offset it is read in From zone.
• from_zone string — IANA time zone of a date-time without an offset.
• to_zone string · required — IANA time zone to show the moment in.

Outputs

• iso date & time
• local string — With its offset, e.g. 2026-11-03T03:00:00+13:00.
• local_date date
• local_time string — HH:mm.
• weekday string
• offset string — For example +13:00.
• offset_minutes integer

Inputs

• frequency choice · daily / weekly / monthly / yearly — How often it repeats.
• interval integer — Repeat every N days / weeks / months / years.
• days_of_week list of strings — Weekly: the days (names or ISO numbers); default the weekday of Start.
• day_of_month integer — Monthly / yearly: 1–31 (later than the month has = its last day) or -1 for the last day; default the day of Start.
• nth_week choice · none / first / second / third / fourth / last — Monthly / yearly: instead of a day of the month, the first … fourth or last Weekday.
• weekday string — With Nth weekday: Monday … Sunday.
• month integer — Yearly: 1–12; default the month of Start.
• time string — Local time of each occurrence (HH:mm).
• time_zone string — IANA time zone of the schedule.
• after date & time — List occurrences after this moment; empty for now.
• start date — First possible date of the schedule (the anchor for Every N); default the date of After.
• count integer — Number of occurrences to return (1–100).
• exclude_dates list of strings — Dates (YYYY-MM-DD) to leave out, e.g. holidays.

Outputs

• next date & time — The next occurrence (UTC instant); empty when none was found.
• next_local string — With its offset.
• occurrences list of datetimes — UTC instants, in order.
• occurrences_local list of strings — Local date-times with offsets.

Inputs

• date date — The date; empty for today (in Time zone).
• start_month integer — 1 = January … 12 = December, e.g. 7 for July (Australia, NZ public sector), 4 for April (UK, India, Japan, Canada).
• year_naming choice · end / start — The calendar year in which the fiscal year ends (FY2027 = July 2026–June 2027) or starts.
• time_zone string — For "today" when Date is empty.

Outputs

• fiscal_year integer
• quarter integer — 1–4.
• period integer — Month of the fiscal year, 1–12.
• label string — For example FY2027 Q2.
• period_label string — For example FY2027 P05.
• period_start date
• period_end date
• quarter_start date
• quarter_end date
• year_start date
• year_end date
• day_of_year integer — 1 on the first day.