@aneuhold/core-ts-lib 1.1.9 → 1.1.11

package/lib/index.d.ts

@@ -1,11 +1,13 @@
 import datesAreOnSameDay from './helperFunctions/dateFunctions';
 import sleep from './helperFunctions/sleep';
+import ArrayService from './services/ArrayService';
+import DateService from './services/DateService/DateService';
 import DependencyService from './services/DependencyService';
 import FileSystemService from './services/FileSystemService/FileSystemService';
 import StringService from './services/StringService';
 import ErrorUtils from './utils/ErrorUtils';
 import Logger from './utils/Logger';
 import TestUtils from './utils/TestUtils';
-export { datesAreOnSameDay, DependencyService, FileSystemService, Logger, sleep, StringService, TestUtils, ErrorUtils };
+export { datesAreOnSameDay, DependencyService, FileSystemService, Logger, sleep, StringService, TestUtils, ErrorUtils, DateService, ArrayService };
 export type {};
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,MAAM,yBAAyB,CAAC;AAC5C,OAAO,iBAAiB,MAAM,8BAA8B,CAAC;AAC7D,OAAO,iBAAiB,MAAM,gDAAgD,CAAC;AAC/E,OAAO,aAAa,MAAM,0BAA0B,CAAC;AACrD,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,EACN,KAAK,EACL,aAAa,EACb,SAAS,EACT,UAAU,EACX,CAAC;AAGF,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,MAAM,yBAAyB,CAAC;AAC5C,OAAO,YAAY,MAAM,yBAAyB,CAAC;AACnD,OAAO,WAAW,MAAM,oCAAoC,CAAC;AAC7D,OAAO,iBAAiB,MAAM,8BAA8B,CAAC;AAC7D,OAAO,iBAAiB,MAAM,gDAAgD,CAAC;AAC/E,OAAO,aAAa,MAAM,0BAA0B,CAAC;AACrD,OAAO,UAAU,MAAM,oBAAoB,CAAC;AAC5C,OAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,EACN,KAAK,EACL,aAAa,EACb,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACb,CAAC;AAGF,YAAY,EAAE,CAAC"}

package/lib/index.js

@@ -3,11 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorUtils = exports.TestUtils = exports.StringService = exports.sleep = exports.Logger = exports.FileSystemService = exports.DependencyService = exports.datesAreOnSameDay = void 0;
+exports.ArrayService = exports.DateService = exports.ErrorUtils = exports.TestUtils = exports.StringService = exports.sleep = exports.Logger = exports.FileSystemService = exports.DependencyService = exports.datesAreOnSameDay = void 0;
 const dateFunctions_1 = __importDefault(require("./helperFunctions/dateFunctions"));
 exports.datesAreOnSameDay = dateFunctions_1.default;
 const sleep_1 = __importDefault(require("./helperFunctions/sleep"));
 exports.sleep = sleep_1.default;
+const ArrayService_1 = __importDefault(require("./services/ArrayService"));
+exports.ArrayService = ArrayService_1.default;
+const DateService_1 = __importDefault(require("./services/DateService/DateService"));
+exports.DateService = DateService_1.default;
 const DependencyService_1 = __importDefault(require("./services/DependencyService"));
 exports.DependencyService = DependencyService_1.default;
 const FileSystemService_1 = __importDefault(require("./services/FileSystemService/FileSystemService"));

package/lib/services/ArrayService.d.ts

@@ -0,0 +1,4 @@
+export default class ArrayService {
+    static arraysHaveSamePrimitiveValues(array1: Array<unknown>, array2: Array<unknown>): boolean;
+}
+//# sourceMappingURL=ArrayService.d.ts.map

package/lib/services/ArrayService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayService.d.ts","sourceRoot":"","sources":["../../src/services/ArrayService.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,MAAM,CAAC,6BAA6B,CAClC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,EACtB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GACrB,OAAO;CAaX"}

package/lib/services/ArrayService.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ArrayService {
+    static arraysHaveSamePrimitiveValues(array1, array2) {
+        if (array1.length !== array2.length) {
+            return false;
+        }
+        const array1Copy = [...array1];
+        const array2Copy = [...array2];
+        array1Copy.sort();
+        array2Copy.sort();
+        return array1Copy.every((value, index) => value === array2Copy[index]);
+    }
+}
+exports.default = ArrayService;

package/lib/services/DateService/DateService.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A class that supports converting dates across various personal projects.
+ *
+ * All of the things in this class should be able to be used in Node and the
+ * browser.
+ */
+export default class DateService {
+    private static dateFormatter;
+    private static dateTimeFormatter;
+    /**
+     * Gets the date in date format if it is set to midnight, otherwise gets the
+     * date in date time format.
+     */
+    static getAutoDateString(date: Date): string;
+    /**
+     * Determines if a date has a user-specified time component to it, meaning
+     * that it isn't midnight.
+     */
+    static dateHasTime(date: Date): boolean;
+    static getDateString(date: Date): string;
+    static getDateTimeString(date: Date): string;
+    /**
+     * Determines if two dates are equal. This is strict, down to the ms.
+     */
+    static datesAreEqual(date1: Date | undefined | null, date2: Date | undefined | null): boolean;
+    /**
+     * Gets the last day of the month for the provided date. This will retain the
+     * time that was provided in the date.
+     */
+    static getLastDayOfGivenMonth(date: Date): Date;
+    /**
+     * Gets the week of the month for the provided date. This starts at 1.
+     */
+    static getWeekOfMonth(date: Date): number;
+    static getLastWeekOfMonth(date: Date): number;
+    static getDaysUntilWeekDay(date: Date, day: number): number;
+    /**
+     * Gets the date of the provided weekday in the provided week of the month.
+     * Retains the time that was provided in the date.
+     *
+     * For example, the 2nd Monday of the month, or the last Saturday of the
+     * month.
+     */
+    static getWeekDayOfXWeekOfMonth(date: Date, day: number, week: number | 'last'): Date | null;
+    /**
+     * Adds the provided number of days to the provided date. If the days are
+     * over or under the number of days in the month, then the month will be
+     * adjusted accordingly.
+     */
+    static addDays(date: Date, days: number): Date;
+    static addMonths(date: Date, months: number): Date;
+    static addWeeks(date: Date, weeks: number): Date;
+    static addYears(date: Date, years: number): Date;
+    /**
+     * For personal projects, midnight can mean exactly midnight, or 11:59pm.
+     * It acts as a border between two dates.
+     */
+    static dateIsMidnight(date: Date): boolean;
+}
+//# sourceMappingURL=DateService.d.ts.map

package/lib/services/DateService/DateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateService.d.ts","sourceRoot":"","sources":["../../../src/services/DateService/DateService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,OAAO,CAAC,MAAM,CAAC,aAAa,CAIzB;IAEH,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAM7B;IAEH;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI;IAOnC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI;IAI7B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI;IAI/B,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI;IAInC;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,EAC9B,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAWhC;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAS/C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAmBzC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAK7C,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ3D;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAC7B,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,IAAI,GAAG,IAAI;IAiCd;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM;IAMvC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAM3C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM;IAIzC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM;IAMzC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI;CAMjC"}

package/lib/services/DateService/DateService.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A class that supports converting dates across various personal projects.
+ *
+ * All of the things in this class should be able to be used in Node and the
+ * browser.
+ */
+class DateService {
+    static dateFormatter = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric'
+    });
+    static dateTimeFormatter = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric'
+    });
+    /**
+     * Gets the date in date format if it is set to midnight, otherwise gets the
+     * date in date time format.
+     */
+    static getAutoDateString(date) {
+        if (this.dateHasTime(date)) {
+            return this.getDateTimeString(date);
+        }
+        return this.getDateString(date);
+    }
+    /**
+     * Determines if a date has a user-specified time component to it, meaning
+     * that it isn't midnight.
+     */
+    static dateHasTime(date) {
+        return !this.dateIsMidnight(date);
+    }
+    static getDateString(date) {
+        return this.dateFormatter.format(date);
+    }
+    static getDateTimeString(date) {
+        return this.dateTimeFormatter.format(date);
+    }
+    /**
+     * Determines if two dates are equal. This is strict, down to the ms.
+     */
+    static datesAreEqual(date1, date2) {
+        if (!date1 && !date2) {
+            return true;
+        }
+        if (!date1 || !date2) {
+            return false;
+        }
+        return date1.getTime() === date2.getTime();
+    }
+    /**
+     * Gets the last day of the month for the provided date. This will retain the
+     * time that was provided in the date.
+     */
+    static getLastDayOfGivenMonth(date) {
+        // Setting the day to 0, makes the date move to the last day of the
+        // previous month.
+        const newDate = new Date(date);
+        newDate.setMonth(newDate.getMonth() + 1);
+        newDate.setDate(0);
+        return newDate;
+    }
+    /**
+     * Gets the week of the month for the provided date. This starts at 1.
+     */
+    static getWeekOfMonth(date) {
+        const firstDayOfMonth = new Date(date.getFullYear(), date.getMonth(), 1);
+        const firstDayOfMonthWeekday = firstDayOfMonth.getDay();
+        const firstDayOfSecondWeek = new Date(firstDayOfMonth);
+        const daysUntilSecondWeek = 7 - firstDayOfMonthWeekday;
+        firstDayOfSecondWeek.setDate(firstDayOfSecondWeek.getDate() + daysUntilSecondWeek);
+        if (date < firstDayOfSecondWeek) {
+            return 1;
+        }
+        const daysSinceFirstDayOfSecondWeek = date.getDate() - firstDayOfSecondWeek.getDate();
+        const weeksSinceFirstDayOfSecondWeek = Math.floor(daysSinceFirstDayOfSecondWeek / 7);
+        return weeksSinceFirstDayOfSecondWeek + 2;
+    }
+    static getLastWeekOfMonth(date) {
+        const lastDayOfMonth = this.getLastDayOfGivenMonth(date);
+        return this.getWeekOfMonth(lastDayOfMonth);
+    }
+    static getDaysUntilWeekDay(date, day) {
+        const daysUntilWeekDay = day - date.getDay();
+        if (daysUntilWeekDay < 0) {
+            return daysUntilWeekDay + 7;
+        }
+        return daysUntilWeekDay;
+    }
+    /**
+     * Gets the date of the provided weekday in the provided week of the month.
+     * Retains the time that was provided in the date.
+     *
+     * For example, the 2nd Monday of the month, or the last Saturday of the
+     * month.
+     */
+    static getWeekDayOfXWeekOfMonth(date, day, week) {
+        if ((typeof week === 'number' && (week < 1 || week > 5)) ||
+            day < 0 ||
+            day > 6) {
+            return null;
+        }
+        if (week === 'last') {
+            let resultDate = this.getLastDayOfGivenMonth(date);
+            while (resultDate.getDay() !== day) {
+                resultDate = this.addDays(resultDate, -1);
+            }
+            return resultDate;
+        }
+        const firstDayOfMonth = new Date(date);
+        firstDayOfMonth.setDate(1);
+        let resultDate = new Date(firstDayOfMonth);
+        resultDate.setDate(resultDate.getDate() + this.getDaysUntilWeekDay(firstDayOfMonth, day));
+        // The number of times the day has shown up so far.
+        let instanceOfDay = 1;
+        while (instanceOfDay < week) {
+            resultDate = this.addWeeks(resultDate, 1);
+            instanceOfDay += 1;
+            if (resultDate.getMonth() !== date.getMonth()) {
+                return null;
+            }
+        }
+        return resultDate;
+    }
+    /**
+     * Adds the provided number of days to the provided date. If the days are
+     * over or under the number of days in the month, then the month will be
+     * adjusted accordingly.
+     */
+    static addDays(date, days) {
+        const newDate = new Date(date);
+        newDate.setDate(newDate.getDate() + days);
+        return newDate;
+    }
+    static addMonths(date, months) {
+        const newDate = new Date(date);
+        newDate.setMonth(newDate.getMonth() + months);
+        return newDate;
+    }
+    static addWeeks(date, weeks) {
+        return this.addDays(date, weeks * 7);
+    }
+    static addYears(date, years) {
+        const newDate = new Date(date);
+        newDate.setFullYear(newDate.getFullYear() + years);
+        return newDate;
+    }
+    /**
+     * For personal projects, midnight can mean exactly midnight, or 11:59pm.
+     * It acts as a border between two dates.
+     */
+    static dateIsMidnight(date) {
+        return ((date.getHours() === 0 && date.getMinutes() === 0) ||
+            (date.getHours() === 23 && date.getMinutes() === 59));
+    }
+}
+exports.default = DateService;

package/lib/services/DateService/DateService.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DateService.spec.d.ts.map

package/lib/services/DateService/DateService.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateService.spec.d.ts","sourceRoot":"","sources":["../../../src/services/DateService/DateService.spec.ts"],"names":[],"mappings":""}

package/lib/services/DateService/DateService.spec.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const DateService_1 = __importDefault(require("./DateService"));
+describe('DateService', () => {
+    describe('addWeeks', () => {
+        it('should successfully add weeks to a date', () => {
+            const result = DateService_1.default.addWeeks(new Date(2024, 0, 1), 1);
+            expect(result).toEqual(new Date(2024, 0, 8));
+        });
+        it('should successfully add weeks to a date that crosses months', () => {
+            const result = DateService_1.default.addWeeks(new Date(2024, 0, 23), 2);
+            expect(result).toEqual(new Date(2024, 1, 6));
+        });
+        it('should successfully add weeks to a date that crosses years', () => {
+            const result = DateService_1.default.addWeeks(new Date(2024, 11, 25), 1);
+            expect(result).toEqual(new Date(2025, 0, 1));
+        });
+    });
+    describe('getWeekOfMonth', () => {
+        it('should successfully get the week of month for a date', async () => {
+            const result = DateService_1.default.getWeekOfMonth(new Date(2024, 0, 14));
+            expect(result).toEqual(3);
+            const result2 = DateService_1.default.getWeekOfMonth(new Date(2024, 0, 1));
+            expect(result2).toEqual(1);
+            const result3 = DateService_1.default.getWeekOfMonth(new Date(2024, 0, 31));
+            expect(result3).toEqual(5);
+        });
+    });
+    describe('getWeekDayOfXWeekOfMonth', () => {
+        it('should successfully get the 2nd monday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 1, 2);
+            expect(result).toEqual(new Date(2024, 0, 8));
+        });
+        it('should successfully get the 3rd monday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 1, 3);
+            expect(result).toEqual(new Date(2024, 0, 15));
+        });
+        it('should successfully get the 3rd tuesday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 2, 3);
+            expect(result).toEqual(new Date(2024, 0, 16));
+        });
+        it('should successfully get the 1st Saturday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 6, 1);
+            expect(result).toEqual(new Date(2024, 0, 6));
+        });
+        it('should successfully get the 1st sunday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 0, 1);
+            expect(result).toEqual(new Date(2024, 0, 7));
+        });
+        it('should successfully get the last sunday of January 2024', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 0, 'last');
+            expect(result).toEqual(new Date(2024, 0, 28));
+        });
+        it('should return null if the week and day do not exist', () => {
+            const result = DateService_1.default.getWeekDayOfXWeekOfMonth(new Date(2024, 0, 1), 0, 5);
+            expect(result).toEqual(null);
+        });
+    });
+});

package/lib/services/DateService.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A class that supports converting dates across various personal projects.
+ *
+ * All of the things in this class should be able to be used in Node and the
+ * browser.
+ */
+export default class DateService {
+    private static dateFormatter;
+    private static dateTimeFormatter;
+    /**
+     * Gets the date in date format if it is set to midnight, otherwise gets the
+     * date in date time format.
+     */
+    static getAutoDateString(date: Date): string;
+    /**
+     * Determines if a date has a user-specified time component to it, meaning
+     * that it isn't midnight.
+     */
+    static dateHasTime(date: Date): boolean;
+    static getDateString(date: Date): string;
+    static getDateTimeString(date: Date): string;
+    /**
+     * Determines if two dates are equal. This is strict, down to the ms.
+     */
+    static datesAreEqual(date1: Date | undefined | null, date2: Date | undefined | null): boolean;
+    /**
+     * Gets the last day of the month for the provided date. This will return
+     * the date at exactly 00:00 on the last day of the month.
+     */
+    static getLastDayOfGivenMonth(date: Date): Date;
+    /**
+     * Gets the week of the month for the provided date. This starts at 1.
+     */
+    static getWeekOfMonth(date: Date): number;
+    /**
+     * Adds the provided number of days to the provided date. If the days are
+     * over or under the number of days in the month, then the month will be
+     * adjusted accordingly.
+     */
+    static addDays(date: Date, days: number): Date;
+    static addMonths(date: Date, months: number): Date;
+    static addWeeks(date: Date, weeks: number): Date;
+    static addYears(date: Date, years: number): Date;
+    /**
+     * For personal projects, midnight can mean exactly midnight, or 11:59pm.
+     * It acts as a border between two dates.
+     */
+    static dateIsMidnight(date: Date): boolean;
+}
+//# sourceMappingURL=DateService.d.ts.map

package/lib/services/DateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateService.d.ts","sourceRoot":"","sources":["../../src/services/DateService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,OAAO,CAAC,MAAM,CAAC,aAAa,CAIzB;IAEH,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAM7B;IAEH;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI;IAOnC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI;IAI7B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI;IAI/B,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI;IAInC;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,EAC9B,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;IAWhC;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM/C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAazC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM;IAMvC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM;IAM3C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM;IAIzC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM;IAMzC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI;CAMjC"}

package/lib/services/DateService.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A class that supports converting dates across various personal projects.
+ *
+ * All of the things in this class should be able to be used in Node and the
+ * browser.
+ */
+class DateService {
+    static dateFormatter = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric'
+    });
+    static dateTimeFormatter = new Intl.DateTimeFormat('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: 'numeric'
+    });
+    /**
+     * Gets the date in date format if it is set to midnight, otherwise gets the
+     * date in date time format.
+     */
+    static getAutoDateString(date) {
+        if (this.dateHasTime(date)) {
+            return this.getDateTimeString(date);
+        }
+        return this.getDateString(date);
+    }
+    /**
+     * Determines if a date has a user-specified time component to it, meaning
+     * that it isn't midnight.
+     */
+    static dateHasTime(date) {
+        return !this.dateIsMidnight(date);
+    }
+    static getDateString(date) {
+        return this.dateFormatter.format(date);
+    }
+    static getDateTimeString(date) {
+        return this.dateTimeFormatter.format(date);
+    }
+    /**
+     * Determines if two dates are equal. This is strict, down to the ms.
+     */
+    static datesAreEqual(date1, date2) {
+        if (!date1 && !date2) {
+            return true;
+        }
+        if (!date1 || !date2) {
+            return false;
+        }
+        return date1.getTime() === date2.getTime();
+    }
+    /**
+     * Gets the last day of the month for the provided date. This will return
+     * the date at exactly 00:00 on the last day of the month.
+     */
+    static getLastDayOfGivenMonth(date) {
+        // Setting the day to 0, makes the date move to the last day of the
+        // previous month.
+        return new Date(date.getFullYear(), date.getMonth() + 1, 0);
+    }
+    /**
+     * Gets the week of the month for the provided date. This starts at 1.
+     */
+    static getWeekOfMonth(date) {
+        const firstDayOfMonth = new Date(date.getFullYear(), date.getMonth(), 1);
+        const firstDayOfMonthWeekday = firstDayOfMonth.getDay();
+        const firstDayOfFirstWeek = new Date(firstDayOfMonth);
+        firstDayOfFirstWeek.setDate(firstDayOfFirstWeek.getDate() - firstDayOfMonthWeekday);
+        const daysSinceFirstDayOfFirstWeek = date.getDate() - firstDayOfFirstWeek.getDate();
+        const daysSinceFirstDayOfMonth = daysSinceFirstDayOfFirstWeek + 1;
+        return Math.ceil(daysSinceFirstDayOfMonth / 7);
+    }
+    /**
+     * Adds the provided number of days to the provided date. If the days are
+     * over or under the number of days in the month, then the month will be
+     * adjusted accordingly.
+     */
+    static addDays(date, days) {
+        const newDate = new Date(date);
+        newDate.setDate(newDate.getDate() + days);
+        return newDate;
+    }
+    static addMonths(date, months) {
+        const newDate = new Date(date);
+        newDate.setMonth(newDate.getMonth() + months);
+        return newDate;
+    }
+    static addWeeks(date, weeks) {
+        return this.addDays(date, weeks * 7);
+    }
+    static addYears(date, years) {
+        const newDate = new Date(date);
+        newDate.setFullYear(newDate.getFullYear() + years);
+        return newDate;
+    }
+    /**
+     * For personal projects, midnight can mean exactly midnight, or 11:59pm.
+     * It acts as a border between two dates.
+     */
+    static dateIsMidnight(date) {
+        return ((date.getHours() === 0 && date.getMinutes() === 0) ||
+            (date.getHours() === 23 && date.getMinutes() === 59));
+    }
+}
+exports.default = DateService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aneuhold/core-ts-lib",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "A core library for all of my TypeScript projects",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",