@trackunit/date-and-time-utils 0.0.26 → 0.0.28-alpha-26d41cfe4c9.0

package/index.esm.js

@@ -1,16 +1,40 @@
+import '@formatjs/intl-durationformat/polyfill';
+import { shouldPolyfill, supportedValuesOf } from '@formatjs/intl-enumerator';
 import { Temporal } from '@js-temporal/polyfill';
 
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const Polyfill = require("@formatjs/intl-enumerator");
+/**
+ * converts timZoneId to TimeZone object with default to current user timezone
+ *
+ * @param timeZoneId - The time zone to use for the conversion.
+ * returns A time zone object. { id: string, offset: string, name: string }
+ */
+const getTimeZone = (timeZoneId) => {
+    const tzId = timeZoneId !== null && timeZoneId !== void 0 ? timeZoneId : Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const offset = getTimeZoneOffset(tzId);
+    return {
+        id: tzId,
+        offset: offset,
+        name: `${tzId} ${offset.length > 0 ? "(" + offset + ")" : ""}`,
+    };
+};
+/**
+ * get the offset count for a given timezone. Europe/Berlin would return +2:00
+ *
+ * @param timeZone - The time zone to use for the conversion.
+ */
+const getTimeZoneOffset = (timeZone) => {
+    var _a, _b;
+    const timezone = Temporal.TimeZone.from(timeZone);
+    return (_b = (_a = timezone.getOffsetStringFor) === null || _a === void 0 ? void 0 : _a.call(timezone, Temporal.Now.instant())) !== null && _b !== void 0 ? _b : "";
+};
 /**
  * Returns a list of all supported time zones.
  *
  * @returns {string[]}
  */
-// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-const timeZonesAvailable = Intl.supportedValuesOf
+const timeZonesAvailable = !shouldPolyfill()
     ? Intl.supportedValuesOf("timeZone")
-    : Polyfill.supportedValuesOf("timeZone");
+    : supportedValuesOf("timeZone");
 /**
  * Formats a temporal date according to the specified format, time zone, and locale.
  *
@@ -52,43 +76,49 @@ const timeZonesAvailable = Intl.supportedValuesOf
  * Output: "5/10/23, 12:00:00 AM EDT"
  */
 const formatDateUtil = (date, format, timeZone, locale) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
+    const dateObj = timeZone ? toZonedDateTimeUtil(date, timeZone) : toTemporalUtil(toDateUtil(date));
     if ((format === null || format === void 0 ? void 0 : format.selectFormat) === "dateOnly") {
-        return toZonedDateTimeUtil(date, timeZone)
-            .toPlainDate()
-            .toLocaleString(locale, {
-            dateStyle: (_a = format.dateFormat) !== null && _a !== void 0 ? _a : "medium",
+        if (dateObj instanceof Temporal.ZonedDateTime) {
+            return dateObj.toPlainDate().toLocaleString(locale, {
+                dateStyle: (_a = format.dateFormat) !== null && _a !== void 0 ? _a : "medium",
+            });
+        }
+        return dateObj.toLocaleString(locale, {
+            dateStyle: (_b = format.dateFormat) !== null && _b !== void 0 ? _b : "medium",
         });
     }
     if ((format === null || format === void 0 ? void 0 : format.selectFormat) === "timeOnly") {
-        return toZonedDateTimeUtil(date, timeZone)
-            .toPlainTime()
-            .toLocaleString(locale, {
-            timeStyle: (_b = format.timeFormat) !== null && _b !== void 0 ? _b : "short",
+        if (dateObj instanceof Temporal.ZonedDateTime) {
+            return dateObj.toPlainTime().toLocaleString(locale, {
+                timeStyle: (_c = format.timeFormat) !== null && _c !== void 0 ? _c : "short",
+            });
+        }
+        return dateObj.toLocaleString(locale, {
+            timeStyle: (_d = format.timeFormat) !== null && _d !== void 0 ? _d : "short",
         });
     }
-    return toZonedDateTimeUtil(date, timeZone).toLocaleString(locale, {
-        dateStyle: (_c = format === null || format === void 0 ? void 0 : format.dateFormat) !== null && _c !== void 0 ? _c : "medium",
-        timeStyle: (_d = format === null || format === void 0 ? void 0 : format.timeFormat) !== null && _d !== void 0 ? _d : "short",
+    return dateObj.toLocaleString(locale, {
+        dateStyle: (_e = format === null || format === void 0 ? void 0 : format.dateFormat) !== null && _e !== void 0 ? _e : "medium",
+        timeStyle: (_f = format === null || format === void 0 ? void 0 : format.timeFormat) !== null && _f !== void 0 ? _f : "short",
     });
 };
 /**
  * Formats a date range.
  *
- * @param {Date} start - The start date of the range.
- * @param {Date} end - The end date of the range.
+ * @param {DateRange} range - The start date of the range.
  * @param {string} locale - The locale identifier (e.g., 'en-US', 'fr-FR') used for formatting.
  * @param {Intl.DateTimeFormatOptions} [format] - Optional formatting options for the date and time.
  * @returns {string} A formatted string representing the date range.
  */
-const formatRangeUtil = (start, end, locale, format) => Intl.DateTimeFormat(locale, format).formatRange(start, end);
+const formatRangeUtil = (range, locale, format) => Intl.DateTimeFormat(locale, format).formatRange(range.start, range.end);
 /**
  * Subtracts a specified number of minutes from a date.
  *
  * @param {TemporalDate} date - The temporal date from which to subtract minutes.
  * @param {number} amount - The number of minutes to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of minutes.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of minutes.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -105,7 +135,7 @@ const subtractMinutesUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date from which to subtract hours.
  * @param {number} amount - The number of hours to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of hours.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of hours.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -122,7 +152,7 @@ const subtractHoursUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date from which to subtract days.
  * @param {number} amount - The number of days to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of days.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -139,7 +169,7 @@ const subtractDaysUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date from which to subtract weeks.
  * @param {number} amount - The number of weeks to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of weeks.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -156,7 +186,7 @@ const subtractWeeksUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date from which to subtract months.
  * @param {number} amount - The number of months to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of months.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -173,7 +203,7 @@ const subtractMonthsUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date from which to subtract years.
  * @param {number} amount - The number of years to subtract.
  * @param {string} [timeZone] - The time zone to use for the subtraction. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after subtracting the specified number of years.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -190,7 +220,7 @@ const subtractYearsUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which minutes will be added.
  * @param {number} amount - The number of minutes to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of minutes.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of minutes.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -207,7 +237,7 @@ const addMinutesUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which hours will be added.
  * @param {number} amount - The number of hours to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of hours.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of hours.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -224,7 +254,7 @@ const addHoursUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which days will be added.
  * @param {number} amount - The number of days to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of days.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -241,7 +271,7 @@ const addDaysUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which weeks will be added.
  * @param {number} amount - The number of weeks to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of weeks.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -258,7 +288,7 @@ const addWeeksUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which months will be added.
  * @param {number} amount - The number of months to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of months.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -275,7 +305,7 @@ const addMonthsUtil = (date, amount, timeZone) => {
  * @param {TemporalDate} date - The temporal date to which years will be added.
  * @param {number} amount - The number of years to add.
  * @param {string} [timeZone] - The time zone to use for the addition. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The resulting temporal date after adding the specified number of years.
+ * @returns {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -291,7 +321,7 @@ const addYearsUtil = (date, amount, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the start of the minute.
  * @param {string} [timeZone] - The time zone to use for determining the start of the minute. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the start of the minute.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the start of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -306,7 +336,7 @@ const startOfMinuteUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the end of the minute.
  * @param {string} [timeZone] - The time zone to use for determining the end of the minute. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the end of the minute.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the end of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -324,7 +354,7 @@ const endOfMinuteUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the start of the hour.
  * @param {string} [timeZone] - The time zone to use for determining the start of the hour. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the start of the hour.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the start of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:30.000Z"
  * const date = new Date(dateString);
@@ -339,7 +369,7 @@ const startOfHourUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the end of the hour.
  * @param {string} [timeZone] - The time zone to use for determining the end of the hour. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the end of the hour.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the end of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -357,7 +387,7 @@ const endOfHourUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the start of the day.
  * @param {string} [timeZone] - The time zone to use for determining the start of the day. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the start of the day.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the start of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -372,7 +402,7 @@ const startOfDayUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the end of the day.
  * @param {string} [timeZone] - The time zone to use for determining the end of the day. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the end of the day.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the end of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -380,9 +410,7 @@ const startOfDayUtil = (date, timeZone) => {
  * Output: Temporal.ZonedDateTime { year: 2023, month: 5, day: 10, hour: 23, minute: 59, second: 59, millisecond: 999, microsecond: 0, nanosecond: 0, timeZone: Temporal.TimeZone { id: "America/New_York" }, calendar: Temporal.Calendar { id: "iso8601" } }
  */
 const endOfDayUtil = (date, timeZone) => {
-    const day = toZonedDateTimeUtil(date, timeZone)
-        .startOfDay()
-        .subtract(Temporal.Duration.from({ milliseconds: 1 }));
+    const day = toZonedDateTimeUtil(date, timeZone).startOfDay().subtract({ seconds: 1 });
     return addDaysUtil(day, 1);
 };
 /**
@@ -390,7 +418,7 @@ const endOfDayUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the start of the week.
  * @param {string} [timeZone] - The time zone to use for determining the start of the week. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the start of the week.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the start of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -407,7 +435,7 @@ const startOfWeekUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the end of the week.
  * @param {string} [timeZone] - The time zone to use for determining the end of the week. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the end of the week.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the end of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -425,7 +453,7 @@ const endOfWeekUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the start of the month.
  * @param {string} [timeZone] - The time zone to use for determining the start of the month. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the start of the month.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the start of the month.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -442,7 +470,7 @@ const startOfMonthUtil = (date, timeZone) => {
  *
  * @param {TemporalDate} date - The temporal date for which to determine the end of the month.
  * @param {string} [timeZone] - The time zone to use for determining the end of the month. If not provided, the system's default time zone will be used.
- * @returns {TemporalDate} The temporal date representing the end of the month.
+ * @returns {Temporal.ZonedDateTime} The temporal date representing the end of the month.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -636,6 +664,22 @@ const isPastUtil = (date) => {
 const isTodayUtil = (date) => {
     return Temporal.PlainDate.compare(toZonedDateTimeUtil(Temporal.Now.instant()), toZonedDateTimeUtil(date)) === 0;
 };
+/**
+ *
+ *
+ * @param date - The date to check.
+ * @param start - The start date to compare against.
+ * @param end - The en date to compare against.
+ */
+const isBetweenUtil = (date, start, end) => {
+    if (!start || !end) {
+        throw new Error("Start and end dates must be provided");
+    }
+    const dateToCheck = new Date(date.toLocaleString());
+    const startDate = new Date(start.toLocaleString());
+    const endDate = new Date(end.toLocaleString());
+    return dateToCheck >= startDate && dateToCheck <= endDate;
+};
 /**
  * Checks if a date is same day as current.
  *
@@ -702,7 +746,9 @@ const isSameYearUtil = (date) => {
  * Output: true
  */
 const isEqualUtil = (from, to) => {
-    return toZonedDateTimeUtil(from).equals(toZonedDateTimeUtil(to));
+    return toZonedDateTimeUtil(from)
+        .round({ smallestUnit: "seconds" })
+        .equals(toZonedDateTimeUtil(to).round({ smallestUnit: "seconds" }));
 };
 /**
  * Calculates the time duration between two TemporalDate objects and returns a human-readable string representation of the duration.
@@ -736,6 +782,9 @@ const timeSinceAuto = (from, to, timeZone, locale) => {
         largestUnit: "years",
         smallestUnit: "seconds",
     }));
+    if (duration.blank) {
+        return getRelativeTimeFormat(locale).format(-1, "seconds");
+    }
     if (duration.years !== 0) {
         return timeSinceInYears(from, to, timeZone, locale);
     }
@@ -862,6 +911,10 @@ const timeSinceInDays = (from, to, timeZone, locale) => {
  * Output: "2 months ago"
  */
 const timeSinceInMonths = (from, to, timeZone, locale) => {
+    const isLeapYear = toZonedDateTimeUtil(from, timeZone).inLeapYear && toZonedDateTimeUtil(to, timeZone).inLeapYear;
+    if (isLeapYear) {
+        return timeSinceInDays(from, to, timeZone, locale);
+    }
     const duration = Temporal.Duration.from(toZonedDateTimeUtil(from, timeZone).since(toZonedDateTimeUtil(to, timeZone), {
         largestUnit: "months",
     }));
@@ -883,12 +936,75 @@ const timeSinceInMonths = (from, to, timeZone, locale) => {
  * Output: "1 year ago"
  */
 const timeSinceInYears = (from, to, timeZone, locale) => {
+    const isLeapYear = toZonedDateTimeUtil(from, timeZone).inLeapYear && toZonedDateTimeUtil(to, timeZone).inLeapYear;
+    if (isLeapYear) {
+        return timeSinceInDays(from, to, timeZone, locale);
+    }
     const duration = Temporal.Duration.from(toZonedDateTimeUtil(from, timeZone).since(toZonedDateTimeUtil(to, timeZone), {
         largestUnit: "years",
     }));
     return getRelativeTimeFormat(locale).format(duration.years, "years");
 };
 const getRelativeTimeFormat = (locale) => new Intl.RelativeTimeFormat(locale, { style: "long", numeric: "always" });
+/**
+ * Get duration in human-readable form
+ *
+ * @param duration - years, months, days, minutes, seconds
+ * @param locale - selected locale
+ * @param format - long, short, narrow
+ * @returns {string} human-readable string
+ */
+const getDurationFormat = (duration, locale, format) => {
+    return new Intl.DurationFormat(locale, { style: format !== null && format !== void 0 ? format : "long" }).format(duration);
+};
+/**
+ * convert a number to a type
+ *
+ * @param {number} number - 230.45
+ * @param {TemporalTimeTypes} unit - "days | "hours" | minutes
+ * @param {Temporal.TimeUnit} roundAt - smallest unit to show
+ */
+const toDuration = (number, unit, roundAt) => {
+    switch (unit) {
+        case "days":
+            return Temporal.Duration.from(durationBuilder(number, "days")).round({
+                smallestUnit: roundAt !== null && roundAt !== void 0 ? roundAt : "seconds",
+            });
+        case "hours":
+            return Temporal.Duration.from(durationBuilder(number, "hours")).round({ smallestUnit: roundAt !== null && roundAt !== void 0 ? roundAt : "minutes" });
+        case "minutes":
+            return Temporal.Duration.from(durationBuilder(number, "minutes")).round({
+                smallestUnit: roundAt !== null && roundAt !== void 0 ? roundAt : "seconds",
+            });
+        default:
+            throw new Error("Not a valid unit", { cause: unit });
+    }
+};
+const durationBuilder = (number, unit) => {
+    const days = Math.floor(number);
+    const hours = unit === "hours" ? Math.floor(number) : Math.floor((number * 24) % 24);
+    const minutes = unit === "minutes" ? Math.floor(number) : Math.floor((number * 24 * 60) % 60);
+    const seconds = Math.floor((number * 24 * 60 * 60) % 60);
+    switch (unit) {
+        case "days":
+            if (Number.isSafeInteger(number)) {
+                return `P${number}D`;
+            }
+            return `P${days}DT${hours}H${minutes}M${seconds}S`;
+        case "hours":
+            if (Number.isSafeInteger(number)) {
+                return `PT${number}H`;
+            }
+            return `PT${hours}H${minutes}M${seconds}S`;
+        case "minutes":
+            if (Number.isSafeInteger(number)) {
+                return `PT${number}M`;
+            }
+            return `PT${minutes}M${seconds}S`;
+        default:
+            return `PT0S`;
+    }
+};
 /**
  * Converts a JavaScript Date object to a Temporal Instant.
  *
@@ -900,6 +1016,9 @@ const getRelativeTimeFormat = (locale) => new Intl.RelativeTimeFormat(locale, {
  * Output: Temporal.Instant { year: ..., month: ..., day: ..., hour: ..., minute: ..., second: ..., millisecond: ... }
  */
 const toTemporalUtil = (date) => {
+    if (typeof date === "string") {
+        return Temporal.Instant.from(date);
+    }
     return Temporal.Instant.from(date.toISOString());
 };
 /**
@@ -918,6 +1037,12 @@ const toTemporalUtil = (date) => {
  * Output: Date { ... } (equivalent JavaScript Date object)
  */
 const toDateUtil = (date) => {
+    if (typeof date === "string" || typeof date === "number") {
+        return new Date(date);
+    }
+    if (date instanceof Date) {
+        return date;
+    }
     if (date instanceof Temporal.ZonedDateTime) {
         date = toInstantUtil(date);
     }
@@ -934,6 +1059,12 @@ const toDateUtil = (date) => {
  * Output: Temporal.Instant { year: ..., month: ..., day: ..., hour: ..., minute: ..., second: ..., millisecond: ... }
  */
 const toInstantUtil = (zonedDateTime) => {
+    if (typeof zonedDateTime === "string") {
+        return Temporal.Instant.from(zonedDateTime);
+    }
+    if (zonedDateTime instanceof Date) {
+        return Temporal.Instant.from(zonedDateTime.toString());
+    }
     return zonedDateTime.toInstant();
 };
 /**
@@ -954,7 +1085,7 @@ const toZonedDateTimeUtil = (date, timeZoneId, calendar) => {
     if (date instanceof Temporal.ZonedDateTime) {
         return date;
     }
-    if (date instanceof Date) {
+    if (date instanceof Date || typeof date === "string") {
         date = toTemporalUtil(date);
     }
     return date.toZonedDateTime({
@@ -990,6 +1121,22 @@ const monthNameUtil = (date, format, locale) => {
         month: format,
     });
 };
+/**
+ * Returns a list of month names
+ *
+ * @param {TemporalFormatStyle} format - select the format of the month name
+ * @param {string} locale - The locale to use for formatting. If not provided, the system's default locale will be used.
+ */
+const monthsUtil = (format, locale) => {
+    const months = [];
+    const d = new Date();
+    const monthsInYear = Temporal.PlainDate.from(d.toISOString()).monthsInYear;
+    for (let month = 0; month < monthsInYear; ++month) {
+        d.setMonth(month);
+        months.push(d.toLocaleString(locale, { month: format !== null && format !== void 0 ? format : "long" }));
+    }
+    return months;
+};
 /**
  * Returns the day name for the given date.
  *
@@ -1018,5 +1165,21 @@ const dayNameUtil = (date, format, locale) => {
         weekday: format,
     });
 };
+/**
+ * Returns a list of day names
+ *
+ * @param {TemporalFormatStyle} format - select the format of the day name
+ * @param {string} locale - The locale to use for formatting. If not provided, the system's default locale will be used.
+ */
+const daysUtil = (format, locale) => {
+    const days = [];
+    const d = new Date();
+    const daysInWeek = Temporal.PlainDate.from(d.toISOString()).daysInWeek;
+    for (let day = 0; day < daysInWeek; ++day) {
+        d.setDate(day);
+        days.push(d.toLocaleString(locale, { weekday: format !== null && format !== void 0 ? format : "long" }));
+    }
+    return days;
+};
 
-export { addDaysUtil, addHoursUtil, addMinutesUtil, addMonthsUtil, addWeeksUtil, addYearsUtil, dayNameUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInMonthsUtil, differenceInWeeksUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, formatDateUtil, formatRangeUtil, isEqualUtil, isFutureUtil, isPastUtil, isSameDayUtil, isSameMonthUtil, isSameWeekUtil, isSameYearUtil, isTodayUtil, monthNameUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, startOfMonthUtil, startOfWeekUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, subtractMonthsUtil, subtractWeeksUtil, subtractYearsUtil, timeSinceAuto, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInMonths, timeSinceInSeconds, timeSinceInYears, timeZonesAvailable, toDateUtil, toInstantUtil, toTemporalUtil, toZonedDateTimeUtil };
+export { addDaysUtil, addHoursUtil, addMinutesUtil, addMonthsUtil, addWeeksUtil, addYearsUtil, dayNameUtil, daysUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInMonthsUtil, differenceInWeeksUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, formatDateUtil, formatRangeUtil, getDurationFormat, getTimeZone, getTimeZoneOffset, isBetweenUtil, isEqualUtil, isFutureUtil, isPastUtil, isSameDayUtil, isSameMonthUtil, isSameWeekUtil, isSameYearUtil, isTodayUtil, monthNameUtil, monthsUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, startOfMonthUtil, startOfWeekUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, subtractMonthsUtil, subtractWeeksUtil, subtractYearsUtil, timeSinceAuto, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInMonths, timeSinceInSeconds, timeSinceInYears, timeZonesAvailable, toDateUtil, toDuration, toInstantUtil, toTemporalUtil, toZonedDateTimeUtil };

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@trackunit/date-and-time-utils",
-  "version": "0.0.26",
+  "version": "0.0.28-alpha-26d41cfe4c9.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
-    "node": ">=18.x"
+    "node": ">=20.x"
   },
   "dependencies": {
     "@formatjs/intl-enumerator": "^1.4.1",
-    "@js-temporal/polyfill": "^0.4.4"
+    "@js-temporal/polyfill": "^0.4.4",
+    "@formatjs/intl-durationformat": "^0.2.2"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js"