@8ms/helpers 3.0.26 → 3.1.0

package/dist/date/calculation.d.mts

@@ -1,105 +1,110 @@
-import { InputDate, Timeframe } from "./date.mjs";
+import { DateRangeLuxon, InputDate } from "./date.mjs";
 import { DateTime } from "luxon";
 //#region src/date/calculation.d.ts
 /**
  * Return unix timestamp in seconds.
  */
-declare const getUnix: (input?: InputDate) => number;
+export 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;
+export declare const getLuxonDate: (input?: InputDate, setMidnight?: boolean) => DateTime<boolean>;
+export declare const isMonday: (input?: InputDate) => boolean;
+export declare const isTuesday: (input?: InputDate) => boolean;
+export declare const isWednesday: (input?: InputDate) => boolean;
+export declare const isThursday: (input?: InputDate) => boolean;
+export declare const isFriday: (input?: InputDate) => boolean;
+export declare const isSaturday: (input?: InputDate) => boolean;
+export 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;
+export declare const isWeekend: (input?: InputDate) => boolean;
+/**
+ * Determines whether a given unix timestamp is older than the provided threshold, in seconds.
+ *
+ * Example: 50 minutes, would be 50 * 60.
+ */
+export declare const isStale: (timeout: number, threshold: number) => boolean;
 /**
  * Calculates the difference in minutes between two provided dates.
  */
-declare const differenceInMinutes: (start: InputDate, end: InputDate) => number;
+export 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;
+export 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)[];
+export 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>[];
+export 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>;
+export 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>;
+export 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>;
+export 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>;
+export 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;
+export declare const getLastWeek: () => DateRangeLuxon;
 /**
  * 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;
+export declare const getThisWeek: () => DateRangeLuxon;
 /**
  * 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;
+export declare const getTwoWeeksAgo: () => DateRangeLuxon;
 /**
  * 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>;
+export 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>;
+export 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>;
+export 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;
+export 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 };
+export declare const isLastWeek: (start: InputDate, end: InputDate) => boolean;
+//#endregion

package/dist/date/calculation.mjs

@@ -31,7 +31,8 @@ const getLuxonDate = (input, setMidnight) => {
 			else instance = DateTime.fromMillis(input, { zone: "utc" });
 		} else {
 			const inputString = input.toString().toLowerCase();
-			instance = DateTime.fromISO(inputString, { zone: "utc" });
+			if (/^\d+$/.test(inputString)) instance = getLuxonDate(Number(inputString));
+			else instance = DateTime.fromISO(inputString, { zone: "utc" });
 			if (!instance.isValid) {
 				const len = inputString.length;
 				if (23 === len) instance = DateTime.fromFormat(inputString, "yyyy-MM-dd HH:mm:ss.SSS", { zone: "utc" });
@@ -84,6 +85,14 @@ const isWeekend = (input) => {
 	return 6 === luxonDate.weekday || 7 === luxonDate.weekday;
 };
 /**
+* Determines whether a given unix timestamp is older than the provided threshold, in seconds.
+*
+* Example: 50 minutes, would be 50 * 60.
+*/
+const isStale = (timeout, threshold) => {
+	return getUnix() - timeout > threshold;
+};
+/**
 * Calculates the difference in minutes between two provided dates.
 */
 const differenceInMinutes = (start, end) => {
@@ -245,4 +254,4 @@ const isLastWeek = (start, end) => {
 	return inputWeek.start.hasSame(lastWeek.start, "day") && inputWeek.end.hasSame(lastWeek.end, "day");
 };
 //#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 };
+export { differenceInBusinessDays, differenceInMinutes, getDatesBetween, getLastWeek, getLuxonDate, getMax, getMin, getMonday, getMonthsBetween, getSunday, getThisWeek, getToday, getTwoWeeksAgo, getUnix, getWeeksAgo, getYesterday, isFriday, isLastWeek, isMonday, isSaturday, isStale, isSunday, isThisWeek, isThursday, isTuesday, isWednesday, isWeekend };

package/dist/date/date.d.cts

@@ -1,7 +1,7 @@
 import { DateTime } from "luxon";
 //#region src/date/date.d.ts
-type InputDate = Date | DateTime | string | number;
-type FinancialWeek = {
+export type InputDate = Date | DateTime | string | number;
+export type FinancialWeek = {
   end: DateTime;
   start: DateTime;
   weekNumber: number;
@@ -10,17 +10,29 @@ type FinancialWeek = {
 /**
  * A timeframe has a start and an end date.
  */
-type Timeframe = {
-  end: DateTime;
+export type DateRangeNumber = {
+  start: number;
+  end: number;
+};
+export type DateRangeLuxon = {
   start: DateTime;
+  end: DateTime;
+};
+export type DateRangeString = {
+  start: string;
+  end: string;
+};
+export type DateRangeInput = {
+  start: InputDate;
+  end: InputDate;
 };
-declare const defaultDate: "1901-01-01";
-declare const defaultDateNumber: 19010101;
-declare const defaultDateTime: "1901-01-01 00:00:00";
+export declare const defaultDate: "1901-01-01";
+export declare const defaultDateNumber: 19010101;
+export declare const defaultDateTime: "1901-01-01 00:00:00";
 /**
  * Used by Google Ads API.
  */
-declare const month: {
+export declare const month: {
   readonly JANUARY: "JANUARY";
   readonly FEBRUARY: "FEBRUARY";
   readonly MARCH: "MARCH";
@@ -34,6 +46,5 @@ declare const month: {
   readonly NOVEMBER: "NOVEMBER";
   readonly DECEMBER: "DECEMBER";
 };
-type Month = typeof month[keyof typeof month];
-//#endregion
-export { FinancialWeek, InputDate, Month, Timeframe, defaultDate, defaultDateNumber, defaultDateTime, month };
+export type Month = typeof month[keyof typeof month];
+//#endregion

package/dist/date/date.d.mts

@@ -1,7 +1,7 @@
 import { DateTime } from "luxon";
 //#region src/date/date.d.ts
-type InputDate = Date | DateTime | string | number;
-type FinancialWeek = {
+export type InputDate = Date | DateTime | string | number;
+export type FinancialWeek = {
   end: DateTime;
   start: DateTime;
   weekNumber: number;
@@ -10,17 +10,29 @@ type FinancialWeek = {
 /**
  * A timeframe has a start and an end date.
  */
-type Timeframe = {
-  end: DateTime;
+export type DateRangeNumber = {
+  start: number;
+  end: number;
+};
+export type DateRangeLuxon = {
   start: DateTime;
+  end: DateTime;
+};
+export type DateRangeString = {
+  start: string;
+  end: string;
+};
+export type DateRangeInput = {
+  start: InputDate;
+  end: InputDate;
 };
-declare const defaultDate: "1901-01-01";
-declare const defaultDateNumber: 19010101;
-declare const defaultDateTime: "1901-01-01 00:00:00";
+export declare const defaultDate: "1901-01-01";
+export declare const defaultDateNumber: 19010101;
+export declare const defaultDateTime: "1901-01-01 00:00:00";
 /**
  * Used by Google Ads API.
  */
-declare const month: {
+export declare const month: {
   readonly JANUARY: "JANUARY";
   readonly FEBRUARY: "FEBRUARY";
   readonly MARCH: "MARCH";
@@ -34,6 +46,5 @@ declare const month: {
   readonly NOVEMBER: "NOVEMBER";
   readonly DECEMBER: "DECEMBER";
 };
-type Month = typeof month[keyof typeof month];
-//#endregion
-export { FinancialWeek, InputDate, Month, Timeframe, defaultDate, defaultDateNumber, defaultDateTime, month };
+export type Month = typeof month[keyof typeof month];
+//#endregion

package/dist/date/financialYear.cjs

@@ -6,7 +6,7 @@ let luxon = require("luxon");
 * Get the financial year based on an optional year.
 */
 const getFinancialYear = (year) => {
-	let financialYear = year;
+	let financialYear = year ?? 0;
 	if ("undefined" === typeof year) {
 		const todayInstance = require_date_calculation.getToday();
 		if (todayInstance < require_date_calculation.getLuxonDate(`${todayInstance.toFormat("yyyy")}-04-01`)) financialYear = Number(todayInstance.toFormat("yyyy")) - 1;

package/dist/date/financialYear.d.cts

@@ -1,22 +1,21 @@
-import { Timeframe } from "./date.cjs";
+import { DateRangeLuxon } from "./date.cjs";
 import { Interval } from "luxon";
 //#region src/date/financialYear.d.ts
 /**
  * Get the financial year based on an optional year.
  */
-declare const getFinancialYear: (year?: number) => Timeframe;
+export declare const getFinancialYear: (year?: number) => DateRangeLuxon;
 /**
  * Return the current financial year up to today.
  */
-declare const getFinancialYearToDate: () => Timeframe;
+export declare const getFinancialYearToDate: () => DateRangeLuxon;
 /**
  * Return the current financial year up to yesterday.
  * Timezone should always be London based
  */
-declare const getFinancialYearToYesterday: () => Timeframe;
+export declare const getFinancialYearToYesterday: () => DateRangeLuxon;
 /**
  * Get the current financial year.
  */
-declare const getFinancialYearWeeks: (year?: number) => Interval<boolean>[];
-//#endregion
-export { getFinancialYear, getFinancialYearToDate, getFinancialYearToYesterday, getFinancialYearWeeks };
+export declare const getFinancialYearWeeks: (year?: number) => Interval<boolean>[];
+//#endregion

package/dist/date/financialYear.d.mts

@@ -1,22 +1,21 @@
-import { Timeframe } from "./date.mjs";
+import { DateRangeLuxon } from "./date.mjs";
 import { Interval } from "luxon";
 //#region src/date/financialYear.d.ts
 /**
  * Get the financial year based on an optional year.
  */
-declare const getFinancialYear: (year?: number) => Timeframe;
+export declare const getFinancialYear: (year?: number) => DateRangeLuxon;
 /**
  * Return the current financial year up to today.
  */
-declare const getFinancialYearToDate: () => Timeframe;
+export declare const getFinancialYearToDate: () => DateRangeLuxon;
 /**
  * Return the current financial year up to yesterday.
  * Timezone should always be London based
  */
-declare const getFinancialYearToYesterday: () => Timeframe;
+export declare const getFinancialYearToYesterday: () => DateRangeLuxon;
 /**
  * Get the current financial year.
  */
-declare const getFinancialYearWeeks: (year?: number) => Interval<boolean>[];
-//#endregion
-export { getFinancialYear, getFinancialYearToDate, getFinancialYearToYesterday, getFinancialYearWeeks };
+export declare const getFinancialYearWeeks: (year?: number) => Interval<boolean>[];
+//#endregion

package/dist/date/financialYear.mjs

@@ -5,7 +5,7 @@ import { Interval } from "luxon";
 * Get the financial year based on an optional year.
 */
 const getFinancialYear = (year) => {
-	let financialYear = year;
+	let financialYear = year ?? 0;
 	if ("undefined" === typeof year) {
 		const todayInstance = getToday();
 		if (todayInstance < getLuxonDate(`${todayInstance.toFormat("yyyy")}-04-01`)) financialYear = Number(todayInstance.toFormat("yyyy")) - 1;

package/dist/date/format.cjs

@@ -159,6 +159,15 @@ const getLuxonDateFromExcel = (serial) => {
 	const minutes = Math.floor(totalSeconds / 60) % 60;
 	return luxon.DateTime.fromISO(`${dateInfo.getFullYear()}-${dateInfo.getMonth()}-${dateInfo.getDate()}T${hours}:${minutes}:${seconds}Z`);
 };
+/**
+* Returns an array of Mondays, going back a given number of weeks from the input date (or today).
+*/
+const getMondayArray = (weeks, asc = true, input) => {
+	const baseLine = input ? require_date_calculation.getLuxonDate(input) : require_date_calculation.getToday();
+	const response = [];
+	for (let i = 0; i < weeks; i++) response.push(require_date_calculation.getMonday(baseLine, i));
+	return response.sort((a, b) => asc ? a.toMillis() - b.toMillis() : b.toMillis() - a.toMillis());
+};
 //#endregion
 exports.format = format;
 exports.getDayNumber = getDayNumber;
@@ -167,6 +176,7 @@ exports.getDurationMinutes = getDurationMinutes;
 exports.getFullDate = getFullDate;
 exports.getFullDateTime = getFullDateTime;
 exports.getLuxonDateFromExcel = getLuxonDateFromExcel;
+exports.getMondayArray = getMondayArray;
 exports.getMonthYearString = getMonthYearString;
 exports.getTodayYmdHisNumber = getTodayYmdHisNumber;
 exports.getTodayYmdHisString = getTodayYmdHisString;

package/dist/date/format.d.cts

@@ -5,84 +5,87 @@ import { DateTime } from "luxon";
  * Convert a number of seconds into HH:MM:SS
  * https://www.codevertiser.com/convert-seconds-to-hours-and-minutes-javascript/
  */
-declare const getDurationHours: (seconds: number) => string;
+export declare const getDurationHours: (seconds: number) => string;
 /**
  * Convert a number of seconds into MM:SS
  * https://www.codevertiser.com/convert-seconds-to-hours-and-minutes-javascript/
  */
-declare const getDurationMinutes: (seconds: number) => string;
+export declare const getDurationMinutes: (seconds: number) => string;
 /**
  * Simple function takes any DateTime, String or Number and formats it.
  */
-declare const format: (input?: InputDate, dateFormat?: string) => string;
+export declare const format: (input?: InputDate, dateFormat?: string) => string;
 /**
  * Convert a Date into a dd number.
  */
-declare const getDayNumber: (input?: InputDate) => number;
+export declare const getDayNumber: (input?: InputDate) => number;
 /**
  * Whenever we are displaying a month and year date in Codex, this will be the standardised format.
  * Example: 1901-02-03 → 3 Feb 1901
  */
-declare const getFullDate: (input?: InputDate) => string;
+export declare const getFullDate: (input?: InputDate) => string;
 /**
  * Whenever we are displaying a month and year date in Codex, this will be the standardised format.
  * Example: 1901-02-03 01:23:45 → 1:23am 3 Feb 1901
  */
-declare const getFullDateTime: (input?: InputDate) => string;
+export declare const getFullDateTime: (input?: InputDate) => string;
 /**
  * Returns a MMM YYYY value as a number for a given year.
  * Example: 1901-02-03 → Feb 1901
  */
-declare const getMonthYearString: (input?: InputDate) => string;
+export declare const getMonthYearString: (input?: InputDate) => string;
 /**
  * Returns a YYYY MMM value as a number for a given year.
  * Example: 1901-02-03 → 1901 Feb
  */
-declare const getYearMonthString: (input?: InputDate) => string;
+export declare const getYearMonthString: (input?: InputDate) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdString: (setMidnight?: boolean) => string;
+export declare const getTodayYmdString: (setMidnight?: boolean) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdHisString: (setMidnight?: boolean) => string;
+export declare const getTodayYmdHisString: (setMidnight?: boolean) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdNumber: (setMidnight?: boolean) => number;
+export declare const getTodayYmdNumber: (setMidnight?: boolean) => number;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdHisNumber: (setMidnight?: boolean) => number;
+export declare const getTodayYmdHisNumber: (setMidnight?: boolean) => number;
 /**
  * Convert a Date into a YYYY number.
  */
-declare const getYearNumber: (input?: InputDate) => number;
+export declare const getYearNumber: (input?: InputDate) => number;
 /**
  * Returns a YYYYMMDDHHIISS value as a number.
  * Example: 1901-02-03 01:23:45 → 19010203012345
  */
-declare const getYmdHisNumber: (input?: InputDate) => number;
+export declare const getYmdHisNumber: (input?: InputDate) => number;
 /**
  * Returns a YYYY-MM-DD HH:MM:SS value as a string.
  * Example: 1901-02-03 → 1901-02-03 00:00:00
  */
-declare const getYmdHisString: (input?: InputDate) => string;
+export declare const getYmdHisString: (input?: InputDate) => string;
 /**
  * Returns a YYYYMMDD value as a number.
  * Example: 1901-02-03 → 19010203
  */
-declare const getYmdNumber: (input?: InputDate) => number;
+export declare const getYmdNumber: (input?: InputDate) => number;
 /**
  * Whenever we are displaying a YYYY-MM-DD date in Codex
  * Example: 1901-02-03 → 1901-02-03
  */
-declare const getYmdString: (input?: InputDate) => string;
+export declare const getYmdString: (input?: InputDate) => string;
 /**
  * Convert an Excel date "e.g. 44216" into a JavaScript date object.
  * https://stackoverflow.com/questions/16229494/converting-excel-date-serial-number-to-date-using-javascript
  */
-declare const getLuxonDateFromExcel: (serial: number) => DateTime<true> | DateTime<false>;
-//#endregion
-export { format, getDayNumber, getDurationHours, getDurationMinutes, getFullDate, getFullDateTime, getLuxonDateFromExcel, getMonthYearString, getTodayYmdHisNumber, getTodayYmdHisString, getTodayYmdNumber, getTodayYmdString, getYearMonthString, getYearNumber, getYmdHisNumber, getYmdHisString, getYmdNumber, getYmdString };
+export declare const getLuxonDateFromExcel: (serial: number) => DateTime<true> | DateTime<false>;
+/**
+ * Returns an array of Mondays, going back a given number of weeks from the input date (or today).
+ */
+export declare const getMondayArray: (weeks: number, asc?: boolean, input?: InputDate) => DateTime[];
+//#endregion

package/dist/date/format.d.mts

@@ -5,84 +5,87 @@ import { DateTime } from "luxon";
  * Convert a number of seconds into HH:MM:SS
  * https://www.codevertiser.com/convert-seconds-to-hours-and-minutes-javascript/
  */
-declare const getDurationHours: (seconds: number) => string;
+export declare const getDurationHours: (seconds: number) => string;
 /**
  * Convert a number of seconds into MM:SS
  * https://www.codevertiser.com/convert-seconds-to-hours-and-minutes-javascript/
  */
-declare const getDurationMinutes: (seconds: number) => string;
+export declare const getDurationMinutes: (seconds: number) => string;
 /**
  * Simple function takes any DateTime, String or Number and formats it.
  */
-declare const format: (input?: InputDate, dateFormat?: string) => string;
+export declare const format: (input?: InputDate, dateFormat?: string) => string;
 /**
  * Convert a Date into a dd number.
  */
-declare const getDayNumber: (input?: InputDate) => number;
+export declare const getDayNumber: (input?: InputDate) => number;
 /**
  * Whenever we are displaying a month and year date in Codex, this will be the standardised format.
  * Example: 1901-02-03 → 3 Feb 1901
  */
-declare const getFullDate: (input?: InputDate) => string;
+export declare const getFullDate: (input?: InputDate) => string;
 /**
  * Whenever we are displaying a month and year date in Codex, this will be the standardised format.
  * Example: 1901-02-03 01:23:45 → 1:23am 3 Feb 1901
  */
-declare const getFullDateTime: (input?: InputDate) => string;
+export declare const getFullDateTime: (input?: InputDate) => string;
 /**
  * Returns a MMM YYYY value as a number for a given year.
  * Example: 1901-02-03 → Feb 1901
  */
-declare const getMonthYearString: (input?: InputDate) => string;
+export declare const getMonthYearString: (input?: InputDate) => string;
 /**
  * Returns a YYYY MMM value as a number for a given year.
  * Example: 1901-02-03 → 1901 Feb
  */
-declare const getYearMonthString: (input?: InputDate) => string;
+export declare const getYearMonthString: (input?: InputDate) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdString: (setMidnight?: boolean) => string;
+export declare const getTodayYmdString: (setMidnight?: boolean) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdHisString: (setMidnight?: boolean) => string;
+export declare const getTodayYmdHisString: (setMidnight?: boolean) => string;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdNumber: (setMidnight?: boolean) => number;
+export declare const getTodayYmdNumber: (setMidnight?: boolean) => number;
 /**
  * Shorthand to get the current date.
  */
-declare const getTodayYmdHisNumber: (setMidnight?: boolean) => number;
+export declare const getTodayYmdHisNumber: (setMidnight?: boolean) => number;
 /**
  * Convert a Date into a YYYY number.
  */
-declare const getYearNumber: (input?: InputDate) => number;
+export declare const getYearNumber: (input?: InputDate) => number;
 /**
  * Returns a YYYYMMDDHHIISS value as a number.
  * Example: 1901-02-03 01:23:45 → 19010203012345
  */
-declare const getYmdHisNumber: (input?: InputDate) => number;
+export declare const getYmdHisNumber: (input?: InputDate) => number;
 /**
  * Returns a YYYY-MM-DD HH:MM:SS value as a string.
  * Example: 1901-02-03 → 1901-02-03 00:00:00
  */
-declare const getYmdHisString: (input?: InputDate) => string;
+export declare const getYmdHisString: (input?: InputDate) => string;
 /**
  * Returns a YYYYMMDD value as a number.
  * Example: 1901-02-03 → 19010203
  */
-declare const getYmdNumber: (input?: InputDate) => number;
+export declare const getYmdNumber: (input?: InputDate) => number;
 /**
  * Whenever we are displaying a YYYY-MM-DD date in Codex
  * Example: 1901-02-03 → 1901-02-03
  */
-declare const getYmdString: (input?: InputDate) => string;
+export declare const getYmdString: (input?: InputDate) => string;
 /**
  * Convert an Excel date "e.g. 44216" into a JavaScript date object.
  * https://stackoverflow.com/questions/16229494/converting-excel-date-serial-number-to-date-using-javascript
  */
-declare const getLuxonDateFromExcel: (serial: number) => DateTime<true> | DateTime<false>;
-//#endregion
-export { format, getDayNumber, getDurationHours, getDurationMinutes, getFullDate, getFullDateTime, getLuxonDateFromExcel, getMonthYearString, getTodayYmdHisNumber, getTodayYmdHisString, getTodayYmdNumber, getTodayYmdString, getYearMonthString, getYearNumber, getYmdHisNumber, getYmdHisString, getYmdNumber, getYmdString };
+export declare const getLuxonDateFromExcel: (serial: number) => DateTime<true> | DateTime<false>;
+/**
+ * Returns an array of Mondays, going back a given number of weeks from the input date (or today).
+ */
+export declare const getMondayArray: (weeks: number, asc?: boolean, input?: InputDate) => DateTime[];
+//#endregion

package/dist/date/format.mjs

@@ -1,4 +1,4 @@
-import { getLuxonDate, getToday } from "./calculation.mjs";
+import { getLuxonDate, getMonday, getToday } from "./calculation.mjs";
 import { DateTime } from "luxon";
 //#region src/date/format.ts
 /**
@@ -158,5 +158,14 @@ const getLuxonDateFromExcel = (serial) => {
 	const minutes = Math.floor(totalSeconds / 60) % 60;
 	return DateTime.fromISO(`${dateInfo.getFullYear()}-${dateInfo.getMonth()}-${dateInfo.getDate()}T${hours}:${minutes}:${seconds}Z`);
 };
+/**
+* Returns an array of Mondays, going back a given number of weeks from the input date (or today).
+*/
+const getMondayArray = (weeks, asc = true, input) => {
+	const baseLine = input ? getLuxonDate(input) : getToday();
+	const response = [];
+	for (let i = 0; i < weeks; i++) response.push(getMonday(baseLine, i));
+	return response.sort((a, b) => asc ? a.toMillis() - b.toMillis() : b.toMillis() - a.toMillis());
+};
 //#endregion
-export { format, getDayNumber, getDurationHours, getDurationMinutes, getFullDate, getFullDateTime, getLuxonDateFromExcel, getMonthYearString, getTodayYmdHisNumber, getTodayYmdHisString, getTodayYmdNumber, getTodayYmdString, getYearMonthString, getYearNumber, getYmdHisNumber, getYmdHisString, getYmdNumber, getYmdString };
+export { format, getDayNumber, getDurationHours, getDurationMinutes, getFullDate, getFullDateTime, getLuxonDateFromExcel, getMondayArray, getMonthYearString, getTodayYmdHisNumber, getTodayYmdHisString, getTodayYmdNumber, getTodayYmdString, getYearMonthString, getYearNumber, getYmdHisNumber, getYmdHisString, getYmdNumber, getYmdString };

package/dist/date/index.cjs

@@ -25,6 +25,7 @@ exports.getLuxonDateFromExcel = require_date_format.getLuxonDateFromExcel;
 exports.getMax = require_date_calculation.getMax;
 exports.getMin = require_date_calculation.getMin;
 exports.getMonday = require_date_calculation.getMonday;
+exports.getMondayArray = require_date_format.getMondayArray;
 exports.getMonthYearString = require_date_format.getMonthYearString;
 exports.getMonthsBetween = require_date_calculation.getMonthsBetween;
 exports.getSunday = require_date_calculation.getSunday;
@@ -48,6 +49,7 @@ exports.isFriday = require_date_calculation.isFriday;
 exports.isLastWeek = require_date_calculation.isLastWeek;
 exports.isMonday = require_date_calculation.isMonday;
 exports.isSaturday = require_date_calculation.isSaturday;
+exports.isStale = require_date_calculation.isStale;
 exports.isSunday = require_date_calculation.isSunday;
 exports.isThisWeek = require_date_calculation.isThisWeek;
 exports.isThursday = require_date_calculation.isThursday;