@8ms/helpers 2.4.8 → 2.4.10

package/dist/date/calculation.cjs

@@ -0,0 +1,272 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../_virtual/_rolldown/runtime.cjs");
+let luxon = require("luxon");
+//#region src/date/calculation.ts
+/**
+* Return unix timestamp in seconds.
+*/
+const getUnix = (input) => {
+	return getLuxonDate(input).toUnixInteger();
+};
+/**
+* Assume the input is always UTC.
+*
+* If it's not UTC, it needs to be converted to UTC before being used.
+*/
+const getLuxonDate = (input, setMidnight) => {
+	let instance = luxon.DateTime.now().toUTC();
+	if (input) if (input instanceof Date) instance = luxon.DateTime.fromJSDate(input, { zone: "utc" });
+	else if (input instanceof luxon.DateTime) instance = input.toUTC();
+	else if ("number" === typeof input) if (input >= 19000101 && input <= 99991231) {
+		const dateStr = input.toString();
+		const year = parseInt(dateStr.substring(0, 4));
+		const month = parseInt(dateStr.substring(4, 6));
+		const day = parseInt(dateStr.substring(6, 8));
+		instance = luxon.DateTime.fromObject({
+			year,
+			month,
+			day
+		}, { zone: "utc" });
+	} else if (input < 1e10) instance = luxon.DateTime.fromSeconds(input, { zone: "utc" });
+	else instance = luxon.DateTime.fromMillis(input, { zone: "utc" });
+	else {
+		const inputString = input.toString().toLowerCase();
+		instance = luxon.DateTime.fromISO(inputString, { zone: "utc" });
+		if (!instance.isValid) {
+			const len = inputString.length;
+			if (23 === len) instance = luxon.DateTime.fromFormat(inputString, "yyyy-MM-dd HH:mm:ss.SSS", { zone: "utc" });
+			else if (19 === len) instance = luxon.DateTime.fromFormat(inputString, "yyyy-MM-dd HH:mm:ss", { zone: "utc" });
+			else {
+				instance = luxon.DateTime.fromFormat(inputString, "yyyy MMMM dd", { zone: "utc" });
+				if (!instance.isValid) instance = luxon.DateTime.fromFormat(inputString, "yyyy-MMMM-dd", { zone: "utc" });
+			}
+		}
+	}
+	instance = instance.setZone("utc", { keepLocalTime: false });
+	if (setMidnight) instance = instance.set({
+		hour: 0,
+		minute: 0,
+		second: 0,
+		millisecond: 0
+	});
+	return instance;
+};
+const isMonday = (input) => {
+	return getLuxonDate(input).weekday === 1;
+};
+const isTuesday = (input) => {
+	return getLuxonDate(input).weekday === 2;
+};
+const isWednesday = (input) => {
+	return getLuxonDate(input).weekday === 3;
+};
+const isThursday = (input) => {
+	return getLuxonDate(input).weekday === 4;
+};
+const isFriday = (input) => {
+	return getLuxonDate(input).weekday === 6;
+};
+const isSaturday = (input) => {
+	return getLuxonDate(input).weekday === 6;
+};
+const isSunday = (input) => {
+	return getLuxonDate(input).weekday === 7;
+};
+/**
+* Determines if a given date falls on a weekend.
+*
+* This function checks whether the day of the week for the provided input corresponds
+* to Saturday or Sunday, where weekday values of 6 and 7 represent Saturday and Sunday, respectively.
+*/
+const isWeekend = (input) => {
+	const luxonDate = getLuxonDate(input);
+	return 6 === luxonDate.weekday || 7 === luxonDate.weekday;
+};
+/**
+* Calculates the difference in minutes between two provided dates.
+*/
+const differenceInMinutes = (start, end) => {
+	const startDate = getLuxonDate(start);
+	return getLuxonDate(end).diff(startDate, "minutes").minutes;
+};
+/**
+* Calculates the difference in business days between two dates.
+* Business days are considered as weekdays (Monday to Friday).
+*/
+const differenceInBusinessDays = (start, end) => {
+	const startDate = getLuxonDate(start);
+	const endDate = getLuxonDate(end);
+	let businessDays = 0;
+	let current = startDate.startOf("day");
+	while (current < endDate.startOf("day")) {
+		if (current.weekday <= 5) businessDays++;
+		current = current.plus({ days: 1 });
+	}
+	return businessDays;
+};
+/**
+* Similar to date-fns' eachDayOfInterval, however the timezone messes this function up.
+* https://date-fns.org/v2.28.0/docs/eachDayOfInterval
+* https://www.gov.uk/when-do-the-clocks-change
+*/
+const getDatesBetween = (start, end) => {
+	const startInstance = getLuxonDate(start);
+	const endInstance = getLuxonDate(end);
+	return luxon.Interval.fromDateTimes(startInstance.startOf("day"), endInstance.endOf("day")).splitBy({ day: 1 }).map((d) => d.start);
+};
+/**
+* Get an array of DateTime objects representing the 1st of each month between start and end dates.
+*/
+const getMonthsBetween = (start, end) => {
+	const months = [];
+	const endDate = getLuxonDate(end).startOf("month");
+	let current = getLuxonDate(start).startOf("month");
+	while (current <= endDate) {
+		months.push(current);
+		current = current.plus({ months: 1 });
+	}
+	return months;
+};
+/**
+* If a given date is beyond the maximum, return the maximum.
+*/
+const getMax = (input, max) => {
+	return input > max ? max : input;
+};
+/**
+* If a given date is before the minimum, return the minimum.
+*/
+const getMin = (input, min) => {
+	return input < min ? min : input;
+};
+/**
+* Retrieve the closest last Monday relative to the input or today.
+* 0 weeksAgo - Tuesday (10th), return Monday (8th)
+* 1 weeksAgo - Tuesday (10th), return Monday (1st)
+*/
+const getMonday = (input, weeksAgo) => {
+	let instance = getLuxonDate(input);
+	if ("Mon" !== instance.toFormat("EEE")) {
+		const isoDay = Number(instance.toFormat("E")) - 1;
+		instance = instance.minus({ days: isoDay });
+	}
+	instance = instance.minus({ weeks: weeksAgo ?? 0 });
+	return instance;
+};
+/**
+* Retrieve the closest last Sunday relative to the input or today.
+* 0 weeksAgo - Tuesday (17th), return Sunday (14th)
+* 1 weeksAgo - Tuesday (17th), return Monday (7th)
+*/
+const getSunday = (input, weeksAgo) => {
+	let instance = getLuxonDate(input);
+	if ("Sun" !== instance.toFormat("EEE")) {
+		const isoDay = Number(instance.toFormat("E"));
+		instance = instance.minus({ days: isoDay });
+	}
+	instance = instance.minus({ weeks: weeksAgo ?? 0 });
+	return instance;
+};
+/**
+* Return an object of start/end predefined date of Last Week.
+* Creating a date from scratch (no user input), thus needs to be London time.
+*/
+const getLastWeek = () => {
+	return {
+		end: getMonday(void 0, 0),
+		start: getSunday(void 0, 1)
+	};
+};
+/**
+* Return an object of start/end predefined date of This Week.
+* Creating a date from scratch (no user input), thus needs to be London time.
+*/
+const getThisWeek = () => {
+	return {
+		end: getMonday(void 0, 0),
+		start: getSunday(void 0, -1)
+	};
+};
+/**
+* Return an object of start/end predefined date of Two Weeks Ago.
+* Creating a date from scratch (no user input), thus needs to be London time.
+*/
+const getTwoWeeksAgo = () => {
+	return {
+		end: getMonday(void 0, 1),
+		start: getSunday(void 0, 2)
+	};
+};
+/**
+* Shortcut to get today's date.
+* Creating a date from scratch (no user input), thus needs to be London time.
+*/
+const getToday = (setMidnight) => {
+	return getLuxonDate(void 0, setMidnight);
+};
+/**
+* From a given input, move the date back X weeksAgo
+*/
+const getWeeksAgo = (input, weeksAgo) => {
+	let instance = getLuxonDate(input);
+	instance = instance.plus({ weeks: weeksAgo });
+	return instance;
+};
+/**
+* Shortcut to get yesterday's date.
+* Creating a date from scratch (no user input), thus needs to be London time.
+*/
+const getYesterday = (input) => {
+	let instance = getLuxonDate(input);
+	instance = instance.minus({ days: 1 });
+	return instance;
+};
+/**
+* Check to see if a given timeframe is This Week.
+*/
+const isThisWeek = (start, end) => {
+	const inputWeek = {
+		start: getLuxonDate(start),
+		end: getLuxonDate(end)
+	};
+	const thisWeek = getThisWeek();
+	return inputWeek.start.hasSame(thisWeek.start, "day") && inputWeek.end.hasSame(thisWeek.end, "day");
+};
+/**
+* Check to see if a given timeframe is Last Week.
+*/
+const isLastWeek = (start, end) => {
+	const inputWeek = {
+		start: getLuxonDate(start),
+		end: getLuxonDate(end)
+	};
+	const lastWeek = getLastWeek();
+	return inputWeek.start.hasSame(lastWeek.start, "day") && inputWeek.end.hasSame(lastWeek.end, "day");
+};
+//#endregion
+exports.differenceInBusinessDays = differenceInBusinessDays;
+exports.differenceInMinutes = differenceInMinutes;
+exports.getDatesBetween = getDatesBetween;
+exports.getLastWeek = getLastWeek;
+exports.getLuxonDate = getLuxonDate;
+exports.getMax = getMax;
+exports.getMin = getMin;
+exports.getMonday = getMonday;
+exports.getMonthsBetween = getMonthsBetween;
+exports.getSunday = getSunday;
+exports.getThisWeek = getThisWeek;
+exports.getToday = getToday;
+exports.getTwoWeeksAgo = getTwoWeeksAgo;
+exports.getUnix = getUnix;
+exports.getWeeksAgo = getWeeksAgo;
+exports.getYesterday = getYesterday;
+exports.isFriday = isFriday;
+exports.isLastWeek = isLastWeek;
+exports.isMonday = isMonday;
+exports.isSaturday = isSaturday;
+exports.isSunday = isSunday;
+exports.isThisWeek = isThisWeek;
+exports.isThursday = isThursday;
+exports.isTuesday = isTuesday;
+exports.isWednesday = isWednesday;
+exports.isWeekend = isWeekend;

package/dist/date/calculation.d.cts

@@ -0,0 +1,106 @@
+import { InputDate, Timeframe } from "./date.cjs";
+import { DateTime } from "luxon";
+
+//#region src/date/calculation.d.ts
+/**
+ * Return unix timestamp in seconds.
+ */
+declare const getUnix: (input?: InputDate) => number;
+/**
+ * Assume the input is always UTC.
+ *
+ * If it's not UTC, it needs to be converted to UTC before being used.
+ */
+declare const getLuxonDate: (input?: InputDate, setMidnight?: boolean) => DateTime<boolean>;
+declare const isMonday: (input?: InputDate) => boolean;
+declare const isTuesday: (input?: InputDate) => boolean;
+declare const isWednesday: (input?: InputDate) => boolean;
+declare const isThursday: (input?: InputDate) => boolean;
+declare const isFriday: (input?: InputDate) => boolean;
+declare const isSaturday: (input?: InputDate) => boolean;
+declare const isSunday: (input?: InputDate) => boolean;
+/**
+ * Determines if a given date falls on a weekend.
+ *
+ * This function checks whether the day of the week for the provided input corresponds
+ * to Saturday or Sunday, where weekday values of 6 and 7 represent Saturday and Sunday, respectively.
+ */
+declare const isWeekend: (input?: InputDate) => boolean;
+/**
+ * Calculates the difference in minutes between two provided dates.
+ */
+declare const differenceInMinutes: (start: InputDate, end: InputDate) => number;
+/**
+ * Calculates the difference in business days between two dates.
+ * Business days are considered as weekdays (Monday to Friday).
+ */
+declare const differenceInBusinessDays: (start: InputDate, end: InputDate) => number;
+/**
+ * Similar to date-fns' eachDayOfInterval, however the timezone messes this function up.
+ * https://date-fns.org/v2.28.0/docs/eachDayOfInterval
+ * https://www.gov.uk/when-do-the-clocks-change
+ */
+declare const getDatesBetween: (start: InputDate, end: InputDate) => (DateTime<true> | null)[];
+/**
+ * Get an array of DateTime objects representing the 1st of each month between start and end dates.
+ */
+declare const getMonthsBetween: (start: InputDate, end: InputDate) => DateTime<boolean>[];
+/**
+ * If a given date is beyond the maximum, return the maximum.
+ */
+declare const getMax: (input: DateTime, max: DateTime) => DateTime<boolean>;
+/**
+ * If a given date is before the minimum, return the minimum.
+ */
+declare const getMin: (input: DateTime, min: DateTime) => DateTime<boolean>;
+/**
+ * Retrieve the closest last Monday relative to the input or today.
+ * 0 weeksAgo - Tuesday (10th), return Monday (8th)
+ * 1 weeksAgo - Tuesday (10th), return Monday (1st)
+ */
+declare const getMonday: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Retrieve the closest last Sunday relative to the input or today.
+ * 0 weeksAgo - Tuesday (17th), return Sunday (14th)
+ * 1 weeksAgo - Tuesday (17th), return Monday (7th)
+ */
+declare const getSunday: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Return an object of start/end predefined date of Last Week.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getLastWeek: () => Timeframe;
+/**
+ * Return an object of start/end predefined date of This Week.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getThisWeek: () => Timeframe;
+/**
+ * Return an object of start/end predefined date of Two Weeks Ago.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getTwoWeeksAgo: () => Timeframe;
+/**
+ * Shortcut to get today's date.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getToday: (setMidnight?: boolean) => DateTime<boolean>;
+/**
+ * From a given input, move the date back X weeksAgo
+ */
+declare const getWeeksAgo: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Shortcut to get yesterday's date.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getYesterday: (input?: InputDate) => DateTime<boolean>;
+/**
+ * Check to see if a given timeframe is This Week.
+ */
+declare const isThisWeek: (start: InputDate, end: InputDate) => boolean;
+/**
+ * Check to see if a given timeframe is Last Week.
+ */
+declare const isLastWeek: (start: InputDate, end: InputDate) => boolean;
+//#endregion
+export { differenceInBusinessDays, differenceInMinutes, getDatesBetween, getLastWeek, getLuxonDate, getMax, getMin, getMonday, getMonthsBetween, getSunday, getThisWeek, getToday, getTwoWeeksAgo, getUnix, getWeeksAgo, getYesterday, isFriday, isLastWeek, isMonday, isSaturday, isSunday, isThisWeek, isThursday, isTuesday, isWednesday, isWeekend };

package/dist/date/calculation.d.mts

@@ -0,0 +1,106 @@
+import { InputDate, Timeframe } from "./date.mjs";
+import { DateTime } from "luxon";
+
+//#region src/date/calculation.d.ts
+/**
+ * Return unix timestamp in seconds.
+ */
+declare const getUnix: (input?: InputDate) => number;
+/**
+ * Assume the input is always UTC.
+ *
+ * If it's not UTC, it needs to be converted to UTC before being used.
+ */
+declare const getLuxonDate: (input?: InputDate, setMidnight?: boolean) => DateTime<boolean>;
+declare const isMonday: (input?: InputDate) => boolean;
+declare const isTuesday: (input?: InputDate) => boolean;
+declare const isWednesday: (input?: InputDate) => boolean;
+declare const isThursday: (input?: InputDate) => boolean;
+declare const isFriday: (input?: InputDate) => boolean;
+declare const isSaturday: (input?: InputDate) => boolean;
+declare const isSunday: (input?: InputDate) => boolean;
+/**
+ * Determines if a given date falls on a weekend.
+ *
+ * This function checks whether the day of the week for the provided input corresponds
+ * to Saturday or Sunday, where weekday values of 6 and 7 represent Saturday and Sunday, respectively.
+ */
+declare const isWeekend: (input?: InputDate) => boolean;
+/**
+ * Calculates the difference in minutes between two provided dates.
+ */
+declare const differenceInMinutes: (start: InputDate, end: InputDate) => number;
+/**
+ * Calculates the difference in business days between two dates.
+ * Business days are considered as weekdays (Monday to Friday).
+ */
+declare const differenceInBusinessDays: (start: InputDate, end: InputDate) => number;
+/**
+ * Similar to date-fns' eachDayOfInterval, however the timezone messes this function up.
+ * https://date-fns.org/v2.28.0/docs/eachDayOfInterval
+ * https://www.gov.uk/when-do-the-clocks-change
+ */
+declare const getDatesBetween: (start: InputDate, end: InputDate) => (DateTime<true> | null)[];
+/**
+ * Get an array of DateTime objects representing the 1st of each month between start and end dates.
+ */
+declare const getMonthsBetween: (start: InputDate, end: InputDate) => DateTime<boolean>[];
+/**
+ * If a given date is beyond the maximum, return the maximum.
+ */
+declare const getMax: (input: DateTime, max: DateTime) => DateTime<boolean>;
+/**
+ * If a given date is before the minimum, return the minimum.
+ */
+declare const getMin: (input: DateTime, min: DateTime) => DateTime<boolean>;
+/**
+ * Retrieve the closest last Monday relative to the input or today.
+ * 0 weeksAgo - Tuesday (10th), return Monday (8th)
+ * 1 weeksAgo - Tuesday (10th), return Monday (1st)
+ */
+declare const getMonday: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Retrieve the closest last Sunday relative to the input or today.
+ * 0 weeksAgo - Tuesday (17th), return Sunday (14th)
+ * 1 weeksAgo - Tuesday (17th), return Monday (7th)
+ */
+declare const getSunday: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Return an object of start/end predefined date of Last Week.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getLastWeek: () => Timeframe;
+/**
+ * Return an object of start/end predefined date of This Week.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getThisWeek: () => Timeframe;
+/**
+ * Return an object of start/end predefined date of Two Weeks Ago.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getTwoWeeksAgo: () => Timeframe;
+/**
+ * Shortcut to get today's date.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getToday: (setMidnight?: boolean) => DateTime<boolean>;
+/**
+ * From a given input, move the date back X weeksAgo
+ */
+declare const getWeeksAgo: (input?: InputDate, weeksAgo?: number) => DateTime<boolean>;
+/**
+ * Shortcut to get yesterday's date.
+ * Creating a date from scratch (no user input), thus needs to be London time.
+ */
+declare const getYesterday: (input?: InputDate) => DateTime<boolean>;
+/**
+ * Check to see if a given timeframe is This Week.
+ */
+declare const isThisWeek: (start: InputDate, end: InputDate) => boolean;
+/**
+ * Check to see if a given timeframe is Last Week.
+ */
+declare const isLastWeek: (start: InputDate, end: InputDate) => boolean;
+//#endregion
+export { differenceInBusinessDays, differenceInMinutes, getDatesBetween, getLastWeek, getLuxonDate, getMax, getMin, getMonday, getMonthsBetween, getSunday, getThisWeek, getToday, getTwoWeeksAgo, getUnix, getWeeksAgo, getYesterday, isFriday, isLastWeek, isMonday, isSaturday, isSunday, isThisWeek, isThursday, isTuesday, isWednesday, isWeekend };