@dereekb/date 10.1.30 → 10.2.0

package/index.esm.js

@@ -1,5 +1,5 @@
-import { MS_IN_HOUR, MS_IN_MINUTE, MINUTES_IN_DAY, isISO8601DateString, filterMaybeValues, asArray, dayOfWeek, sortNumbersAscendingFunction, SORT_VALUE_LESS_THAN, SORT_VALUE_GREATER_THAN, SORT_VALUE_EQUAL, copyArray, compareFnOrder, groupValues, daysOfWeekArray, MS_IN_DAY, minutesToFractionalHours, safeCompareEquality, UTC_TIMEZONE_STRING, isSameNonNullValue, isConsideredUtcTimezoneString, parseISO8601DayStringToUTCDate, cachedGetter, replaceStringsFunction, mapIdentityFunction, repeatString, startOfDayForUTCDateInUTC, sortAscendingIndexNumberRefFunction, range, pushArrayItemsIntoArray, sumOfIntegersBetween, makeValuesGroupMap, lastValue, asGetter, indexRangeCheckFunction, mergeFilterFunctions, isDate as isDate$2, HOURS_IN_DAY, getNextDay, enabledDaysFromDaysOfWeek, daysOfWeekFromEnabledDays, firstValueFromIterable, forEachInIterable, addToSet, iterablesAreSetEquivalent, invertFilter, HashSet, DATE_NOW_VALUE, roundNumberUpToStep, protectedFactory, MS_IN_SECOND, TimeAM, isLogicalDateStringCode as isLogicalDateStringCode$1, dateFromLogicalDate as dateFromLogicalDate$1, flattenArray, splitJoinRemainder } from '@dereekb/util';
-import { isDate as isDate$1, startOfMinute, isValid, parseISO, min as min$5, max as max$2, isAfter as isAfter$1, isBefore as isBefore$1, isEqual, isSameDay, isPast, addDays, set as set$1, differenceInDays, startOfMonth, endOfWeek, startOfWeek, endOfMonth, addHours, addMinutes, addMilliseconds, startOfDay, addMonths, addWeeks, endOfDay, endOfHour, startOfHour, endOfMinute, minutesToHours, formatDistanceStrict, formatDistance, format as format$1, differenceInMinutes, formatDistanceToNow, parse, getMinutes, getSeconds, getMilliseconds, differenceInMilliseconds, differenceInHours, getWeek, getYear, setWeek, getDay, addSeconds } from 'date-fns';
+import { MS_IN_HOUR, MS_IN_MINUTE, MINUTES_IN_DAY, isISO8601DateString, filterMaybeValues, asArray, dayOfWeek, sortNumbersAscendingFunction, MS_IN_SECOND, SORT_VALUE_LESS_THAN, SORT_VALUE_GREATER_THAN, SORT_VALUE_EQUAL, copyArray, compareFnOrder, groupValues, daysOfWeekArray, MS_IN_DAY, minutesToFractionalHours, safeCompareEquality, DATE_NOW_VALUE, mapIdentityFunction, UTC_TIMEZONE_STRING, isSameNonNullValue, isConsideredUtcTimezoneString, cachedGetter, parseISO8601DayStringToUTCDate, replaceStringsFunction, repeatString, isEqualDate, startOfDayForUTCDateInUTC, sortAscendingIndexNumberRefFunction, range, pushArrayItemsIntoArray, sumOfIntegersBetween, makeValuesGroupMap, lastValue, asGetter, indexRangeCheckFunction, mergeFilterFunctions, isDate as isDate$2, HOURS_IN_DAY, getNextDay, enabledDaysFromDaysOfWeek, daysOfWeekFromEnabledDays, firstValueFromIterable, forEachInIterable, addToSet, iterablesAreSetEquivalent, invertFilter, HashSet, roundNumberUpToStep, protectedFactory, TimeAM, isLogicalDateStringCode as isLogicalDateStringCode$1, dateFromLogicalDate as dateFromLogicalDate$1, flattenArray, splitJoinRemainder } from '@dereekb/util';
+import { isDate as isDate$1, startOfMinute, isValid, parseISO, min as min$5, max as max$2, isAfter as isAfter$1, isBefore as isBefore$1, isEqual, isSameDay, isPast, addDays, set as set$1, differenceInDays, startOfMonth, endOfWeek, startOfWeek, endOfMonth, addHours, addMinutes, addMilliseconds, startOfDay, addMonths, addWeeks, endOfDay, endOfHour, startOfHour, endOfMinute, millisecondsToHours, millisecondsToMinutes, differenceInHours, formatDistanceStrict, formatDistance, format as format$1, differenceInMinutes, formatDistanceToNow, parse, getMinutes, getSeconds, getMilliseconds, differenceInMilliseconds, getWeek, getYear, setWeek, getDay, addSeconds } from 'date-fns';
 import { Expose, Type, Exclude } from 'class-transformer';
 import { IsDate, IsEnum, IsOptional, IsNumber, Min, registerDecorator, buildMessage, IsString, Matches, IsArray, IsBoolean } from 'class-validator';
 import { utcToZonedTime, format, formatInTimeZone } from 'date-fns-tz';
@@ -2031,6 +2031,8 @@ function utcDayForDate(date) {
  * 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.
+ *
+ * @deprecated Fails in the rare case where it is the first two hours of a day in a daylight savings zone when daylight savings changes.
  */
 function takeNextUpcomingTime(date, roundDownToMinute) {
   date = copyHoursAndMinutesFromDateToToday(date, roundDownToMinute);
@@ -2042,6 +2044,8 @@ function takeNextUpcomingTime(date, roundDownToMinute) {
 
 /**
  * Creates a new date and copies the hours/minutes from the previous date and applies them to a date for today.
+ *
+ * @deprecated Fails in the rare case where it is the first two hours of a day in a daylight savings zone when daylight savings changes.
  */
 function copyHoursAndMinutesFromDateToToday(fromDate, roundDownToMinute) {
   return copyHoursAndMinutesFromDate(new Date(), fromDate, roundDownToMinute);
@@ -2049,6 +2053,8 @@ function copyHoursAndMinutesFromDateToToday(fromDate, roundDownToMinute) {
 
 /**
  * Copies the hours/minutes from now to the target date.
+ *
+ * @deprecated Fails in the rare case where it is the first two hours of a day in a daylight savings zone when daylight savings changes.
  */
 function copyHoursAndMinutesFromNow(target, roundDownToMinute) {
   return copyHoursAndMinutesFromDate(target, new Date(), roundDownToMinute);
@@ -2056,6 +2062,8 @@ function copyHoursAndMinutesFromNow(target, roundDownToMinute) {
 
 /**
  * Creates a new date and copies the hours/minutes from the input date to the target date.
+ *
+ * @deprecated Fails in the rare case where it is the first two hours of a day in a daylight savings zone when daylight savings changes.
  */
 function copyHoursAndMinutesFromDate(target, fromDate, roundDownToMinute) {
   return copyHoursAndMinutesToDate({
@@ -2098,23 +2106,59 @@ const copyHoursAndMinutesToToday = copyHoursAndMinutesToDate;
  * Removes the seconds and milliseconds from the input date, or returns the current date with no seconds or milliseconds.
  */
 function roundDownToMinute(date = new Date()) {
-  return set$1(date, {
-    seconds: 0,
-    milliseconds: 0
-  });
+  return roundDateDownTo(date, 'minute');
+}
+
+/**
+ * Removes the minutes, seconds and milliseconds from the input date, or returns the current date with no mkinutes, seconds or milliseconds.
+ */
+function roundDownToHour(date = new Date()) {
+  return roundDateDownTo(date, 'hour');
+}
+function roundDateDownTo(date, roundToUnit) {
+  return roundDateToDate(date, roundToUnit, 'floor');
+}
+function roundDateTo(date, roundToUnit, roundType = 'floor') {
+  return typeof date === 'number' ? roundDateToUnixDateTimeNumber(date, roundToUnit, roundType) : roundDateTo(date, roundToUnit, roundType);
+}
+function roundDateToDate(date, roundToUnit, roundType = 'floor') {
+  return new Date(roundDateToUnixDateTimeNumber(date, roundToUnit, roundType));
 }
 
 /**
- * Removes all minutes,
+ * Rounds the input Date value down to the nearest hour, minute, or second.
+ *
  * @param date
+ * @param roundToUnit
+ * @param roundType
  * @returns
  */
-function roundDownToHour(date) {
-  return set$1(date, {
-    minutes: 0,
-    seconds: 0,
-    milliseconds: 0
-  });
+function roundDateToUnixDateTimeNumber(date, roundToUnit, roundType = 'floor') {
+  const inputTimeUnrounded = typeof date === 'number' ? date : date.getTime();
+  let roundAmount = 0;
+  switch (roundToUnit) {
+    case 'hour':
+      roundAmount = MS_IN_HOUR;
+      break;
+    case 'second':
+      roundAmount = MS_IN_SECOND;
+      break;
+    default:
+    case 'minute':
+      roundAmount = MS_IN_MINUTE;
+      break;
+  }
+  const secondsAndMs = inputTimeUnrounded % roundAmount; // determine the number of seconds and milliseconds (prepare to round to nearest minute)
+  let roundedTime = inputTimeUnrounded;
+  if (secondsAndMs !== 0) {
+    roundedTime = inputTimeUnrounded - secondsAndMs; // remove seconds and ms as it will throw off the final tzOffset
+
+    if (roundType === 'ceil') {
+      roundedTime += roundAmount; // round up by adding the units
+    }
+  }
+
+  return roundedTime;
 }
 function reduceDatesFunction(reduceDates) {
   return inputDates => {
@@ -3012,6 +3056,70 @@ function isSameDurationSpan(a, b) {
   return safeCompareEquality(a, b, (a, b) => a.duration === b.duration && isSameDate(a.startsAt, b.startsAt));
 }
 
+const DATE_TODAY_START_VALUE = 'today_start';
+const DATE_TODAY_END_VALUE = 'today_end';
+const DATE_WEEK_START_VALUE = 'this_week_start';
+const DATE_WEEK_END_VALUE = 'this_week_end';
+
+/**
+ * A date that is characterized by either a known string value, or a Date.
+ */
+
+function logicalDateStringCodeDateFactory(logicalDateStringCode) {
+  let mapFn;
+  switch (logicalDateStringCode.toLocaleLowerCase()) {
+    case DATE_NOW_VALUE:
+      mapFn = mapIdentityFunction();
+      break;
+    case DATE_TODAY_START_VALUE:
+      mapFn = startOfDay;
+      break;
+    case DATE_TODAY_END_VALUE:
+      mapFn = endOfDay;
+      break;
+    case DATE_WEEK_START_VALUE:
+      mapFn = startOfWeek;
+      break;
+    case DATE_WEEK_END_VALUE:
+      mapFn = endOfWeek;
+      break;
+    default:
+      throw new Error(`Unknown logical date string "${logicalDateStringCode}"`);
+  }
+  return (now = new Date()) => mapFn(now);
+}
+
+/**
+ * Returns a Date value from the input LogicalDate.
+ *
+ * @param logicalDate
+ */
+
+function dateFromLogicalDate(logicalDate, now = new Date()) {
+  let result;
+  if (typeof logicalDate === 'string') {
+    result = logicalDateStringCodeDateFactory(logicalDate)(now);
+  } else {
+    result = logicalDate;
+  }
+  return result;
+}
+function isLogicalDateStringCode(logicalDate) {
+  let isLogicalDateStringCode = false;
+  if (typeof logicalDate === 'string') {
+    switch (logicalDate.toLocaleLowerCase()) {
+      case DATE_NOW_VALUE:
+      case DATE_TODAY_START_VALUE:
+      case DATE_TODAY_END_VALUE:
+      case DATE_WEEK_START_VALUE:
+      case DATE_WEEK_END_VALUE:
+        isLogicalDateStringCode = true;
+        break;
+    }
+  }
+  return isLogicalDateStringCode;
+}
+
 /**
  * Inherited from the RRule library where RRule only deals with UTC date/times, dates going into it must always be in UTC.
  *
@@ -3069,7 +3177,8 @@ function isSameDateTimezoneConversionConfig(a, b) {
  * @returns
  */
 function getCurrentSystemOffsetInMs(date) {
-  return minutesToMs(getCurrentSystemOffsetInMinutes(date));
+  const systemTimezone = requireCurrentTimezone();
+  return calculateTimezoneOffset(systemTimezone, date);
 }
 
 /**
@@ -3079,22 +3188,27 @@ function getCurrentSystemOffsetInMs(date) {
  * @returns
  */
 function getCurrentSystemOffsetInHours(date) {
-  return minutesToHours(getCurrentSystemOffsetInMinutes(date));
+  return millisecondsToHours(getCurrentSystemOffsetInMs(date));
 }
 
 /**
- * Equivalent to -date.getTimezoneOffset().
+ * Returns the system offset for the input date, in minutes.
+ *
+ * The offset corresponds positively with the UTC offset, so UTC-6 is negative 6 hours, in milliseconds.
  *
  * @param date
  * @returns
  */
 function getCurrentSystemOffsetInMinutes(date) {
-  return -date.getTimezoneOffset();
+  return millisecondsToMinutes(getCurrentSystemOffsetInMs(date));
 }
 
 /**
  * Returns the timezone offset in milliseconds.
  *
+ * This is preferential to Date.getTimezoneOffset() or date-fns's getTimezoneOffset() as those are currently wrong for the first
+ * two hours when daylight savings changes.
+ *
  * I.E. GMT-5 = -5 hours (in milliseconds)
  *
  * @param timezone
@@ -3109,14 +3223,20 @@ function calculateTimezoneOffset(timezone, date) {
   const tzOffset = getTimezoneOffset(timezone, date);
   */
 
-  // WORKAROUND: This is the current workaround. Performance hit seems negligible for all UI use cases.
-  const zoneDate = utcToZonedTime(date, timezone);
+  /*
+   * WORKAROUND: This is the current workaround. Performance hit seems negligible for all UI use cases.
+   */
+
+  // inputTimeDate.setSeconds(0);         // NOTE: setting seconds/milliseconds during the daylight savings epoch will also remove an hour
+  // inputTimeDate.setMilliseconds(0);    // do not clear seconds in this way.
+
+  const inputTimeUnrounded = date.getTime();
+  const secondsAndMs = inputTimeUnrounded % MS_IN_MINUTE; // determine the number of seconds and milliseconds (prepare to round to nearest minute)
+  const inputTime = inputTimeUnrounded - secondsAndMs; // remove seconds and ms as it will throw off the final tzOffset
+
+  const zoneDate = utcToZonedTime(inputTime, timezone);
   const zoneDateStr = format(zoneDate, 'yyyy-MM-dd HH:mm'); // ignore seconds, etc.
   const zoneDateTime = new Date(zoneDateStr + 'Z').getTime();
-  const inputTime = set$1(date, {
-    seconds: 0,
-    milliseconds: 0
-  }).getTime();
   const tzOffset = zoneDateTime - inputTime;
   return tzOffset;
 }
@@ -3179,6 +3299,7 @@ class DateTimezoneUtcNormalInstance {
     this.config = void 0;
     this.hasConversion = void 0;
     this._getOffset = void 0;
+    this._setOnDate = cachedGetter(() => setOnDateWithTimezoneNormalFunction(this));
     let getOffsetInMsFn;
     function useTimezone(timezone) {
       getOffsetInMsFn = date => calculateTimezoneOffset(timezone, date);
@@ -3249,11 +3370,47 @@ class DateTimezoneUtcNormalInstance {
     }
     this.hasConversion = hasConversion;
   }
-  _computeOffsetDate(date, from, to) {
+  convertDate(date, from, to) {
     return addMilliseconds(date, this._getOffset(date, from, to));
   }
 
+  /**
+   * A "safer" conversion that will return a "mirrored" offset. Only functional with a "to" UTC value.
+   *
+   * This is required in cases where "reverse" offset will be used and must be consistent so they reverse in both directions the same amount compared to the base.
+   *
+   * For example, when daylight savings changed on November 3, 2024 the offset returned was 5 but to get back to the original an offset of 6 was required.
+   * This is where some contextual data was not being used. This function uses that contextual data to make sure the reverse will be consistent.
+   *
+   * @param baseDate The base date. Should have been derived from the originalContextDate using the convertDate() function
+   * @param originalContextDate Original date used to derive the baseDate.
+   * @param fromOrTo the "type" of date the originalContextDate is
+   */
+  safeMirroredConvertDate(baseDate, originalContextDate, contextType, safeConvert = true) {
+    if (contextType === 'base') {
+      return {
+        date: baseDate,
+        daylightSavingsOffset: 0
+      };
+    } else {
+      const reverseConversion = this.convertDate(baseDate, contextType, 'base');
+
+      // in some cases where daylight savings ends (november 3rd),
+      // the input startsAt time will not be properly recovered due to loss of timezone information
+      // (cannot determine whether or not to apply the -5 or -6 offset after daylight savings ends)
+      const daylightSavingsOffset = safeConvert ? differenceInHours(originalContextDate, reverseConversion) : 0;
+      const date = daylightSavingsOffset ? addHours(reverseConversion, daylightSavingsOffset) : reverseConversion;
+      return {
+        date,
+        daylightSavingsOffset
+      };
+    }
+  }
+
   // MARK: DateTimezoneBaseDateConverter
+  get setOnDate() {
+    return this._setOnDate();
+  }
   getCurrentOffset(date, from, to) {
     return this._getOffset(date, from, to);
   }
@@ -3267,22 +3424,22 @@ class DateTimezoneUtcNormalInstance {
     return transformDateRangeToTimezoneFunction(this, transformType);
   }
   targetDateToBaseDate(date) {
-    return this._computeOffsetDate(date, 'target', 'base');
+    return this.convertDate(date, 'target', 'base');
   }
   baseDateToTargetDate(date) {
-    return this._computeOffsetDate(date, 'base', 'target');
+    return this.convertDate(date, 'base', 'target');
   }
   baseDateToSystemDate(date) {
-    return this._computeOffsetDate(date, 'base', 'system');
+    return this.convertDate(date, 'base', 'system');
   }
   systemDateToBaseDate(date) {
-    return this._computeOffsetDate(date, 'system', 'base');
+    return this.convertDate(date, 'system', 'base');
   }
   targetDateToSystemDate(date) {
-    return this._computeOffsetDate(date, 'target', 'system');
+    return this.convertDate(date, 'target', 'system');
   }
   systemDateToTargetDate(date) {
-    return this._computeOffsetDate(date, 'system', 'target');
+    return this.convertDate(date, 'system', 'target');
   }
   getOffset(date, transform) {
     return this[`${transform}Offset`](date);
@@ -3311,6 +3468,9 @@ class DateTimezoneUtcNormalInstance {
   systemDateToTargetDateOffset(date) {
     return this._getOffset(date, 'system', 'target');
   }
+  conversionOffset(date, from, to) {
+    return this._getOffset(date, from, to);
+  }
   calculateAllOffsets(date, map) {
     return calculateAllConversions(date, this, map);
   }
@@ -3558,6 +3718,90 @@ function startOfDayInTimezoneFromISO8601DayString(day, timezone) {
   return startOfDayInTimezoneDayStringFactory(timezone)(day);
 }
 
+// MARK: Set
+
+/**
+ * Sets the input values on the input date.
+ */
+
+/**
+ * Creates a new SetONDateFunction using the input
+ */
+function setOnDateWithTimezoneNormalFunction(timezone) {
+  const timezoneInstance = dateTimezoneUtcNormal(timezone);
+  const fn = input => {
+    var _copyFrom, _copyFrom2;
+    const {
+      date: inputDate,
+      copyFrom: copyFromInput,
+      copyHours,
+      copyMinutes,
+      inputType: inputInputType,
+      outputType,
+      hours: inputHours,
+      minutes: inputMinutes,
+      roundDownToMinute
+    } = input;
+    const DEFAULT_TYPE = 'target';
+    const inputType = inputInputType != null ? inputInputType : DEFAULT_TYPE;
+    let baseDate;
+    let copyFrom;
+
+    // set copyFrom
+    if (copyFromInput != null) {
+      copyFrom = dateFromLogicalDate(copyFromInput); // read the logical date and set initial value
+
+      // if the input matches the copyFrom values, then skip conversion
+      // this step is also crucial for returning the correct value for daylight savings ending changes
+      if (inputDate != null && isSameDate(copyFrom, inputDate) && copyHours !== false && copyMinutes !== false) {
+        return roundDownToMinute ? roundDateDownTo(inputDate, 'minute') : inputDate;
+      }
+      if (inputType !== 'base') {
+        copyFrom = copyFrom != null ? timezoneInstance.convertDate(copyFrom, 'base', inputType) : undefined;
+      }
+    }
+
+    // set baseDate
+    if (inputDate != null) {
+      if (inputType === 'base') {
+        // use dates directly as UTC
+        baseDate = inputDate;
+      } else {
+        baseDate = timezoneInstance.convertDate(inputDate, 'base', inputType);
+      }
+    } else {
+      baseDate = new Date();
+    }
+    const hours = inputHours != null ? inputHours : copyHours !== false ? (_copyFrom = copyFrom) == null ? void 0 : _copyFrom.getUTCHours() : undefined;
+    const minutes = inputMinutes != null ? inputMinutes : copyMinutes !== false ? (_copyFrom2 = copyFrom) == null ? void 0 : _copyFrom2.getUTCMinutes() : undefined;
+
+    // NOTE: We do the math this way to avoid issues surrounding daylight savings
+    const time = baseDate.getTime();
+    const currentDayMillseconds = time % MS_IN_DAY;
+    const minutesSecondsAndMillseconds = currentDayMillseconds % MS_IN_HOUR;
+    const hoursInTimeInMs = currentDayMillseconds - minutesSecondsAndMillseconds;
+    const secondsAndMilliseconds = minutesSecondsAndMillseconds % MS_IN_MINUTE;
+    const minutesInTime = minutesSecondsAndMillseconds - secondsAndMilliseconds;
+    const nextDay = time - currentDayMillseconds;
+    const nextMinutes = minutes != null ? minutes * MS_IN_MINUTE : minutesInTime;
+    const nextHours = hours != null ? hours * MS_IN_HOUR : hoursInTimeInMs;
+    const nextTime = nextDay + nextHours + nextMinutes + (roundDownToMinute ? 0 : secondsAndMilliseconds);
+    const nextBaseDate = new Date(nextTime);
+    let result = timezoneInstance.convertDate(nextBaseDate, outputType != null ? outputType : inputType, 'base');
+
+    // one more test to limit the "range" of the change
+    // if it is over 1 day, then we can infer there is a timezone mismatch issue. It only occurs in one direction here, so we can safely
+    // infer that the real valid result can be derived by subtracting one day
+    const inputToResultDifferenceInHours = inputDate != null ? differenceInHours(result, inputDate) : 0;
+    if (inputToResultDifferenceInHours >= 24) {
+      result = addHours(result, -24);
+    }
+    return result;
+  };
+  fn._timezoneInstance = timezoneInstance;
+  return fn;
+}
+
 // MARK: Timezone Utilities
 /**
  * Convenience function for calling copyHoursAndMinutesFromDatesWithTimezoneNormal() with now.
@@ -3567,11 +3811,11 @@ function startOfDayInTimezoneFromISO8601DayString(day, timezone) {
  * @returns
  */
 function copyHoursAndMinutesFromNowWithTimezoneNormal(input, timezone) {
-  return copyHoursAndMinutesFromDateWithTimezoneNormal(input, new Date(), timezone);
+  return copyHoursAndMinutesFromDateWithTimezoneNormal(input, 'now', timezone);
 }
 
 /**
- * Converts the two input dates, which are dates in the same timezone/normal but than the current system, using the input DateTimezoneUtcNormalFunctionInput.
+ * Converts the two input dates, which are dates in the same timezone/normal instead of the current system, using the input DateTimezoneUtcNormalFunctionInput.
  *
  * This converts the dates to the system timezone normal, copies the values, then back to the original timezone normal.
  *
@@ -3581,17 +3825,13 @@ function copyHoursAndMinutesFromNowWithTimezoneNormal(input, timezone) {
  */
 function copyHoursAndMinutesFromDateWithTimezoneNormal(input, copyFrom, timezone) {
   const timezoneInstance = dateTimezoneUtcNormal(timezone);
-  const inputInSystemTimezone = timezoneInstance.systemDateToTargetDate(input);
-  const copyFromInSystemTimezone = timezoneInstance.systemDateToTargetDate(copyFrom);
-
-  // handle the potential system date time offset when the system's timezone offset changes between dates...
-  const inputInSystemTimezoneOffset = inputInSystemTimezone.getTimezoneOffset();
-  const copyFromInSystemTimezoneOffset = copyFromInSystemTimezone.getTimezoneOffset();
-  const offsetDifference = inputInSystemTimezoneOffset - copyFromInSystemTimezoneOffset;
-
-  // copy the minutes then add the offset difference to get the appropriate time.
-  const copiedInSystemTimezone = addMinutes(copyHoursAndMinutesFromDate(inputInSystemTimezone, copyFromInSystemTimezone), offsetDifference);
-  const result = timezoneInstance.targetDateToSystemDate(copiedInSystemTimezone);
+  const result = timezoneInstance.setOnDate({
+    date: input,
+    copyFrom,
+    inputType: 'target',
+    copyHours: true,
+    copyMinutes: true
+  });
   return result;
 }
 
@@ -4827,7 +5067,8 @@ function dateCellTiming(durationInput, rangeInput, timezoneInput) {
   } = durationInput;
 
   // it is important that startsAt is evaluated the base time normal so we can avoid daylight savings issues
-  let startsAtInUtc = normalInstance.baseDateToTargetDate(inputStartsAt);
+  const startsAtInUtcInitial = normalInstance.baseDateToTargetDate(inputStartsAt);
+  let startsAtInUtc = startsAtInUtcInitial;
   let numberOfDayBlocks;
   let hasRangeFromInput = false;
   let rangeInUtc;
@@ -4869,13 +5110,21 @@ function dateCellTiming(durationInput, rangeInput, timezoneInput) {
     startsAtInUtc = roundDownToMinute(startsAtInUtc); // clear seconds and milliseconds from startsAt
   }
 
-  const lastStartsAtInBaseTimezone = addHours(startsAtInUtc, numberOfDayBlocks * 24); // use addDays so the system (if it experiences daylight savings) can account for change for daylight savings
-
-  // calculate end to be the ending date/time of the final duration span
-  const end = addMinutes(normalInstance.targetDateToBaseDate(lastStartsAtInBaseTimezone), duration);
   const utcDay = formatToISO8601DayStringForUTC(startsAtInUtc);
   const start = normalInstance.startOfDayInTargetTimezone(utcDay);
-  const startsAt = normalInstance.targetDateToBaseDate(startsAtInUtc);
+  const safeMirror = isEqualDate(startsAtInUtc, startsAtInUtcInitial);
+  const {
+    date: startsAt,
+    daylightSavingsOffset
+  } = normalInstance.safeMirroredConvertDate(startsAtInUtc, inputStartsAt, 'target', safeMirror);
+
+  // calculate end to be the ending date/time of the final duration span
+  const lastStartsAtInBaseTimezone = addHours(startsAtInUtc, numberOfDayBlocks * 24 + daylightSavingsOffset); // use addHours instead of addDays, since addDays will take into account a daylight savings change if the system time changes
+  const lastStartInTarget = normalInstance.targetDateToBaseDate(lastStartsAtInBaseTimezone);
+  const end = addMinutes(lastStartInTarget, duration);
+
+  // console.log({ lastStartsAtInBaseTimezone, inputStartsAt, startsAtInUtcInitial, startsAtInUtc, startsAt, daylightSavingsOffset, start, lastStartInTarget, end });
+
   return {
     start,
     end,
@@ -5181,11 +5430,25 @@ function calculateExpectedDateCellTimingDurationPair(timing) {
     timezone
   } = timing;
   const normalInstance = dateTimezoneUtcNormal(timezone);
-  const startsAtInUtcNormal = normalInstance.baseDateToTargetDate(startsAt); // convert to UTC normal
-  const endInUtcNormal = normalInstance.baseDateToTargetDate(end);
+  let startsAtInUtcNormal = normalInstance.baseDateToTargetDate(startsAt); // convert to UTC normal
+  let endInUtcNormal = normalInstance.baseDateToTargetDate(end);
+  const {
+    daylightSavingsOffset: startDaylightSavingsOffset
+  } = normalInstance.safeMirroredConvertDate(startsAtInUtcNormal, startsAt, 'target');
+  const {
+    daylightSavingsOffset: endDaylightSavingsOffset
+  } = normalInstance.safeMirroredConvertDate(endInUtcNormal, end, 'target');
+  if (startDaylightSavingsOffset) {
+    startsAtInUtcNormal = addHours(startsAtInUtcNormal, startDaylightSavingsOffset);
+  }
+  if (endDaylightSavingsOffset) {
+    endInUtcNormal = addHours(endInUtcNormal, endDaylightSavingsOffset);
+  }
   const finalMsDifferenceBetweenStartAndEnd = differenceInMilliseconds(endInUtcNormal, startsAtInUtcNormal);
   const duration = finalMsDifferenceBetweenStartAndEnd / MS_IN_MINUTE % MINUTES_IN_DAY || MINUTES_IN_DAY;
-  const expectedFinalStartsAt = normalInstance.targetDateToBaseDate(addMinutes(endInUtcNormal, -duration));
+  const expectedFinalStartsAtUtc = addMinutes(endInUtcNormal, -duration);
+  const expectedFinalStartsAt = normalInstance.targetDateToBaseDate(expectedFinalStartsAtUtc); // 2024-11-03T03:00:00.000Z
+
   return {
     duration,
     expectedFinalStartsAt
@@ -8375,70 +8638,6 @@ class DateSet extends HashSet {
   }
 }
 
-const DATE_TODAY_START_VALUE = 'today_start';
-const DATE_TODAY_END_VALUE = 'today_end';
-const DATE_WEEK_START_VALUE = 'this_week_start';
-const DATE_WEEK_END_VALUE = 'this_week_end';
-
-/**
- * A date that is characterized by either a known string value, or a Date.
- */
-
-function logicalDateStringCodeDateFactory(logicalDateStringCode) {
-  let mapFn;
-  switch (logicalDateStringCode.toLocaleLowerCase()) {
-    case DATE_NOW_VALUE:
-      mapFn = mapIdentityFunction();
-      break;
-    case DATE_TODAY_START_VALUE:
-      mapFn = startOfDay;
-      break;
-    case DATE_TODAY_END_VALUE:
-      mapFn = endOfDay;
-      break;
-    case DATE_WEEK_START_VALUE:
-      mapFn = startOfWeek;
-      break;
-    case DATE_WEEK_END_VALUE:
-      mapFn = endOfWeek;
-      break;
-    default:
-      throw new Error(`Unknown logical date string "${logicalDateStringCode}"`);
-  }
-  return (now = new Date()) => mapFn(now);
-}
-
-/**
- * Returns a Date value from the input LogicalDate.
- *
- * @param logicalDate
- */
-
-function dateFromLogicalDate(logicalDate, now = new Date()) {
-  let result;
-  if (typeof logicalDate === 'string') {
-    result = logicalDateStringCodeDateFactory(logicalDate)(now);
-  } else {
-    result = logicalDate;
-  }
-  return result;
-}
-function isLogicalDateStringCode(logicalDate) {
-  let isLogicalDateStringCode = false;
-  if (typeof logicalDate === 'string') {
-    switch (logicalDate.toLocaleLowerCase()) {
-      case DATE_NOW_VALUE:
-      case DATE_TODAY_START_VALUE:
-      case DATE_TODAY_END_VALUE:
-      case DATE_WEEK_START_VALUE:
-      case DATE_WEEK_END_VALUE:
-        isLogicalDateStringCode = true;
-        break;
-    }
-  }
-  return isLogicalDateStringCode;
-}
-
 // MARK: ISO8601DayStringRange
 
 // MARK: DateOrDayStringRange
@@ -10527,4 +10726,4 @@ class ModelRecurrenceInfoUtility {
   }
 }
 
-export { AnyIterResult, CalendarDate, CalendarDateType, DATE_CELL_SCHEDULE_ENCODED_WEEK_REGEX, DATE_TODAY_END_VALUE, DATE_TODAY_START_VALUE, DATE_WEEK_END_VALUE, DATE_WEEK_START_VALUE, DEFAULT_EXPAND_DAYS_FOR_DATE_RANGE_MAX_EXPANSION_SIZE, DEFAULT_FULL_DATE_SCHEDULE_RANGE_DURATION, DEFAULT_ITERATE_DAYS_IN_DATE_RANGE_MAX_ITERATIONS, DEFAULT_LAST_ITER_RESULT_MAX_ITERATIONS_ALLOWED, DateCell, DateCellRange, DateCellSchedule, DateCellScheduleDayCode, DateCellTiming, DateDurationSpan, DateRRule, DateRRuleInstance, DateRRuleParseUtility, DateRRuleUtility, DateRange, DateRangeParams, DateRangeType, DateSet, DateTimeMinuteInstance, DateTimeUtilityInstance, DateTimezoneUtcNormalInstance, IsKnownTimezone, IsValidDateCellRange, IsValidDateCellRangeSeries, IsValidDateCellTiming, IterateDaysInDateRangeFunctionBailError, LastIterResult, LimitDateTimeInstance, MAX_FUTURE_DATE, ModelRecurrenceInfo, ModelRecurrenceInfoUtility, NextIterResult, RRuleStringSplitter, SYSTEM_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, UNKNOWN_YEAR_WEEK_CODE, UTC_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, allIndexesInDateCellRange, allIndexesInDateCellRanges, allIndexesInDateCellRangesToArray, allKnownTimezoneStrings, allTimezoneInfos, allTimezoneStrings, anyHaveExpired, atleastOneNotExpired, baseDateToTargetDate, calculateAllConversions, calculateExpectedDateCellTimingDuration, calculateExpectedDateCellTimingDurationPair, calculateTimezoneOffset, calendarDate, calendarDateFactory, calendarDateForDateDurationSpan, changeDateCellScheduleDateRangeToTimezone, changeDateCellScheduleDateRangeToTimezoneFunction, clampDateFunction, clampDateRangeFunction, clampDateRangeToDateRange, clampDateToDateRange, copyDateCellScheduleDateFilterConfig, copyHoursAndMinutesFromDate, copyHoursAndMinutesFromDateToToday, copyHoursAndMinutesFromDateWithTimezoneNormal, copyHoursAndMinutesFromNow, copyHoursAndMinutesFromNowWithTimezoneNormal, copyHoursAndMinutesFromUTCDate, copyHoursAndMinutesToDate, copyHoursAndMinutesToToday, dateCell, dateCellDayOfWeekFactory, dateCellDayTimingInfoFactory, dateCellDurationSpanHasEndedFilterFunction, dateCellDurationSpanHasNotEndedFilterFunction, dateCellDurationSpanHasNotStartedFilterFunction, dateCellDurationSpanHasStartedFilterFunction, dateCellEndIndex, dateCellIndexRange, dateCellIndexRangeToDateCellRange, dateCellIndexYearWeekCodeFactory, dateCellIndexYearWeekCodeGroupFactory, dateCellIndexsForDateCellScheduleDayCodes, dateCellRange, dateCellRangeBlocksCount, dateCellRangeBlocksCountInfo, dateCellRangeHasRange, dateCellRangeIncludedByRangeFunction, dateCellRangeOfTiming, dateCellRangeOfTimingFactory, dateCellRangeOverlapsRange, dateCellRangeOverlapsRangeFunction, dateCellRangeToDateCellIndexRange, dateCellRangeWithRange, dateCellRangeWithRangeFromIndex, dateCellRangesFullyCoverDateCellRangeFunction, dateCellScheduleDateCellTimingFilter, dateCellScheduleDateFilter, dateCellScheduleDateRange, dateCellScheduleDayCodeFactory, dateCellScheduleDayCodesAreSetsEquivalent, dateCellScheduleDayCodesFromEnabledDays, dateCellScheduleDayCodesSetFromDaysOfWeek, dateCellScheduleEncodedWeek, dateCellTiming, dateCellTimingCompletedTimeRange, dateCellTimingDateFactory, dateCellTimingDateRange, dateCellTimingEndDateFactory, dateCellTimingEndIndex, dateCellTimingEventRange, dateCellTimingExpansionFactory, dateCellTimingFinalStartsAtEvent, dateCellTimingFromDateCellTimingStartsAtEndRange, dateCellTimingLatestCompletedIndex, dateCellTimingRelativeIndexArrayFactory, dateCellTimingRelativeIndexFactory, dateCellTimingStart, dateCellTimingStartDateFactory, dateCellTimingStartPair, dateCellTimingStartsAtDateFactory, dateCellTimingStartsAtForStartOfDay, dateCellTimingTimezoneNormalInstance, dateDurationSpanEndDate, dateFromDateOrTimeNumber, dateFromLogicalDate, dateInterval, dateMonthDayStringFormat, dateOrDateRangeToDateRange, dateOrDayStringRangeToDateRange, dateOrDayStringRangeToISO8601DayStringRange, dateRange, dateRangeDaysCount, dateRangeFromStartAndEndOfDay, dateRangeOverlapsDateRange, dateRangeOverlapsDateRangeFunction, dateRangeRelativeState, dateRelativeStateForDateCellRangeComparedToIndex, dateShortDateAndTimeStringFormat, dateShortDateStringFormat, dateTimeInstance, dateTimeInstanceUtc, dateTimeMinuteDecisionFunction, dateTimeMinuteWholeDayDecisionFunction, dateTimeStringFormat, dateTimezoneUtcNormal, daysToMinutes, durationSpanDateRelativeState, durationSpanToDateRange, earliestDate, enabledDaysFromDateCellScheduleDayCodes, endItreateDaysInDateRangeEarly, expandDateCellCollection, expandDateCellRange, expandDateCellSchedule, expandDateCellScheduleDayCodes, expandDateCellScheduleDayCodesToDayCodesSet, expandDateCellScheduleDayCodesToDayOfWeekSet, expandDateCellScheduleFactory, expandDateCellScheduleRange, expandDateCellScheduleRangeToDateCellRanges, expandDateCellTiming, expandDaysForDateRange, expandDaysForDateRangeFunction, expandUniqueDateCellsFunction, filterDateCellsInDateCellRange, findMaxDate, findMinDate, findNextDateInDateCellScheduleFilter, fitDateRangeToDayPeriod, fitDateRangeToDayPeriodFunction, fitUTCDateRangeToDayPeriod, forEachDayInDateRange, formatDateDistance, formatDateRange, formatDateRangeDistance, formatDateRangeDistanceFunction, formatDateRangeFunction, formatStartedEndedDistanceString, formatToDateString, formatToDayRangeString, formatToDayTimeRangeString, formatToISO8601DateString, formatToISO8601DayString, formatToISO8601DayStringForSystem, formatToISO8601DayStringForUTC, formatToMonthDayString, formatToShortDateAndTimeString, formatToShortDateString, formatToTimeAndDurationString, formatToTimeRangeString, formatToTimeString, fractionalHoursInDurationSpan, fullDateCellScheduleRange, fullDateCellTiming, fullDateCellTimingTimezonePair, fullWeekDateCellScheduleDayCodes, getCurrentSystemOffsetInHours, getCurrentSystemOffsetInMinutes, getCurrentSystemOffsetInMs, getDateCellTimingFirstEventDateRange, getDateCellTimingHoursInEvent, getDaysOfWeekInDateRange, getExpiration, getGreatestDateCellIndexInDateCellRanges, getLeastAndGreatestDateCellIndexInDateCellRanges, getLeastDateCellIndexInDateCellRanges, getNextDateCellTimingIndex, getRelativeDateForDateCellTiming, getRelativeIndexForDateCellTiming, getTimeAM, getTimezoneAbbreviation, getTimezoneLongName, groupDateRangesByDateRelativeState, groupToDateCellRanges, groupUniqueDateCells, guessCurrentTimezone, hasExpired, hoursToMs, inverseDateTimezoneUtcNormalInstanceTransformType, isAfter, isBefore, isDate, isDateCellRange, isDateCellSchedule, isDateCellScheduleDateRange, isDateCellScheduleEncodedWeek, isDateCellScheduleStartOfDayDateRange, isDateCellTiming, isDateCellTimingRelativeIndexFactory, isDateCellWithinDateCellRange, isDateCellWithinDateCellRangeFunction, isDateInDateRange, isDateInDateRangeFunction, isDateRange, isDateRangeInDateRange, isDateRangeInDateRangeFunction, isDateRangeStart, isDateWithinDateCellRangeFunction, isEmptyDateCellScheduleEncodedWeek, isEndOfDayInUTC, isFullDateCellScheduleDateRange, isFullDateCellTiming, isFullDateRange, isInfiniteDateRange, isKnownTimezone, isLogicalDateStringCode, isMaxFutureDate, isPartialDateRange, isSameDate, isSameDateCellSchedule, isSameDateCellScheduleDateRange, isSameDateCellScheduleEventRange, isSameDateCellTiming, isSameDateCellTimingEventStartsAtEndRange, isSameDateDay, isSameDateDayRange, isSameDateHoursAndMinutes, isSameDateRange, isSameDateTimezoneConversionConfig, isSameDurationSpan, isSameFullDateCellScheduleDateRange, isSameFullDateCellTiming, isStartOfDayForSystem, isStartOfDayInUTC, isValidDateCellIndex, isValidDateCellRange, isValidDateCellRangeSeries, isValidDateCellTiming, isValidDateCellTimingInfo, isValidDateCellTimingStartDate, isValidDateFromTimestringResult, isValidDateTimezoneConversionConfig, isValidFullDateCellTiming, isValidFullDateCellTimingInfo, iterateDaysInDateRange, iterateDaysInDateRangeFunction, latestDate, latestMinute, limitDateTime, limitDateTimeInstance, logicalDateStringCodeDateFactory, makeDateQueryForDateItemRangeFilter, makeDateQueryForDateStartsEndsFilter, makeDateQueryForOccuringFilter, makeDaysAndTimeFiltersFunction, makeMongoDBLikeDateQueryBuilder, maxFutureDate, mergeMongoDBLikeRangeFilters, minutesToMs, modifyDateCellToFitRange, modifyDateCellsToFitRange, modifyDateCellsToFitRangeFunction, msToMinutes, msToSeconds, nowInterval, parseISO8601DayStringToDate, parseJsDateString, parseReadableTimeString, rawDateCellScheduleDayCodes, readDaysOfWeek, readDaysOfWeekNames, readableTimeStringToDate, reduceDatesFunction, requireCurrentTimezone, roundDateTimeDown, roundDateTimeDownToSteps, roundDownToHour, roundDownToMinute, roundToMinuteSteps, safeFormatToISO8601DateString, safeToJsDate, searchTimezoneInfos, shiftDateCellTimingToSystemTimezone, shiftDateCellTimingToTimezone, shiftDateCellTimingToTimezoneFunction, shiftDateCellTimingToUTCTimezone, simplifyDateCellScheduleDayCodes, skipAfterExpiration, skipExpired, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, sortByDateFunction, sortByISO8601DateStringFunction, sortByISO8601DateStrings, sortDateCellRangeAndSizeFunction, sortDateCellRanges, sortDateRangeStartAscendingCompareFunction, startOfDayInTimezoneDayStringFactory, startOfDayInTimezoneFromISO8601DayString, startOfWeekForYearWeekCode, systemBaseDateToNormalDate, systemBaseDateToNormalDateOffset, systemDateTimezoneUtcNormal, systemExperiencesDaylightSavings, systemNormalDateToBaseDate, systemNormalDateToBaseDateOffset, takeAfterTimeElapsedSinceLastEmission, takeNextUpcomingTime, targetDateToBaseDate, timeHasExpired, timezoneInfoForSystem, timezoneStringToSearchableString, timezoneStringToTimezoneInfo, toExpiration, toExpires, toISO8601DayString, toISO8601DayStringForSystem, toISO8601DayStringForUTC, toISODateString, toJsDate, toJsDayDate, toLocalReadableTimeString, toReadableTimeString, transformDateInTimezoneNormalFunction, transformDateRangeDatesFunction, transformDateRangeInTimezoneNormalFunction, transformDateRangeToTimezoneFunction, transformDateRangeWithStartOfDay, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateDateCellTimingToSystemTimezone, updateDateCellTimingToTimezone, updateDateCellTimingToTimezoneFunction, updateDateCellTimingToUTCTimezone, updateDateCellTimingWithDateCellTimingEvent, utcDayForDate, weekdayDateCellScheduleDayCodes, weekendDateCellScheduleDayCodes, yearWeekCode, yearWeekCodeDateFactory, yearWeekCodeDateTimezoneInstance, yearWeekCodeFactory, yearWeekCodeForCalendarMonth, yearWeekCodeForCalendarMonthFactory, yearWeekCodeForDateRange, yearWeekCodeForDateRangeFactory, yearWeekCodeForDateRangeInTimezone, yearWeekCodeFromDate, yearWeekCodeFromPair, yearWeekCodeGroupFactory, yearWeekCodeIndex, yearWeekCodePair, yearWeekCodePairFromDate };
+export { AnyIterResult, CalendarDate, CalendarDateType, DATE_CELL_SCHEDULE_ENCODED_WEEK_REGEX, DATE_TODAY_END_VALUE, DATE_TODAY_START_VALUE, DATE_WEEK_END_VALUE, DATE_WEEK_START_VALUE, DEFAULT_EXPAND_DAYS_FOR_DATE_RANGE_MAX_EXPANSION_SIZE, DEFAULT_FULL_DATE_SCHEDULE_RANGE_DURATION, DEFAULT_ITERATE_DAYS_IN_DATE_RANGE_MAX_ITERATIONS, DEFAULT_LAST_ITER_RESULT_MAX_ITERATIONS_ALLOWED, DateCell, DateCellRange, DateCellSchedule, DateCellScheduleDayCode, DateCellTiming, DateDurationSpan, DateRRule, DateRRuleInstance, DateRRuleParseUtility, DateRRuleUtility, DateRange, DateRangeParams, DateRangeType, DateSet, DateTimeMinuteInstance, DateTimeUtilityInstance, DateTimezoneUtcNormalInstance, IsKnownTimezone, IsValidDateCellRange, IsValidDateCellRangeSeries, IsValidDateCellTiming, IterateDaysInDateRangeFunctionBailError, LastIterResult, LimitDateTimeInstance, MAX_FUTURE_DATE, ModelRecurrenceInfo, ModelRecurrenceInfoUtility, NextIterResult, RRuleStringSplitter, SYSTEM_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, UNKNOWN_YEAR_WEEK_CODE, UTC_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, allIndexesInDateCellRange, allIndexesInDateCellRanges, allIndexesInDateCellRangesToArray, allKnownTimezoneStrings, allTimezoneInfos, allTimezoneStrings, anyHaveExpired, atleastOneNotExpired, baseDateToTargetDate, calculateAllConversions, calculateExpectedDateCellTimingDuration, calculateExpectedDateCellTimingDurationPair, calculateTimezoneOffset, calendarDate, calendarDateFactory, calendarDateForDateDurationSpan, changeDateCellScheduleDateRangeToTimezone, changeDateCellScheduleDateRangeToTimezoneFunction, clampDateFunction, clampDateRangeFunction, clampDateRangeToDateRange, clampDateToDateRange, copyDateCellScheduleDateFilterConfig, copyHoursAndMinutesFromDate, copyHoursAndMinutesFromDateToToday, copyHoursAndMinutesFromDateWithTimezoneNormal, copyHoursAndMinutesFromNow, copyHoursAndMinutesFromNowWithTimezoneNormal, copyHoursAndMinutesFromUTCDate, copyHoursAndMinutesToDate, copyHoursAndMinutesToToday, dateCell, dateCellDayOfWeekFactory, dateCellDayTimingInfoFactory, dateCellDurationSpanHasEndedFilterFunction, dateCellDurationSpanHasNotEndedFilterFunction, dateCellDurationSpanHasNotStartedFilterFunction, dateCellDurationSpanHasStartedFilterFunction, dateCellEndIndex, dateCellIndexRange, dateCellIndexRangeToDateCellRange, dateCellIndexYearWeekCodeFactory, dateCellIndexYearWeekCodeGroupFactory, dateCellIndexsForDateCellScheduleDayCodes, dateCellRange, dateCellRangeBlocksCount, dateCellRangeBlocksCountInfo, dateCellRangeHasRange, dateCellRangeIncludedByRangeFunction, dateCellRangeOfTiming, dateCellRangeOfTimingFactory, dateCellRangeOverlapsRange, dateCellRangeOverlapsRangeFunction, dateCellRangeToDateCellIndexRange, dateCellRangeWithRange, dateCellRangeWithRangeFromIndex, dateCellRangesFullyCoverDateCellRangeFunction, dateCellScheduleDateCellTimingFilter, dateCellScheduleDateFilter, dateCellScheduleDateRange, dateCellScheduleDayCodeFactory, dateCellScheduleDayCodesAreSetsEquivalent, dateCellScheduleDayCodesFromEnabledDays, dateCellScheduleDayCodesSetFromDaysOfWeek, dateCellScheduleEncodedWeek, dateCellTiming, dateCellTimingCompletedTimeRange, dateCellTimingDateFactory, dateCellTimingDateRange, dateCellTimingEndDateFactory, dateCellTimingEndIndex, dateCellTimingEventRange, dateCellTimingExpansionFactory, dateCellTimingFinalStartsAtEvent, dateCellTimingFromDateCellTimingStartsAtEndRange, dateCellTimingLatestCompletedIndex, dateCellTimingRelativeIndexArrayFactory, dateCellTimingRelativeIndexFactory, dateCellTimingStart, dateCellTimingStartDateFactory, dateCellTimingStartPair, dateCellTimingStartsAtDateFactory, dateCellTimingStartsAtForStartOfDay, dateCellTimingTimezoneNormalInstance, dateDurationSpanEndDate, dateFromDateOrTimeNumber, dateFromLogicalDate, dateInterval, dateMonthDayStringFormat, dateOrDateRangeToDateRange, dateOrDayStringRangeToDateRange, dateOrDayStringRangeToISO8601DayStringRange, dateRange, dateRangeDaysCount, dateRangeFromStartAndEndOfDay, dateRangeOverlapsDateRange, dateRangeOverlapsDateRangeFunction, dateRangeRelativeState, dateRelativeStateForDateCellRangeComparedToIndex, dateShortDateAndTimeStringFormat, dateShortDateStringFormat, dateTimeInstance, dateTimeInstanceUtc, dateTimeMinuteDecisionFunction, dateTimeMinuteWholeDayDecisionFunction, dateTimeStringFormat, dateTimezoneUtcNormal, daysToMinutes, durationSpanDateRelativeState, durationSpanToDateRange, earliestDate, enabledDaysFromDateCellScheduleDayCodes, endItreateDaysInDateRangeEarly, expandDateCellCollection, expandDateCellRange, expandDateCellSchedule, expandDateCellScheduleDayCodes, expandDateCellScheduleDayCodesToDayCodesSet, expandDateCellScheduleDayCodesToDayOfWeekSet, expandDateCellScheduleFactory, expandDateCellScheduleRange, expandDateCellScheduleRangeToDateCellRanges, expandDateCellTiming, expandDaysForDateRange, expandDaysForDateRangeFunction, expandUniqueDateCellsFunction, filterDateCellsInDateCellRange, findMaxDate, findMinDate, findNextDateInDateCellScheduleFilter, fitDateRangeToDayPeriod, fitDateRangeToDayPeriodFunction, fitUTCDateRangeToDayPeriod, forEachDayInDateRange, formatDateDistance, formatDateRange, formatDateRangeDistance, formatDateRangeDistanceFunction, formatDateRangeFunction, formatStartedEndedDistanceString, formatToDateString, formatToDayRangeString, formatToDayTimeRangeString, formatToISO8601DateString, formatToISO8601DayString, formatToISO8601DayStringForSystem, formatToISO8601DayStringForUTC, formatToMonthDayString, formatToShortDateAndTimeString, formatToShortDateString, formatToTimeAndDurationString, formatToTimeRangeString, formatToTimeString, fractionalHoursInDurationSpan, fullDateCellScheduleRange, fullDateCellTiming, fullDateCellTimingTimezonePair, fullWeekDateCellScheduleDayCodes, getCurrentSystemOffsetInHours, getCurrentSystemOffsetInMinutes, getCurrentSystemOffsetInMs, getDateCellTimingFirstEventDateRange, getDateCellTimingHoursInEvent, getDaysOfWeekInDateRange, getExpiration, getGreatestDateCellIndexInDateCellRanges, getLeastAndGreatestDateCellIndexInDateCellRanges, getLeastDateCellIndexInDateCellRanges, getNextDateCellTimingIndex, getRelativeDateForDateCellTiming, getRelativeIndexForDateCellTiming, getTimeAM, getTimezoneAbbreviation, getTimezoneLongName, groupDateRangesByDateRelativeState, groupToDateCellRanges, groupUniqueDateCells, guessCurrentTimezone, hasExpired, hoursToMs, inverseDateTimezoneUtcNormalInstanceTransformType, isAfter, isBefore, isDate, isDateCellRange, isDateCellSchedule, isDateCellScheduleDateRange, isDateCellScheduleEncodedWeek, isDateCellScheduleStartOfDayDateRange, isDateCellTiming, isDateCellTimingRelativeIndexFactory, isDateCellWithinDateCellRange, isDateCellWithinDateCellRangeFunction, isDateInDateRange, isDateInDateRangeFunction, isDateRange, isDateRangeInDateRange, isDateRangeInDateRangeFunction, isDateRangeStart, isDateWithinDateCellRangeFunction, isEmptyDateCellScheduleEncodedWeek, isEndOfDayInUTC, isFullDateCellScheduleDateRange, isFullDateCellTiming, isFullDateRange, isInfiniteDateRange, isKnownTimezone, isLogicalDateStringCode, isMaxFutureDate, isPartialDateRange, isSameDate, isSameDateCellSchedule, isSameDateCellScheduleDateRange, isSameDateCellScheduleEventRange, isSameDateCellTiming, isSameDateCellTimingEventStartsAtEndRange, isSameDateDay, isSameDateDayRange, isSameDateHoursAndMinutes, isSameDateRange, isSameDateTimezoneConversionConfig, isSameDurationSpan, isSameFullDateCellScheduleDateRange, isSameFullDateCellTiming, isStartOfDayForSystem, isStartOfDayInUTC, isValidDateCellIndex, isValidDateCellRange, isValidDateCellRangeSeries, isValidDateCellTiming, isValidDateCellTimingInfo, isValidDateCellTimingStartDate, isValidDateFromTimestringResult, isValidDateTimezoneConversionConfig, isValidFullDateCellTiming, isValidFullDateCellTimingInfo, iterateDaysInDateRange, iterateDaysInDateRangeFunction, latestDate, latestMinute, limitDateTime, limitDateTimeInstance, logicalDateStringCodeDateFactory, makeDateQueryForDateItemRangeFilter, makeDateQueryForDateStartsEndsFilter, makeDateQueryForOccuringFilter, makeDaysAndTimeFiltersFunction, makeMongoDBLikeDateQueryBuilder, maxFutureDate, mergeMongoDBLikeRangeFilters, minutesToMs, modifyDateCellToFitRange, modifyDateCellsToFitRange, modifyDateCellsToFitRangeFunction, msToMinutes, msToSeconds, nowInterval, parseISO8601DayStringToDate, parseJsDateString, parseReadableTimeString, rawDateCellScheduleDayCodes, readDaysOfWeek, readDaysOfWeekNames, readableTimeStringToDate, reduceDatesFunction, requireCurrentTimezone, roundDateDownTo, roundDateTimeDown, roundDateTimeDownToSteps, roundDateTo, roundDateToDate, roundDateToUnixDateTimeNumber, roundDownToHour, roundDownToMinute, roundToMinuteSteps, safeFormatToISO8601DateString, safeToJsDate, searchTimezoneInfos, setOnDateWithTimezoneNormalFunction, shiftDateCellTimingToSystemTimezone, shiftDateCellTimingToTimezone, shiftDateCellTimingToTimezoneFunction, shiftDateCellTimingToUTCTimezone, simplifyDateCellScheduleDayCodes, skipAfterExpiration, skipExpired, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, sortByDateFunction, sortByISO8601DateStringFunction, sortByISO8601DateStrings, sortDateCellRangeAndSizeFunction, sortDateCellRanges, sortDateRangeStartAscendingCompareFunction, startOfDayInTimezoneDayStringFactory, startOfDayInTimezoneFromISO8601DayString, startOfWeekForYearWeekCode, systemBaseDateToNormalDate, systemBaseDateToNormalDateOffset, systemDateTimezoneUtcNormal, systemExperiencesDaylightSavings, systemNormalDateToBaseDate, systemNormalDateToBaseDateOffset, takeAfterTimeElapsedSinceLastEmission, takeNextUpcomingTime, targetDateToBaseDate, timeHasExpired, timezoneInfoForSystem, timezoneStringToSearchableString, timezoneStringToTimezoneInfo, toExpiration, toExpires, toISO8601DayString, toISO8601DayStringForSystem, toISO8601DayStringForUTC, toISODateString, toJsDate, toJsDayDate, toLocalReadableTimeString, toReadableTimeString, transformDateInTimezoneNormalFunction, transformDateRangeDatesFunction, transformDateRangeInTimezoneNormalFunction, transformDateRangeToTimezoneFunction, transformDateRangeWithStartOfDay, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateDateCellTimingToSystemTimezone, updateDateCellTimingToTimezone, updateDateCellTimingToTimezoneFunction, updateDateCellTimingToUTCTimezone, updateDateCellTimingWithDateCellTimingEvent, utcDayForDate, weekdayDateCellScheduleDayCodes, weekendDateCellScheduleDayCodes, yearWeekCode, yearWeekCodeDateFactory, yearWeekCodeDateTimezoneInstance, yearWeekCodeFactory, yearWeekCodeForCalendarMonth, yearWeekCodeForCalendarMonthFactory, yearWeekCodeForDateRange, yearWeekCodeForDateRangeFactory, yearWeekCodeForDateRangeInTimezone, yearWeekCodeFromDate, yearWeekCodeFromPair, yearWeekCodeGroupFactory, yearWeekCodeIndex, yearWeekCodePair, yearWeekCodePairFromDate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/date",
-  "version": "10.1.30",
+  "version": "10.2.0",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",