import addDays from '../addDays/index' import differenceInCalendarDays from '../differenceInCalendarDays/index' import isSameDay from '../isSameDay/index' import isValid from '../isValid/index' import isWeekend from '../isWeekend/index' import toDate from '../toDate/index' import requiredArgs from '../_lib/requiredArgs/index' import toInteger from '../_lib/toInteger/index' /** * @name differenceInBusinessDays * @category Day Helpers * @summary Get the number of business days between the given dates. * * @description * Get the number of business day periods between the given dates. * Business days being days that arent in the weekend. * Like `differenceInCalendarDays`, the function removes the times from * the dates before calculating the difference. * * @param {Date|Number} dateLeft - the later date * @param {Date|Number} dateRight - the earlier date * @returns {Number} the number of business days * @throws {TypeError} 2 arguments required * * @example * // How many business days are between * // 10 January 2014 and 20 July 2014? * const result = differenceInBusinessDays( * new Date(2014, 6, 20), * new Date(2014, 0, 10) * ) * //=> 136 * * // How many business days are between * // 30 November 2021 and 1 November 2021? * const result = differenceInBusinessDays( * new Date(2021, 10, 30), * new Date(2021, 10, 1) * ) * //=> 21 * * // How many business days are between * // 1 November 2021 and 1 December 2021? * const result = differenceInBusinessDays( * new Date(2021, 10, 1), * new Date(2021, 11, 1) * ) * //=> -22 * * // How many business days are between * // 1 November 2021 and 1 November 2021 ? * const result = differenceInBusinessDays( * new Date(2021, 10, 1), * new Date(2021, 10, 1) * ) * //=> 0 */ export default function differenceInBusinessDays( dirtyDateLeft: Date | number, dirtyDateRight: Date | number ): number { requiredArgs(2, arguments) const dateLeft = toDate(dirtyDateLeft) let dateRight = toDate(dirtyDateRight) if (!isValid(dateLeft) || !isValid(dateRight)) return NaN const calendarDifference = differenceInCalendarDays(dateLeft, dateRight) const sign = calendarDifference < 0 ? -1 : 1 const weeks = toInteger(calendarDifference / 7) let result = weeks * 5 dateRight = addDays(dateRight, weeks * 7) // the loop below will run at most 6 times to account for the remaining days that don't makeup a full week while (!isSameDay(dateLeft, dateRight)) { // sign is used to account for both negative and positive differences result += isWeekend(dateRight) ? 0 : sign dateRight = addDays(dateRight, sign) } return result === 0 ? 0 : result }