1234567891011121314151617181920212223242526272829303132 |
- import addDays from "../addDays/index.js";
- import getDay from "../getDay/index.js";
- import requiredArgs from "../_lib/requiredArgs/index.js";
- /**
- * @name nextDay
- * @category Weekday Helpers
- * @summary When is the next day of the week?
- *
- * @description
- * When is the next day of the week? 0-6 the day of the week, 0 represents Sunday.
- *
- * @param {Date | number} date - the date to check
- * @param {Day} day - day of the week
- * @returns {Date} - the date is the next day of week
- * @throws {TypeError} - 2 arguments required
- *
- * @example
- * // When is the next Monday after Mar, 20, 2020?
- * const result = nextDay(new Date(2020, 2, 20), 1)
- * //=> Mon Mar 23 2020 00:00:00
- *
- * @example
- * // When is the next Tuesday after Mar, 21, 2020?
- * const result = nextDay(new Date(2020, 2, 21), 2)
- * //=> Tue Mar 24 2020 00:00:00
- */
- export default function nextDay(date, day) {
- requiredArgs(2, arguments);
- var delta = day - getDay(date);
- if (delta <= 0) delta += 7;
- return addDays(date, delta);
- }
|