nextBusinessDay

Signature

nextBusinessDay(value: string, calendar: BusinessCalendar): string

Return the first working day strictly after value.

• Strictly after: called on a working day it returns the next one, never value itself. For the on-or-after behaviour — leave a working day alone, move a non-working one forward — use rollDate(value, "following", calendar).
• Equivalent to addBusinessDays(value, 1, calendar) for any valid calendar, but the calendar is required here: there is no Saturday–Sunday default to fall back on, because a weekend is never assumed.
• value may be any local date, working or not: being called from a weekend or a holiday is the normal case, not an error.
• value and calendar.holidays are local dates; calendar.timeZone is not read. A caller holding an instant reduces it to a local date first, with floorToZone.
• Returns "" when value is not a valid ISO PlainDate, when calendar is not a valid BusinessCalendar, and when the walk runs past 200,000 calendar days without finding a working day.

Parameters

Parameter	Type	Description
value	string	ISO PlainDate string to start from, excluded from the search
calendar	BusinessCalendar	BusinessCalendar naming the weekend days and holidays

Returns

ISO PlainDate string of the next working day, or "" on invalid input

Related types

• BusinessCalendar

Examples

import { nextBusinessDay } from "@northguild/gmt/calendar/business";

nextBusinessDay("2024-07-03", { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "America/New_York" }) // "2024-07-05" — skips the holiday

valuecalendar

output

 

Source

calendar/business/nextBusinessDay.ts