@sprucelabs/calendar-utils 40.0.139 → 40.1.0

package/build/esm/index.d.ts

@@ -3,6 +3,7 @@ export { default as dateUtil } from './utilities/date.utility';
 export * from './utilities/date.utility';
 export * from './types/calendar.types';
 export { default as durationUtil } from './utilities/duration.utility';
+export { default as dateAssert } from './utilities/dateAssert';
 export * from './utilities/duration.utility';
 export { default as PeopleSorter } from './utilities/PeopleSorter';
 export { default as LocaleImpl } from './locales/Locale';
@@ -21,3 +22,4 @@ export { default as RepeatingRuleTextGenerator } from './utilities/RepeatingRule
 export * from './dates';
 export { SpruceSchemas } from './.spruce/schemas/schemas.types';
 export * from './constants';
+export { default as DurationUtilBuilder } from './utilities/DurationUtilBuilder';

package/build/esm/index.js

@@ -3,6 +3,7 @@ export { default as dateUtil } from './utilities/date.utility.js';
 export * from './utilities/date.utility.js';
 export * from './types/calendar.types.js';
 export { default as durationUtil } from './utilities/duration.utility.js';
+export { default as dateAssert } from './utilities/dateAssert.js';
 export * from './utilities/duration.utility.js';
 export { default as PeopleSorter } from './utilities/PeopleSorter.js';
 export { default as LocaleImpl } from './locales/Locale.js';
@@ -20,3 +21,4 @@ export { default as sortTimezoneChoices } from './utilities/sortTimezoneChoices.
 export { default as RepeatingRuleTextGenerator } from './utilities/RepeatingRuleTextGenerator.js';
 export * from './dates.js';
 export * from './constants.js';
+export { default as DurationUtilBuilder } from './utilities/DurationUtilBuilder.js';

package/build/esm/types/calendar.types.d.ts

@@ -2,6 +2,7 @@ import { timezoneChoices } from '@sprucelabs/spruce-core-schemas';
 import { SpruceSchemas } from './../.spruce/schemas/schemas.types';
 import LocaleImpl from '../locales/Locale';
 import dateUtil from '../utilities/date.utility';
+import durationUtil from '../utilities/duration.utility';
 type D = typeof dateUtil;
 /**
  * @deprecated DateUtils -> DateUtil
@@ -10,6 +11,9 @@ export interface DateUtils extends D {
 }
 export interface DateUtil extends D {
 }
+type Du = typeof durationUtil;
+export interface DurationUtil extends Du {
+}
 export type CalendarEvent = SpruceSchemas.CalendarUtils.v2021_05_19.CalendarEvent;
 export type DayOfWeek = NonNullable<CalendarEvent['daysOfWeek']>[number];
 export type TimezoneChoices = typeof timezoneChoices;

package/build/esm/utilities/DurationUtilBuilder.d.ts

@@ -0,0 +1,112 @@
+import { TimezoneName } from '../types/calendar.types';
+export default class DurationUtilBuilder {
+    static durationUtil: {
+        dates: {
+            eventDaysOfWeek: {
+                sun: string;
+                mon: string;
+                tue: string;
+                wed: string;
+                thur: string;
+                fri: string;
+                sat: string;
+            };
+            getStartOfDay(timestamp?: number | undefined): number;
+            getStartOfWeek(timestamp?: number | undefined): number;
+            getEndOfDay(timestamp?: number | undefined): number;
+            getEndOfWeek(timestamp: number): number;
+            getStartOfMonth(timestamp?: number | undefined): number;
+            getEndOfMonth(timestamp?: number | undefined): number;
+            addMinutes(startTimestamp: number, minutes: number): number;
+            addMilliseconds(startTimestamp: number, ms: number): number;
+            addDays(startTimestamp: number, days: number): number;
+            addWeeks(startTimestamp: number, weeks: number): number;
+            addMonths(timestamp: number, months: number): number;
+            addYears(timestamp: number, years: number): number;
+            getDurationMs(timestamp: number, endTimestamp: number): number;
+            getDurationMinutes(timestamp: number, endTimestamp: number): number;
+            getDurationDays(timestamp: number, endTimestamp: number): number;
+            getDayOfWeek(timestamp: number): "sun" | "mon" | "tue" | "wed" | "thur" | "fri" | "sat";
+            getDayOfWeekIndex(timestamp: number): number;
+            splitDate(timestamp: number): {
+                year: number;
+                month: number;
+                day: number;
+                hour: number;
+                minute: number;
+            };
+            setTimeOfDay(timestamp: number, hours: number, minutes?: number | undefined, seconds?: number | undefined, milliseconds?: number | undefined): number;
+            getDateNDaysFromStartOfDay(days: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfDay(count: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfMonth(count: number, timestamp?: number | undefined): number;
+            date(date?: import("./date.utility").IDate | undefined): number;
+            format(timestamp: number, format: string): string;
+            formatTime(timestamp: number): string;
+            formatDate(timestamp: number): string;
+            formatDateTime(timestamp: number): string;
+            add(timestamp: number, count: number, unit: import("./date.utility").DateUnit): any;
+            isSameDay(timestamp1: number, timestamp2: number): boolean;
+            getTotalDaysInMonth(year: number, month: number): number;
+        };
+        msToFriendly(duration: number): string;
+        renderDuration(durationMs: number): string;
+        dateTimeUntilFriendly(start: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderTimeRange(date1: number, date2: number): string;
+    };
+    static getForTimezone(timezone: TimezoneName): Promise<{
+        dates: {
+            eventDaysOfWeek: {
+                sun: string;
+                mon: string;
+                tue: string;
+                wed: string;
+                thur: string;
+                fri: string;
+                sat: string;
+            };
+            getStartOfDay(timestamp?: number | undefined): number;
+            getStartOfWeek(timestamp?: number | undefined): number;
+            getEndOfDay(timestamp?: number | undefined): number;
+            getEndOfWeek(timestamp: number): number;
+            getStartOfMonth(timestamp?: number | undefined): number;
+            getEndOfMonth(timestamp?: number | undefined): number;
+            addMinutes(startTimestamp: number, minutes: number): number;
+            addMilliseconds(startTimestamp: number, ms: number): number;
+            addDays(startTimestamp: number, days: number): number;
+            addWeeks(startTimestamp: number, weeks: number): number;
+            addMonths(timestamp: number, months: number): number;
+            addYears(timestamp: number, years: number): number;
+            getDurationMs(timestamp: number, endTimestamp: number): number;
+            getDurationMinutes(timestamp: number, endTimestamp: number): number;
+            getDurationDays(timestamp: number, endTimestamp: number): number;
+            getDayOfWeek(timestamp: number): "sun" | "mon" | "tue" | "wed" | "thur" | "fri" | "sat";
+            getDayOfWeekIndex(timestamp: number): number;
+            splitDate(timestamp: number): {
+                year: number;
+                month: number;
+                day: number;
+                hour: number;
+                minute: number;
+            };
+            setTimeOfDay(timestamp: number, hours: number, minutes?: number | undefined, seconds?: number | undefined, milliseconds?: number | undefined): number;
+            getDateNDaysFromStartOfDay(days: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfDay(count: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfMonth(count: number, timestamp?: number | undefined): number;
+            date(date?: import("./date.utility").IDate | undefined): number;
+            format(timestamp: number, format: string): string;
+            formatTime(timestamp: number): string;
+            formatDate(timestamp: number): string;
+            formatDateTime(timestamp: number): string;
+            add(timestamp: number, count: number, unit: import("./date.utility").DateUnit): any;
+            isSameDay(timestamp1: number, timestamp2: number): boolean;
+            getTotalDaysInMonth(year: number, month: number): number;
+        };
+        msToFriendly(duration: number): string;
+        renderDuration(durationMs: number): string;
+        dateTimeUntilFriendly(start: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderTimeRange(date1: number, date2: number): string;
+    }>;
+    static reset(): void;
+}

package/build/esm/utilities/DurationUtilBuilder.js

@@ -0,0 +1,29 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import DateUtilDecorator from '../locales/DateUtilDecorator.js';
+import LocaleImpl from '../locales/Locale.js';
+import dateUtil from './date.utility.js';
+import durationUtil from './duration.utility.js';
+class DurationUtilBuilder {
+    static getForTimezone(timezone) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const locale = new LocaleImpl();
+            yield locale.setZoneName(timezone);
+            const durationUtilCopy = Object.assign({}, this.durationUtil);
+            durationUtilCopy.dates = new DateUtilDecorator(locale).makeLocaleAware(dateUtil);
+            return durationUtilCopy;
+        });
+    }
+    static reset() {
+        this.durationUtil = Object.assign({}, durationUtil);
+    }
+}
+DurationUtilBuilder.durationUtil = Object.assign({}, durationUtil);
+export default DurationUtilBuilder;

package/build/esm/utilities/dateAssert.d.ts

@@ -0,0 +1,6 @@
+import { DateUtil, DurationUtil, TimezoneName } from '../types/calendar.types';
+declare const dateAssert: {
+    isLocaleAware(datesOrDuration: DateUtil | DurationUtil): void;
+    currentTimezoneEquals(datesOrDuration: DateUtil | DurationUtil, timezone: TimezoneName): void;
+};
+export default dateAssert;

package/build/esm/utilities/dateAssert.js

@@ -0,0 +1,29 @@
+import { assert } from '@sprucelabs/test-utils';
+const dateAssert = {
+    isLocaleAware(datesOrDuration) {
+        //@ts-ignore
+        if (datesOrDuration.dates) {
+            //@ts-ignore
+            this.isLocaleAware(datesOrDuration.dates);
+            return;
+        }
+        assert.isTrue(
+        //@ts-ignore
+        datesOrDuration.__beenDecorated, `DateUtil is not locale aware. Try using the DateUtilDecorator to make it locale aware.`);
+    },
+    currentTimezoneEquals(datesOrDuration, timezone) {
+        this.isLocaleAware(datesOrDuration);
+        //@ts-ignore
+        if (datesOrDuration.dates) {
+            this.currentTimezoneEquals(
+            //@ts-ignore
+            datesOrDuration.dates, timezone);
+            return;
+        }
+        //@ts-ignore
+        const locale = datesOrDuration.__locale;
+        const actual = locale.getZoneName();
+        assert.isEqual(actual, timezone, `Timezone is not ${timezone}, it is ${actual}`);
+    },
+};
+export default dateAssert;

package/build/esm/utilities/duration.utility.d.ts

@@ -1,11 +1,10 @@
+import { TimezoneName } from '../types/calendar.types';
 declare const durationUtil: {
     dates: {
         eventDaysOfWeek: {
             sun: string;
             mon: string;
-            tue: string; /**
-             * @deprecated durationUtil.msToFriendly(...) -> durationUtil.renderDuration(...)
-             */
+            tue: string;
             wed: string;
             thur: string;
             fri: string;
@@ -56,16 +55,17 @@ declare const durationUtil: {
     /**
      * @deprecated durationUtil.dateTimeUntilFriendly(...) -> durationUtil.renderDateTimeUntil(...)
      */
-    dateTimeUntilFriendly(start: number, prefixes?: Partial<TimeUntilPrefixOptions>): string;
-    renderDateTimeUntil(start: number, now: number, prefixes?: Partial<TimeUntilPrefixOptions>): string;
+    dateTimeUntilFriendly(start: number, prefixes?: Partial<TimeUntilOptions>): string;
+    renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<TimeUntilOptions>): string;
     renderTimeRange(date1: number, date2: number): string;
 };
 export default durationUtil;
-export interface TimeUntilPrefixOptions {
+export interface TimeUntilOptions {
     yesterday?: string | null;
     today?: string | null;
     tomorrow?: string | null;
     future?: string | null;
     past?: string | null;
     shouldCapitalize?: boolean;
+    timezoneName?: TimezoneName;
 }

package/build/esm/utilities/duration.utility.js

@@ -38,11 +38,13 @@ const durationUtil = {
     dateTimeUntilFriendly(start, prefixes) {
         return this.renderDateTimeUntil(start, new Date().getTime(), prefixes);
     },
-    renderDateTimeUntil(start, now, prefixes) {
+    renderDateTimeUntil(beginning, end, prefixes) {
         const { today = null, tomorrow = null, yesterday = null, future = null, past = null, shouldCapitalize, } = prefixes !== null && prefixes !== void 0 ? prefixes : {};
         let prefix = today;
         let startDateAndTime = 'today';
-        const daysFromNow = Math.round((start - now) / (1000 * 3600 * 24));
+        const daysFromNow = Math.round((this.dates.getStartOfDay(beginning) -
+            this.dates.getStartOfDay(end)) /
+            (1000 * 3600 * 24));
         if (daysFromNow === -1) {
             prefix = yesterday;
             startDateAndTime = 'yesterday';
@@ -54,15 +56,17 @@ const durationUtil = {
         else if (daysFromNow > 1) {
             prefix = future;
             startDateAndTime =
-                this.dates.format(start, 'MMM do') + ` (in ${daysFromNow} days)`;
+                this.dates.format(beginning, 'MMM do') +
+                    ` (in ${daysFromNow} days)`;
         }
         else if (daysFromNow < -1) {
             prefix = past;
             startDateAndTime =
-                this.dates.format(start, 'MMM do') +
+                this.dates.format(beginning, 'MMM do') +
                     ` (${daysFromNow * -1} days ago)`;
         }
-        startDateAndTime += ` @ ${this.dates.format(start, 'h:mmaaa')}`.replace(':00', '');
+        startDateAndTime +=
+            ` @ ${this.dates.format(beginning, 'h:mmaaa')}`.replace(':00', '');
         return optionallUcFirst(`${prefix ? `${prefix} ` : ''}${startDateAndTime}`, shouldCapitalize);
     },
     renderTimeRange(date1, date2) {

package/build/index.d.ts

@@ -3,6 +3,7 @@ export { default as dateUtil } from './utilities/date.utility';
 export * from './utilities/date.utility';
 export * from './types/calendar.types';
 export { default as durationUtil } from './utilities/duration.utility';
+export { default as dateAssert } from './utilities/dateAssert';
 export * from './utilities/duration.utility';
 export { default as PeopleSorter } from './utilities/PeopleSorter';
 export { default as LocaleImpl } from './locales/Locale';
@@ -21,3 +22,4 @@ export { default as RepeatingRuleTextGenerator } from './utilities/RepeatingRule
 export * from './dates';
 export { SpruceSchemas } from './.spruce/schemas/schemas.types';
 export * from './constants';
+export { default as DurationUtilBuilder } from './utilities/DurationUtilBuilder';

package/build/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RepeatingRuleTextGenerator = exports.sortTimezoneChoices = exports.DateParser = exports.calendarEventLineIconSchema = exports.eventTimeBlockSchema = exports.eventExclusionDateSchema = exports.calendarEventTargetSchema = exports.calendarEventSchema = exports.calculateEventDurationMinutes = exports.calculateEventDurationMillis = exports.TimezoneChoiceSorter = exports.DateUtilDecorator = exports.LocaleImpl = exports.PeopleSorter = exports.durationUtil = exports.dateUtil = exports.calendarUtil = void 0;
+exports.DurationUtilBuilder = exports.RepeatingRuleTextGenerator = exports.sortTimezoneChoices = exports.DateParser = exports.calendarEventLineIconSchema = exports.eventTimeBlockSchema = exports.eventExclusionDateSchema = exports.calendarEventTargetSchema = exports.calendarEventSchema = exports.calculateEventDurationMinutes = exports.calculateEventDurationMillis = exports.TimezoneChoiceSorter = exports.DateUtilDecorator = exports.LocaleImpl = exports.PeopleSorter = exports.dateAssert = exports.durationUtil = exports.dateUtil = exports.calendarUtil = void 0;
 var calendar_utility_1 = require("./utilities/calendar.utility");
 Object.defineProperty(exports, "calendarUtil", { enumerable: true, get: function () { return __importDefault(calendar_utility_1).default; } });
 var date_utility_1 = require("./utilities/date.utility");
@@ -26,6 +26,8 @@ __exportStar(require("./utilities/date.utility"), exports);
 __exportStar(require("./types/calendar.types"), exports);
 var duration_utility_1 = require("./utilities/duration.utility");
 Object.defineProperty(exports, "durationUtil", { enumerable: true, get: function () { return __importDefault(duration_utility_1).default; } });
+var dateAssert_1 = require("./utilities/dateAssert");
+Object.defineProperty(exports, "dateAssert", { enumerable: true, get: function () { return __importDefault(dateAssert_1).default; } });
 __exportStar(require("./utilities/duration.utility"), exports);
 var PeopleSorter_1 = require("./utilities/PeopleSorter");
 Object.defineProperty(exports, "PeopleSorter", { enumerable: true, get: function () { return __importDefault(PeopleSorter_1).default; } });
@@ -57,3 +59,5 @@ var RepeatingRuleTextGenerator_1 = require("./utilities/RepeatingRuleTextGenerat
 Object.defineProperty(exports, "RepeatingRuleTextGenerator", { enumerable: true, get: function () { return __importDefault(RepeatingRuleTextGenerator_1).default; } });
 __exportStar(require("./dates"), exports);
 __exportStar(require("./constants"), exports);
+var DurationUtilBuilder_1 = require("./utilities/DurationUtilBuilder");
+Object.defineProperty(exports, "DurationUtilBuilder", { enumerable: true, get: function () { return __importDefault(DurationUtilBuilder_1).default; } });

package/build/types/calendar.types.d.ts

@@ -2,6 +2,7 @@ import { timezoneChoices } from '@sprucelabs/spruce-core-schemas';
 import { SpruceSchemas } from './../.spruce/schemas/schemas.types';
 import LocaleImpl from '../locales/Locale';
 import dateUtil from '../utilities/date.utility';
+import durationUtil from '../utilities/duration.utility';
 type D = typeof dateUtil;
 /**
  * @deprecated DateUtils -> DateUtil
@@ -10,6 +11,9 @@ export interface DateUtils extends D {
 }
 export interface DateUtil extends D {
 }
+type Du = typeof durationUtil;
+export interface DurationUtil extends Du {
+}
 export type CalendarEvent = SpruceSchemas.CalendarUtils.v2021_05_19.CalendarEvent;
 export type DayOfWeek = NonNullable<CalendarEvent['daysOfWeek']>[number];
 export type TimezoneChoices = typeof timezoneChoices;

package/build/utilities/DurationUtilBuilder.d.ts

@@ -0,0 +1,112 @@
+import { TimezoneName } from '../types/calendar.types';
+export default class DurationUtilBuilder {
+    static durationUtil: {
+        dates: {
+            eventDaysOfWeek: {
+                sun: string;
+                mon: string;
+                tue: string;
+                wed: string;
+                thur: string;
+                fri: string;
+                sat: string;
+            };
+            getStartOfDay(timestamp?: number | undefined): number;
+            getStartOfWeek(timestamp?: number | undefined): number;
+            getEndOfDay(timestamp?: number | undefined): number;
+            getEndOfWeek(timestamp: number): number;
+            getStartOfMonth(timestamp?: number | undefined): number;
+            getEndOfMonth(timestamp?: number | undefined): number;
+            addMinutes(startTimestamp: number, minutes: number): number;
+            addMilliseconds(startTimestamp: number, ms: number): number;
+            addDays(startTimestamp: number, days: number): number;
+            addWeeks(startTimestamp: number, weeks: number): number;
+            addMonths(timestamp: number, months: number): number;
+            addYears(timestamp: number, years: number): number;
+            getDurationMs(timestamp: number, endTimestamp: number): number;
+            getDurationMinutes(timestamp: number, endTimestamp: number): number;
+            getDurationDays(timestamp: number, endTimestamp: number): number;
+            getDayOfWeek(timestamp: number): "sun" | "mon" | "tue" | "wed" | "thur" | "fri" | "sat";
+            getDayOfWeekIndex(timestamp: number): number;
+            splitDate(timestamp: number): {
+                year: number;
+                month: number;
+                day: number;
+                hour: number;
+                minute: number;
+            };
+            setTimeOfDay(timestamp: number, hours: number, minutes?: number | undefined, seconds?: number | undefined, milliseconds?: number | undefined): number;
+            getDateNDaysFromStartOfDay(days: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfDay(count: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfMonth(count: number, timestamp?: number | undefined): number;
+            date(date?: import("./date.utility").IDate | undefined): number;
+            format(timestamp: number, format: string): string;
+            formatTime(timestamp: number): string;
+            formatDate(timestamp: number): string;
+            formatDateTime(timestamp: number): string;
+            add(timestamp: number, count: number, unit: import("./date.utility").DateUnit): any;
+            isSameDay(timestamp1: number, timestamp2: number): boolean;
+            getTotalDaysInMonth(year: number, month: number): number;
+        };
+        msToFriendly(duration: number): string;
+        renderDuration(durationMs: number): string;
+        dateTimeUntilFriendly(start: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderTimeRange(date1: number, date2: number): string;
+    };
+    static getForTimezone(timezone: TimezoneName): Promise<{
+        dates: {
+            eventDaysOfWeek: {
+                sun: string;
+                mon: string;
+                tue: string;
+                wed: string;
+                thur: string;
+                fri: string;
+                sat: string;
+            };
+            getStartOfDay(timestamp?: number | undefined): number;
+            getStartOfWeek(timestamp?: number | undefined): number;
+            getEndOfDay(timestamp?: number | undefined): number;
+            getEndOfWeek(timestamp: number): number;
+            getStartOfMonth(timestamp?: number | undefined): number;
+            getEndOfMonth(timestamp?: number | undefined): number;
+            addMinutes(startTimestamp: number, minutes: number): number;
+            addMilliseconds(startTimestamp: number, ms: number): number;
+            addDays(startTimestamp: number, days: number): number;
+            addWeeks(startTimestamp: number, weeks: number): number;
+            addMonths(timestamp: number, months: number): number;
+            addYears(timestamp: number, years: number): number;
+            getDurationMs(timestamp: number, endTimestamp: number): number;
+            getDurationMinutes(timestamp: number, endTimestamp: number): number;
+            getDurationDays(timestamp: number, endTimestamp: number): number;
+            getDayOfWeek(timestamp: number): "sun" | "mon" | "tue" | "wed" | "thur" | "fri" | "sat";
+            getDayOfWeekIndex(timestamp: number): number;
+            splitDate(timestamp: number): {
+                year: number;
+                month: number;
+                day: number;
+                hour: number;
+                minute: number;
+            };
+            setTimeOfDay(timestamp: number, hours: number, minutes?: number | undefined, seconds?: number | undefined, milliseconds?: number | undefined): number;
+            getDateNDaysFromStartOfDay(days: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfDay(count: number, timestamp?: number | undefined): number;
+            getDateNMonthsFromStartOfMonth(count: number, timestamp?: number | undefined): number;
+            date(date?: import("./date.utility").IDate | undefined): number;
+            format(timestamp: number, format: string): string;
+            formatTime(timestamp: number): string;
+            formatDate(timestamp: number): string;
+            formatDateTime(timestamp: number): string;
+            add(timestamp: number, count: number, unit: import("./date.utility").DateUnit): any;
+            isSameDay(timestamp1: number, timestamp2: number): boolean;
+            getTotalDaysInMonth(year: number, month: number): number;
+        };
+        msToFriendly(duration: number): string;
+        renderDuration(durationMs: number): string;
+        dateTimeUntilFriendly(start: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<import("./duration.utility").TimeUntilOptions> | undefined): string;
+        renderTimeRange(date1: number, date2: number): string;
+    }>;
+    static reset(): void;
+}

package/build/utilities/DurationUtilBuilder.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const DateUtilDecorator_1 = __importDefault(require("../locales/DateUtilDecorator"));
+const Locale_1 = __importDefault(require("../locales/Locale"));
+const date_utility_1 = __importDefault(require("./date.utility"));
+const duration_utility_1 = __importDefault(require("./duration.utility"));
+class DurationUtilBuilder {
+    static async getForTimezone(timezone) {
+        const locale = new Locale_1.default();
+        await locale.setZoneName(timezone);
+        const durationUtilCopy = { ...this.durationUtil };
+        durationUtilCopy.dates = new DateUtilDecorator_1.default(locale).makeLocaleAware(date_utility_1.default);
+        return durationUtilCopy;
+    }
+    static reset() {
+        this.durationUtil = { ...duration_utility_1.default };
+    }
+}
+DurationUtilBuilder.durationUtil = { ...duration_utility_1.default };
+exports.default = DurationUtilBuilder;

package/build/utilities/dateAssert.d.ts

@@ -0,0 +1,6 @@
+import { DateUtil, DurationUtil, TimezoneName } from '../types/calendar.types';
+declare const dateAssert: {
+    isLocaleAware(datesOrDuration: DateUtil | DurationUtil): void;
+    currentTimezoneEquals(datesOrDuration: DateUtil | DurationUtil, timezone: TimezoneName): void;
+};
+export default dateAssert;

package/build/utilities/dateAssert.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_utils_1 = require("@sprucelabs/test-utils");
+const dateAssert = {
+    isLocaleAware(datesOrDuration) {
+        //@ts-ignore
+        if (datesOrDuration.dates) {
+            //@ts-ignore
+            this.isLocaleAware(datesOrDuration.dates);
+            return;
+        }
+        test_utils_1.assert.isTrue(
+        //@ts-ignore
+        datesOrDuration.__beenDecorated, `DateUtil is not locale aware. Try using the DateUtilDecorator to make it locale aware.`);
+    },
+    currentTimezoneEquals(datesOrDuration, timezone) {
+        this.isLocaleAware(datesOrDuration);
+        //@ts-ignore
+        if (datesOrDuration.dates) {
+            this.currentTimezoneEquals(
+            //@ts-ignore
+            datesOrDuration.dates, timezone);
+            return;
+        }
+        //@ts-ignore
+        const locale = datesOrDuration.__locale;
+        const actual = locale.getZoneName();
+        test_utils_1.assert.isEqual(actual, timezone, `Timezone is not ${timezone}, it is ${actual}`);
+    },
+};
+exports.default = dateAssert;

package/build/utilities/duration.utility.d.ts

@@ -1,11 +1,10 @@
+import { TimezoneName } from '../types/calendar.types';
 declare const durationUtil: {
     dates: {
         eventDaysOfWeek: {
             sun: string;
             mon: string;
-            tue: string; /**
-             * @deprecated durationUtil.msToFriendly(...) -> durationUtil.renderDuration(...)
-             */
+            tue: string;
             wed: string;
             thur: string;
             fri: string;
@@ -56,16 +55,17 @@ declare const durationUtil: {
     /**
      * @deprecated durationUtil.dateTimeUntilFriendly(...) -> durationUtil.renderDateTimeUntil(...)
      */
-    dateTimeUntilFriendly(start: number, prefixes?: Partial<TimeUntilPrefixOptions>): string;
-    renderDateTimeUntil(start: number, now: number, prefixes?: Partial<TimeUntilPrefixOptions>): string;
+    dateTimeUntilFriendly(start: number, prefixes?: Partial<TimeUntilOptions>): string;
+    renderDateTimeUntil(beginning: number, end: number, prefixes?: Partial<TimeUntilOptions>): string;
     renderTimeRange(date1: number, date2: number): string;
 };
 export default durationUtil;
-export interface TimeUntilPrefixOptions {
+export interface TimeUntilOptions {
     yesterday?: string | null;
     today?: string | null;
     tomorrow?: string | null;
     future?: string | null;
     past?: string | null;
     shouldCapitalize?: boolean;
+    timezoneName?: TimezoneName;
 }

package/build/utilities/duration.utility.js

@@ -43,11 +43,13 @@ const durationUtil = {
     dateTimeUntilFriendly(start, prefixes) {
         return this.renderDateTimeUntil(start, new Date().getTime(), prefixes);
     },
-    renderDateTimeUntil(start, now, prefixes) {
+    renderDateTimeUntil(beginning, end, prefixes) {
         const { today = null, tomorrow = null, yesterday = null, future = null, past = null, shouldCapitalize, } = prefixes !== null && prefixes !== void 0 ? prefixes : {};
         let prefix = today;
         let startDateAndTime = 'today';
-        const daysFromNow = Math.round((start - now) / (1000 * 3600 * 24));
+        const daysFromNow = Math.round((this.dates.getStartOfDay(beginning) -
+            this.dates.getStartOfDay(end)) /
+            (1000 * 3600 * 24));
         if (daysFromNow === -1) {
             prefix = yesterday;
             startDateAndTime = 'yesterday';
@@ -59,15 +61,17 @@ const durationUtil = {
         else if (daysFromNow > 1) {
             prefix = future;
             startDateAndTime =
-                this.dates.format(start, 'MMM do') + ` (in ${daysFromNow} days)`;
+                this.dates.format(beginning, 'MMM do') +
+                    ` (in ${daysFromNow} days)`;
         }
         else if (daysFromNow < -1) {
             prefix = past;
             startDateAndTime =
-                this.dates.format(start, 'MMM do') +
+                this.dates.format(beginning, 'MMM do') +
                     ` (${daysFromNow * -1} days ago)`;
         }
-        startDateAndTime += ` @ ${this.dates.format(start, 'h:mmaaa')}`.replace(':00', '');
+        startDateAndTime +=
+            ` @ ${this.dates.format(beginning, 'h:mmaaa')}`.replace(':00', '');
         return optionallUcFirst(`${prefix ? `${prefix} ` : ''}${startDateAndTime}`, shouldCapitalize);
     },
     renderTimeRange(date1, date2) {

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "40.0.139",
+  "version": "40.1.0",
   "files": [
     "build/**/*",
     "!build/__tests__",