import toDate from '../toDate/index' import requiredArgs from '../_lib/requiredArgs/index' import type { Interval } from '../types' /** * @name isWithinInterval * @category Interval Helpers * @summary Is the given date within the interval? * * @description * Is the given date within the interval? (Including start and end.) * * @param {Date|Number} date - the date to check * @param {Interval} interval - the interval to check * @returns {Boolean} the date is within the interval * @throws {TypeError} 2 arguments required * @throws {RangeError} The start of an interval cannot be after its end * @throws {RangeError} Date in interval cannot be `Invalid Date` * * @example * // For the date within the interval: * isWithinInterval(new Date(2014, 0, 3), { * start: new Date(2014, 0, 1), * end: new Date(2014, 0, 7) * }) * //=> true * * @example * // For the date outside of the interval: * isWithinInterval(new Date(2014, 0, 10), { * start: new Date(2014, 0, 1), * end: new Date(2014, 0, 7) * }) * //=> false * * @example * // For date equal to interval start: * isWithinInterval(date, { start, end: date }) // => true * * @example * // For date equal to interval end: * isWithinInterval(date, { start: date, end }) // => true */ export default function isWithinInterval( dirtyDate: Date | number, interval: Interval ): boolean { requiredArgs(2, arguments) const time = toDate(dirtyDate).getTime() const startTime = toDate(interval.start).getTime() const endTime = toDate(interval.end).getTime() // Throw an exception if start date is after end date or if any date is `Invalid Date` if (!(startTime <= endTime)) { throw new RangeError('Invalid interval') } return time >= startTime && time <= endTime }