2026-07-05 06:41:32 +00:00
|
|
|
import requiredArgs from "../_lib/requiredArgs/index.js";
|
2026-07-07 07:11:50 +00:00
|
|
|
import nextDay from "../nextDay/index.js";
|
|
|
|
|
import toDate from "../toDate/index.js";
|
2026-07-05 06:41:32 +00:00
|
|
|
/**
|
|
|
|
|
* @name nextSunday
|
|
|
|
|
* @category Weekday Helpers
|
|
|
|
|
* @summary When is the next Sunday?
|
|
|
|
|
*
|
|
|
|
|
* @description
|
|
|
|
|
* When is the next Sunday?
|
|
|
|
|
*
|
|
|
|
|
* @param {Date | number} date - the date to start counting from
|
|
|
|
|
* @returns {Date} the next Sunday
|
|
|
|
|
* @throws {TypeError} 1 argument required
|
|
|
|
|
*
|
|
|
|
|
* @example
|
|
|
|
|
* // When is the next Sunday after Mar, 22, 2020?
|
|
|
|
|
* const result = nextSunday(new Date(2020, 2, 22))
|
|
|
|
|
* //=> Sun Mar 29 2020 00:00:00
|
|
|
|
|
*/
|
2026-07-07 07:11:50 +00:00
|
|
|
|
2026-07-05 06:41:32 +00:00
|
|
|
export default function nextSunday(date) {
|
|
|
|
|
requiredArgs(1, arguments);
|
2026-07-07 07:11:50 +00:00
|
|
|
return nextDay(toDate(date), 0);
|
2026-07-05 06:41:32 +00:00
|
|
|
}
|