A lightweight, dependency-free JavaScript utility to calculate Thanksgiving, Black Friday, and Cyber Monday dates for a given year.
You can install this package via npm:
npm install black-fridayor using yarn:
yarn add black-fridayImport the functions and use them to get the respective holiday dates:
import { thanksgiving, blackFriday, cyberMonday } from 'black-friday';
console.log(thanksgiving()); // Returns the date of Thanksgiving for the current year
console.log(blackFriday()); // Returns the date of Black Friday for the current year
console.log(cyberMonday()); // Returns the date of Cyber Monday for the current year
console.log(thanksgiving(2026)); // Returns Thanksgiving date for 2026
console.log(blackFriday(2026)); // Returns Black Friday date for 2026
console.log(cyberMonday(2026)); // Returns Cyber Monday date for 2026Want to know how many days are left until the next shopping event?
import { daysUntilThanksgiving, daysUntilBlackFriday, daysUntilCyberMonday } from 'black-friday';
console.log(daysUntilThanksgiving()); // Days until Thanksgiving this year
console.log(daysUntilBlackFriday()); // Days until Black Friday
console.log(daysUntilCyberMonday()); // Days until Cyber MondayReturns the date of Thanksgiving (fourth Thursday of November) for the given year. Defaults to the current year if no year is provided.
Returns the date of Black Friday (the day after Thanksgiving) for the given year. Defaults to the current year if no year is provided.
Returns the date of Cyber Monday (the Monday after Thanksgiving) for the given year. Defaults to the current year if no year is provided.
Returns the number of days remaining until Thanksgiving Day for the given year. Defaults to the current year if no year is provided.
Returns the number of days remaining until Black Friday for the given year. Defaults to the current year if no year is provided.
Returns the number of days remaining until Cyber Monday for the given year. Defaults to the current year if no year is provided.
- No dependencies
- Simple and efficient
- Works in both Node.js and browser environments