@dereekb/date 0.0.1

package/README.md

@@ -0,0 +1,7 @@
+# date
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test date` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@dereekb/date",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "peerDependencies": {
+    "date-fns": "2.28.0",
+    "date-fns-tz": "1.2.2",
+    "class-transformer": "0.5.1",
+    "class-validator": "0.13.2",
+    "reflect-metadata": "0.1.13",
+    "rrule": "2.6.8"
+  },
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "dependencies": {
+    "@dereekb/util": "0.0.1",
+    "extra-set": "^2.2.11"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/date';
+export * from './lib/expires';
+export * from './lib/rrule';

package/src/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./lib/date"), exports);
+(0, tslib_1.__exportStar)(require("./lib/expires"), exports);
+(0, tslib_1.__exportStar)(require("./lib/rrule"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/date/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAA2B;AAC3B,6DAA8B;AAC9B,2DAA4B"}

package/src/lib/date/date.calendar.d.ts

@@ -0,0 +1,29 @@
+import { ISO8601DayString } from '@dereekb/util';
+import { DateDurationSpan } from './date.duration';
+/**
+ * CalendarDateType
+ */
+export declare enum CalendarDateType {
+    /**
+     * Event starts at a specific time and lasts for a certain duration.
+     */
+    TIME = "time",
+    /**
+     * Event is specifically for a number of days. Duration is still tracked in minutes.
+     */
+    DAYS = "days"
+}
+/**
+ * Represents a date on a calendar.
+ */
+export declare class CalendarDate extends DateDurationSpan {
+    /**
+     * The type of event date.
+     */
+    type: CalendarDateType;
+    constructor(template: CalendarDate);
+}
+export declare class CalendarDateUtility {
+    static calendarDateForDay(day: ISO8601DayString, days?: number): CalendarDate;
+    static calendarDateForDateDurationSpan(dateDurationSpan: DateDurationSpan): CalendarDate;
+}

package/src/lib/date/date.calendar.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarDateUtility = exports.CalendarDate = exports.CalendarDateType = void 0;
+const tslib_1 = require("tslib");
+const class_transformer_1 = require("class-transformer");
+const date_1 = require("./date");
+const date_duration_1 = require("./date.duration");
+const date_format_1 = require("./date.format");
+/**
+ * CalendarDateType
+ */
+var CalendarDateType;
+(function (CalendarDateType) {
+    /**
+     * Event starts at a specific time and lasts for a certain duration.
+     */
+    CalendarDateType["TIME"] = "time";
+    /**
+     * Event is specifically for a number of days. Duration is still tracked in minutes.
+     */
+    CalendarDateType["DAYS"] = "days";
+})(CalendarDateType = exports.CalendarDateType || (exports.CalendarDateType = {}));
+/**
+ * Represents a date on a calendar.
+ */
+class CalendarDate extends date_duration_1.DateDurationSpan {
+    constructor(template) {
+        super(template);
+        /**
+         * The type of event date.
+         */
+        this.type = CalendarDateType.TIME;
+        this.type = template.type;
+    }
+}
+(0, tslib_1.__decorate)([
+    (0, class_transformer_1.Expose)(),
+    (0, tslib_1.__metadata)("design:type", String)
+], CalendarDate.prototype, "type", void 0);
+exports.CalendarDate = CalendarDate;
+class CalendarDateUtility {
+    static calendarDateForDay(day, days) {
+        return {
+            type: CalendarDateType.DAYS,
+            startsAt: (0, date_format_1.dateStringToDate)(day),
+            duration: (0, date_1.daysToMinutes)(days)
+        };
+    }
+    static calendarDateForDateDurationSpan(dateDurationSpan) {
+        return Object.assign({ type: CalendarDateType.TIME }, dateDurationSpan);
+    }
+}
+exports.CalendarDateUtility = CalendarDateUtility;
+//# sourceMappingURL=date.calendar.js.map

package/src/lib/date/date.calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.calendar.js","sourceRoot":"","sources":["../../../../../../packages/date/src/lib/date/date.calendar.ts"],"names":[],"mappings":";;;;AACA,yDAA2C;AAC3C,iCAAuC;AACvC,mDAAmD;AACnD,+CAAiD;AAEjD;;GAEG;AACH,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,iCAAa,CAAA;IACb;;OAEG;IACH,iCAAa,CAAA;AACf,CAAC,EATW,gBAAgB,GAAhB,wBAAgB,KAAhB,wBAAgB,QAS3B;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,gCAAgB;IAQhD,YAAY,QAAsB;QAChC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAPlB;;WAEG;QAEH,SAAI,GAAqB,gBAAgB,CAAC,IAAI,CAAC;QAI7C,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CAEF;AAPC;IADC,IAAA,0BAAM,GAAE;;0CACsC;AANjD,oCAaC;AAED,MAAa,mBAAmB;IAE9B,MAAM,CAAC,kBAAkB,CAAC,GAAqB,EAAE,IAAa;QAC5D,OAAO;YACL,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,QAAQ,EAAE,IAAA,8BAAgB,EAAC,GAAG,CAAC;YAC/B,QAAQ,EAAE,IAAA,oBAAa,EAAC,IAAI,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,+BAA+B,CAAC,gBAAkC;QACvE,uBACE,IAAI,EAAE,gBAAgB,CAAC,IAAI,IACxB,gBAAgB,EACnB;IACJ,CAAC;CAEF;AAjBD,kDAiBC"}

package/src/lib/date/date.d.ts

@@ -0,0 +1,61 @@
+import { DateOrDateString, ISO8601DateString, Maybe, Minutes, Seconds } from '@dereekb/util';
+export declare const MAX_FUTURE_DATE: Date;
+export declare function msToMinutes(milliseconds: number): Minutes;
+export declare function msToSeconds(milliseconds: number): Seconds;
+export declare function hoursToMs(hours?: number): Minutes;
+export declare function minutesToMs(minutes?: number): Minutes;
+export declare function daysToMinutes(days?: number): Minutes;
+export declare function maxFutureDate(): Date;
+export declare function isMaxFutureDate(date: Date): boolean;
+export declare function latestMinute(time?: Date): Date;
+export declare function toISODateString(input: DateOrDateString): ISO8601DateString;
+export declare function guessCurrentTimezone(): string;
+/**
+ * Converts the input DateOrDateString to a Date value.
+ *
+ * @param input
+ * @returns
+ */
+export declare function toJsDate(input: DateOrDateString): Date;
+/**
+ * Returns the latest date from the input array.
+ */
+export declare function latestDate(dates: Maybe<Date>[]): Maybe<Date>;
+export declare function latestDate(dates: Maybe<Date>[], defaultDate: Date): Date;
+/**
+ * Returns true if a and b are defined and a is after b, otherwise returns the default value.
+ */
+export declare function isAfter(a: Maybe<Date>, b: Maybe<Date>): Maybe<boolean>;
+export declare function isAfter(a: Maybe<Date>, b: Maybe<Date>, defaultValue: boolean): boolean;
+/**
+ * Converts the input date to represent the "day" represented in the time.
+ *
+ * For example, 1/1/2021 should be represented as a UTC-offset date for 1/1/2021 for the first instant of the day.
+ */
+export declare function utcDayForDate(date: Date): Date;
+/**
+ * Takes the next occuring time of the input date's hours/minutes.
+ *
+ * For example, if it is currently 9PM:
+ * - if 10PM on any day is passed then 9PM the next day will be returned.
+ * - if 11PM on any day is passed, 11PM today will be returned.
+ */
+export declare function takeNextUpcomingTime(date: Date, removeSeconds?: boolean): Date;
+/**
+ * Creates a new date and copies the hours/minutes from the previous date.
+ */
+export declare function copyHoursAndMinutesFromDateToToday(date: Date, removeSeconds?: boolean): Date;
+/**
+ * Creates a new date and copies the hours/minutes from the input.
+ *
+ * Also rounds the seconds and milliseconds.
+ */
+export declare function copyHoursAndMinutesToToday({ hours, minutes, removeSeconds }: {
+    hours: number;
+    minutes?: number;
+    removeSeconds?: boolean;
+}): Date;
+/**
+ * Removes the seconds and milliseconds from the input date.
+ */
+export declare function roundDownToMinute(date?: Date): Date;

package/src/lib/date/date.duration.d.ts

@@ -0,0 +1,9 @@
+import { Minutes } from "@dereekb/util";
+import { DateRange, DateRangeState } from "./date.range";
+export declare class DateDurationSpan {
+    startsAt: Date;
+    duration: Minutes;
+    constructor(template: DateDurationSpan);
+}
+export declare function durationSpanToDateRange(span: DateDurationSpan): DateRange;
+export declare function durationSpanDateRangeState(span: DateDurationSpan): DateRangeState;

package/src/lib/date/date.duration.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.durationSpanDateRangeState = exports.durationSpanToDateRange = exports.DateDurationSpan = void 0;
+const tslib_1 = require("tslib");
+const class_transformer_1 = require("class-transformer");
+const date_fns_1 = require("date-fns");
+const date_range_1 = require("./date.range");
+class DateDurationSpan {
+    constructor(template) {
+        this.startsAt = template.startsAt;
+        this.duration = template.duration;
+    }
+}
+(0, tslib_1.__decorate)([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => Date),
+    (0, tslib_1.__metadata)("design:type", Date)
+], DateDurationSpan.prototype, "startsAt", void 0);
+(0, tslib_1.__decorate)([
+    (0, class_transformer_1.Expose)(),
+    (0, tslib_1.__metadata)("design:type", Number)
+], DateDurationSpan.prototype, "duration", void 0);
+exports.DateDurationSpan = DateDurationSpan;
+function durationSpanToDateRange(span) {
+    return {
+        start: span.startsAt,
+        end: (0, date_fns_1.addMinutes)(span.startsAt, span.duration)
+    };
+}
+exports.durationSpanToDateRange = durationSpanToDateRange;
+function durationSpanDateRangeState(span) {
+    return (0, date_range_1.dateRangeState)(durationSpanToDateRange(span));
+}
+exports.durationSpanDateRangeState = durationSpanDateRangeState;
+//# sourceMappingURL=date.duration.js.map

package/src/lib/date/date.duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.duration.js","sourceRoot":"","sources":["../../../../../../packages/date/src/lib/date/date.duration.ts"],"names":[],"mappings":";;;;AACA,yDAAiD;AACjD,uCAAsC;AACtC,6CAAyE;AAEzE,MAAa,gBAAgB;IAS3B,YAAY,QAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACpC,CAAC;CAEF;AAVC;IAFC,IAAA,0BAAM,GAAE;IACR,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC;2CACP,IAAI;kDAAC;AAGf;IADC,IAAA,0BAAM,GAAE;;kDACS;AAPpB,4CAcC;AAED,SAAgB,uBAAuB,CAAC,IAAsB;IAC5D,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,QAAQ;QACpB,GAAG,EAAE,IAAA,qBAAU,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;KAC9C,CAAC;AACJ,CAAC;AALD,0DAKC;AAED,SAAgB,0BAA0B,CAAC,IAAsB;IAC/D,OAAO,IAAA,2BAAc,EAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC;AAFD,gEAEC"}

package/src/lib/date/date.format.d.ts

@@ -0,0 +1,11 @@
+import { ISO8601DayString } from "@dereekb/util";
+import { DateRange } from "./date.range";
+/**
+ * Formats the input to be start - end
+ */
+export declare function formatToTimeRangeString(start: Date, end: Date): string;
+export declare function formatToDateString(date: Date): string;
+export declare function formatToTimeString(date: Date): string;
+export declare function formatToTimeAndDurationString(start: Date, end: Date): string;
+export declare function formatStartedEndedDistanceString({ start, end }: DateRange): string;
+export declare function dateStringToDate(dateString: ISO8601DayString): Date;

package/src/lib/date/date.format.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateStringToDate = exports.formatStartedEndedDistanceString = exports.formatToTimeAndDurationString = exports.formatToTimeString = exports.formatToDateString = exports.formatToTimeRangeString = void 0;
+const date_fns_1 = require("date-fns");
+const date_range_1 = require("./date.range");
+/**
+ * Formats the input to be start - end
+ */
+function formatToTimeRangeString(start, end) {
+    return `${formatToTimeString(start)} - ${formatToTimeString(end)}`;
+}
+exports.formatToTimeRangeString = formatToTimeRangeString;
+function formatToDateString(date) {
+    return (0, date_fns_1.format)(date, 'EEE, MMM do');
+}
+exports.formatToDateString = formatToDateString;
+function formatToTimeString(date) {
+    return (0, date_fns_1.format)(date, 'h:mm a');
+}
+exports.formatToTimeString = formatToTimeString;
+function formatToTimeAndDurationString(start, end) {
+    const minutes = (0, date_fns_1.differenceInMinutes)(end, start);
+    let subtitle;
+    if (minutes > 120) {
+        subtitle = `(${(0, date_fns_1.formatDistance)(end, start, { includeSeconds: false })})`;
+    }
+    else {
+        subtitle = `${(minutes) ? `(${minutes} Minutes)` : ''}`;
+    }
+    return `${formatToTimeString(start)} ${subtitle}`;
+}
+exports.formatToTimeAndDurationString = formatToTimeAndDurationString;
+function formatStartedEndedDistanceString({ start, end }) {
+    const state = (0, date_range_1.dateRangeState)({ start, end });
+    let distanceText;
+    switch (state) {
+        case date_range_1.DateRangeState.PAST:
+            distanceText = `ended ${(0, date_fns_1.formatDistanceToNow)(end, {
+                addSuffix: true
+            })}`;
+            break;
+        case date_range_1.DateRangeState.PRESENT:
+            distanceText = `started ${(0, date_fns_1.formatDistanceToNow)(start, {
+                addSuffix: true
+            })}`;
+            break;
+        case date_range_1.DateRangeState.FUTURE:
+            distanceText = `starting ${(0, date_fns_1.formatDistanceToNow)(start, {
+                addSuffix: true
+            })}`;
+            break;
+    }
+    return distanceText;
+}
+exports.formatStartedEndedDistanceString = formatStartedEndedDistanceString;
+function dateStringToDate(dateString) {
+    return (0, date_fns_1.startOfDay)((0, date_fns_1.parse)(dateString, 'yyyy-MM-dd', new Date()));
+}
+exports.dateStringToDate = dateStringToDate;
+//# sourceMappingURL=date.format.js.map

package/src/lib/date/date.format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.format.js","sourceRoot":"","sources":["../../../../../../packages/date/src/lib/date/date.format.ts"],"names":[],"mappings":";;;AACA,uCAA+G;AAC/G,6CAAyE;AAEzE;;GAEG;AACF,SAAgB,uBAAuB,CAAC,KAAW,EAAE,GAAS;IAC7D,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AACrE,CAAC;AAFA,0DAEA;AAED,SAAgB,kBAAkB,CAAC,IAAU;IAC3C,OAAO,IAAA,iBAAM,EAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AACrC,CAAC;AAFD,gDAEC;AAED,SAAgB,kBAAkB,CAAC,IAAU;IAC3C,OAAO,IAAA,iBAAM,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAFD,gDAEC;AAED,SAAgB,6BAA6B,CAAC,KAAW,EAAE,GAAS;IAClE,MAAM,OAAO,GAAG,IAAA,8BAAmB,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,QAAQ,CAAC;IAEb,IAAI,OAAO,GAAG,GAAG,EAAE;QACjB,QAAQ,GAAG,IAAI,IAAA,yBAAc,EAAC,GAAG,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;KACzE;SAAM;QACL,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KACzD;IAED,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;AACpD,CAAC;AAXD,sEAWC;AAED,SAAgB,gCAAgC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAa;IACxE,MAAM,KAAK,GAAG,IAAA,2BAAc,EAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,IAAI,YAAY,CAAC;IAEjB,QAAQ,KAAK,EAAE;QACb,KAAK,2BAAc,CAAC,IAAI;YACtB,YAAY,GAAG,SAAS,IAAA,8BAAmB,EAAC,GAAG,EAAE;gBAC/C,SAAS,EAAE,IAAI;aAChB,CAAC,EAAE,CAAC;YACL,MAAM;QACR,KAAK,2BAAc,CAAC,OAAO;YACzB,YAAY,GAAG,WAAW,IAAA,8BAAmB,EAAC,KAAK,EAAE;gBACnD,SAAS,EAAE,IAAI;aAChB,CAAC,EAAE,CAAC;YACL,MAAM;QACR,KAAK,2BAAc,CAAC,MAAM;YACxB,YAAY,GAAG,YAAY,IAAA,8BAAmB,EAAC,KAAK,EAAE;gBACpD,SAAS,EAAE,IAAI;aAChB,CAAC,EAAE,CAAC;YACL,MAAM;KACT;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAvBD,4EAuBC;AAED,SAAgB,gBAAgB,CAAC,UAA4B;IAC3D,OAAO,IAAA,qBAAU,EAAC,IAAA,gBAAK,EAAC,UAAU,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC;AAFD,4CAEC"}

package/src/lib/date/date.hashset.d.ts

@@ -0,0 +1,4 @@
+import { HashSet } from '@dereekb/util';
+export declare class DateSet extends HashSet<number, Date> {
+    constructor(values?: Date[]);
+}

package/src/lib/date/date.hashset.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateSet = void 0;
+const util_1 = require("@dereekb/util");
+class DateSet extends util_1.HashSet {
+    constructor(values) {
+        super({ readKey: (date) => date.getTime() }, values);
+    }
+}
+exports.DateSet = DateSet;
+//# sourceMappingURL=date.hashset.js.map

package/src/lib/date/date.hashset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.hashset.js","sourceRoot":"","sources":["../../../../../../packages/date/src/lib/date/date.hashset.ts"],"names":[],"mappings":";;;AAAA,wCAAwC;AAExC,MAAa,OAAQ,SAAQ,cAAqB;IAEhD,YAAY,MAAe;QACzB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;CAEF;AAND,0BAMC"}

package/src/lib/date/date.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roundDownToMinute = exports.copyHoursAndMinutesToToday = exports.copyHoursAndMinutesFromDateToToday = exports.takeNextUpcomingTime = exports.utcDayForDate = exports.isAfter = exports.latestDate = exports.toJsDate = exports.guessCurrentTimezone = exports.toISODateString = exports.latestMinute = exports.isMaxFutureDate = exports.maxFutureDate = exports.daysToMinutes = exports.minutesToMs = exports.hoursToMs = exports.msToSeconds = exports.msToMinutes = exports.MAX_FUTURE_DATE = void 0;
+const date_fns_1 = require("date-fns");
+const util_1 = require("@dereekb/util");
+exports.MAX_FUTURE_DATE = new Date(Date.UTC(9999, 0));
+function msToMinutes(milliseconds) {
+    return milliseconds / (60 * 1000);
+}
+exports.msToMinutes = msToMinutes;
+function msToSeconds(milliseconds) {
+    return milliseconds / 1000;
+}
+exports.msToSeconds = msToSeconds;
+function hoursToMs(hours = 1) {
+    return hours * util_1.MS_IN_HOUR;
+}
+exports.hoursToMs = hoursToMs;
+function minutesToMs(minutes = 1) {
+    return minutes * util_1.MS_IN_MINUTE;
+}
+exports.minutesToMs = minutesToMs;
+function daysToMinutes(days = 1) {
+    return days * util_1.MINUTES_IN_DAY;
+}
+exports.daysToMinutes = daysToMinutes;
+function maxFutureDate() {
+    return exports.MAX_FUTURE_DATE;
+}
+exports.maxFutureDate = maxFutureDate;
+function isMaxFutureDate(date) {
+    return exports.MAX_FUTURE_DATE.getTime() === date.getTime();
+}
+exports.isMaxFutureDate = isMaxFutureDate;
+function latestMinute(time = new Date) {
+    return (0, date_fns_1.startOfMinute)(time);
+}
+exports.latestMinute = latestMinute;
+function toISODateString(input) {
+    const date = toJsDate(input);
+    if (!(0, date_fns_1.isValid)(date)) {
+        throw new Error('Invalid date passed.');
+    }
+    return date.toISOString();
+}
+exports.toISODateString = toISODateString;
+function guessCurrentTimezone() {
+    var _a, _b;
+    return (_b = (_a = Intl.DateTimeFormat()) === null || _a === void 0 ? void 0 : _a.resolvedOptions()) === null || _b === void 0 ? void 0 : _b.timeZone;
+}
+exports.guessCurrentTimezone = guessCurrentTimezone;
+/**
+ * Converts the input DateOrDateString to a Date value.
+ *
+ * @param input
+ * @returns
+ */
+function toJsDate(input) {
+    return ((0, date_fns_1.isDate)(input) ? input : (0, date_fns_1.parseISO)(input));
+}
+exports.toJsDate = toJsDate;
+function latestDate(dates, defaultDate = undefined) {
+    const filtered = (0, util_1.filterMaybeValues)(dates);
+    return (filtered.length > 0) ? (0, date_fns_1.max)(filtered) : undefined;
+}
+exports.latestDate = latestDate;
+function isAfter(a, b, defaultValue = undefined) {
+    return (a && b) ? (0, date_fns_1.isAfter)(a, b) : defaultValue;
+}
+exports.isAfter = isAfter;
+// MARK: Unix Date/Time
+/**
+ * Converts the input date to represent the "day" represented in the time.
+ *
+ * For example, 1/1/2021 should be represented as a UTC-offset date for 1/1/2021 for the first instant of the day.
+ */
+function utcDayForDate(date) {
+    return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+}
+exports.utcDayForDate = utcDayForDate;
+/**
+ * Takes the next occuring time of the input date's hours/minutes.
+ *
+ * For example, if it is currently 9PM:
+ * - if 10PM on any day is passed then 9PM the next day will be returned.
+ * - if 11PM on any day is passed, 11PM today will be returned.
+ */
+function takeNextUpcomingTime(date, removeSeconds) {
+    date = copyHoursAndMinutesFromDateToToday(date, removeSeconds);
+    if ((0, date_fns_1.isPast)(date)) {
+        date = (0, date_fns_1.addDays)(date, 1);
+    }
+    return date;
+}
+exports.takeNextUpcomingTime = takeNextUpcomingTime;
+/**
+ * Creates a new date and copies the hours/minutes from the previous date.
+ */
+function copyHoursAndMinutesFromDateToToday(date, removeSeconds) {
+    return copyHoursAndMinutesToToday({
+        hours: date.getHours(),
+        minutes: date.getMinutes(),
+        removeSeconds
+    });
+}
+exports.copyHoursAndMinutesFromDateToToday = copyHoursAndMinutesFromDateToToday;
+/**
+ * Creates a new date and copies the hours/minutes from the input.
+ *
+ * Also rounds the seconds and milliseconds.
+ */
+function copyHoursAndMinutesToToday({ hours, minutes, removeSeconds = true }) {
+    return (0, date_fns_1.set)(new Date(), Object.assign(Object.assign({ hours }, (minutes != null) ? {
+        minutes
+    } : undefined), (removeSeconds) ? {
+        seconds: 0,
+        milliseconds: 0
+    } : undefined));
+}
+exports.copyHoursAndMinutesToToday = copyHoursAndMinutesToToday;
+/**
+ * Removes the seconds and milliseconds from the input date.
+ */
+function roundDownToMinute(date = new Date()) {
+    return (0, date_fns_1.set)(date, {
+        seconds: 0,
+        milliseconds: 0
+    });
+}
+exports.roundDownToMinute = roundDownToMinute;
+//# sourceMappingURL=date.js.map

package/src/lib/date/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../../../packages/date/src/lib/date/date.ts"],"names":[],"mappings":"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"}

package/src/lib/date/date.range.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Represents a start and end date.
+ */
+export interface DateRange {
+    start: Date;
+    end: Date;
+}
+export declare enum DateRangeType {
+    /**
+     * Includes only the target day.
+     */
+    DAY = "day",
+    /**
+     * Includes only the target week.
+     */
+    WEEK = "week",
+    /**
+     * Includes only the target month.
+     */
+    MONTH = "month",
+    /**
+     * Range specified in hours with the input.
+     */
+    HOURS_RANGE = "hours_range",
+    /**
+     * Range specified in days with the input.
+     */
+    DAYS_RANGE = "days_range",
+    /**
+     * Range specified in weeks with the input.
+     */
+    WEEKS_RANGE = "weeks_range",
+    /**
+     * Radius specified in hours with the input.
+     */
+    HOURS_RADIUS = "hours_radius",
+    /**
+     * Radius specified in days with the input.
+     */
+    DAYS_RADIUS = "days_radius",
+    /**
+     * Radius specified in weeks with the input.
+     */
+    WEEKS_RADIUS = "weeks_radius",
+    /**
+     * Plus/minus 20 hours from the current day.
+     *
+     * @deprecated design not relevant anymore
+     */
+    WITHIN_DAY = "within_day",
+    /**
+     * Plus/minus 4 days from the current day.
+     *
+     * @deprecated design not relevant anymore
+     */
+    WITHIN_WEEK = "within_week",
+    /**
+     * Plus/minus 16 days from the current day.
+     *
+     * @deprecated design not relevant anymore
+     */
+    WITHIN_MONTH = "within_month"
+}
+export declare enum DateRangeState {
+    /**
+     * Range has yet to start and is in the future.
+     */
+    FUTURE = "future",
+    /**
+     * Range is in the present, but not yet ended.
+     */
+    PRESENT = "present",
+    /**
+     * Range is in the past.
+     */
+    PAST = "past"
+}
+/**
+ * Params for building a date range.
+ */
+export declare class DateRangeParams {
+    /**
+     * Type of range.
+     */
+    type: DateRangeType;
+    /**
+     * Date to filter on. If not provided, assumes now.
+     */
+    date?: Date;
+    distance?: number;
+    constructor(template: DateRangeParams);
+}
+/**
+ * Creates a DateRange from the input DateRangeParams
+ *
+ * @param param0
+ * @param roundToMinute
+ * @returns
+ */
+export declare function makeDateRange({ type, date, distance }: DateRangeParams, roundToMinute?: boolean): DateRange;
+/**
+ * Returns the DateRangeState from the input DateRange.
+ *
+ * @param param0
+ * @returns
+ */
+export declare function dateRangeState({ start, end }: DateRange): DateRangeState;