@trackunit/date-and-time-utils 0.0.25 → 0.0.27

package/index.cjs.js

@@ -2,19 +2,43 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+require('@formatjs/intl-durationformat/polyfill');
+var intlEnumerator = require('@formatjs/intl-enumerator');
 var polyfill = require('@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 = polyfill.Temporal.TimeZone.from(timeZone);
+    return (_b = (_a = timezone.getOffsetStringFor) === null || _a === void 0 ? void 0 : _a.call(timezone, polyfill.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 = !intlEnumerator.shouldPolyfill()
     ? Intl.supportedValuesOf("timeZone")
-    : Polyfill.supportedValuesOf("timeZone");
+    : intlEnumerator.supportedValuesOf("timeZone");
 /**
  * Formats a temporal date according to the specified format, time zone, and locale.
  *
@@ -56,43 +80,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 polyfill.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 polyfill.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);
@@ -109,7 +139,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);
@@ -126,7 +156,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);
@@ -143,7 +173,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);
@@ -160,7 +190,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);
@@ -177,7 +207,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);
@@ -194,7 +224,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);
@@ -211,7 +241,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);
@@ -228,7 +258,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);
@@ -245,7 +275,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);
@@ -262,7 +292,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);
@@ -279,7 +309,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);
@@ -295,7 +325,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);
@@ -310,7 +340,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);
@@ -328,7 +358,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);
@@ -343,7 +373,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);
@@ -361,7 +391,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);
@@ -376,7 +406,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);
@@ -384,9 +414,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(polyfill.Temporal.Duration.from({ milliseconds: 1 }));
+    const day = toZonedDateTimeUtil(date, timeZone).startOfDay().subtract({ seconds: 1 });
     return addDaysUtil(day, 1);
 };
 /**
@@ -394,7 +422,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);
@@ -411,7 +439,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);
@@ -429,7 +457,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);
@@ -446,7 +474,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);
@@ -640,6 +668,22 @@ const isPastUtil = (date) => {
 const isTodayUtil = (date) => {
     return polyfill.Temporal.PlainDate.compare(toZonedDateTimeUtil(polyfill.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.
  *
@@ -706,7 +750,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.
@@ -740,6 +786,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);
     }
@@ -866,6 +915,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 = polyfill.Temporal.Duration.from(toZonedDateTimeUtil(from, timeZone).since(toZonedDateTimeUtil(to, timeZone), {
         largestUnit: "months",
     }));
@@ -887,12 +940,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 = polyfill.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 polyfill.Temporal.Duration.from(durationBuilder(number, "days")).round({
+                smallestUnit: roundAt !== null && roundAt !== void 0 ? roundAt : "seconds",
+            });
+        case "hours":
+            return polyfill.Temporal.Duration.from(durationBuilder(number, "hours")).round({ smallestUnit: roundAt !== null && roundAt !== void 0 ? roundAt : "minutes" });
+        case "minutes":
+            return polyfill.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.
  *
@@ -904,6 +1020,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 polyfill.Temporal.Instant.from(date);
+    }
     return polyfill.Temporal.Instant.from(date.toISOString());
 };
 /**
@@ -922,6 +1041,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 polyfill.Temporal.ZonedDateTime) {
         date = toInstantUtil(date);
     }
@@ -938,6 +1063,12 @@ const toDateUtil = (date) => {
  * Output: Temporal.Instant { year: ..., month: ..., day: ..., hour: ..., minute: ..., second: ..., millisecond: ... }
  */
 const toInstantUtil = (zonedDateTime) => {
+    if (typeof zonedDateTime === "string") {
+        return polyfill.Temporal.Instant.from(zonedDateTime);
+    }
+    if (zonedDateTime instanceof Date) {
+        return polyfill.Temporal.Instant.from(zonedDateTime.toString());
+    }
     return zonedDateTime.toInstant();
 };
 /**
@@ -958,7 +1089,7 @@ const toZonedDateTimeUtil = (date, timeZoneId, calendar) => {
     if (date instanceof polyfill.Temporal.ZonedDateTime) {
         return date;
     }
-    if (date instanceof Date) {
+    if (date instanceof Date || typeof date === "string") {
         date = toTemporalUtil(date);
     }
     return date.toZonedDateTime({
@@ -994,6 +1125,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 = polyfill.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.
  *
@@ -1022,6 +1169,22 @@ 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 = polyfill.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;
+};
 
 exports.addDaysUtil = addDaysUtil;
 exports.addHoursUtil = addHoursUtil;
@@ -1030,6 +1193,7 @@ exports.addMonthsUtil = addMonthsUtil;
 exports.addWeeksUtil = addWeeksUtil;
 exports.addYearsUtil = addYearsUtil;
 exports.dayNameUtil = dayNameUtil;
+exports.daysUtil = daysUtil;
 exports.differenceInDaysUtil = differenceInDaysUtil;
 exports.differenceInHoursUtil = differenceInHoursUtil;
 exports.differenceInMinutesUtil = differenceInMinutesUtil;
@@ -1042,6 +1206,10 @@ exports.endOfMonthUtil = endOfMonthUtil;
 exports.endOfWeekUtil = endOfWeekUtil;
 exports.formatDateUtil = formatDateUtil;
 exports.formatRangeUtil = formatRangeUtil;
+exports.getDurationFormat = getDurationFormat;
+exports.getTimeZone = getTimeZone;
+exports.getTimeZoneOffset = getTimeZoneOffset;
+exports.isBetweenUtil = isBetweenUtil;
 exports.isEqualUtil = isEqualUtil;
 exports.isFutureUtil = isFutureUtil;
 exports.isPastUtil = isPastUtil;
@@ -1051,6 +1219,7 @@ exports.isSameWeekUtil = isSameWeekUtil;
 exports.isSameYearUtil = isSameYearUtil;
 exports.isTodayUtil = isTodayUtil;
 exports.monthNameUtil = monthNameUtil;
+exports.monthsUtil = monthsUtil;
 exports.startOfDayUtil = startOfDayUtil;
 exports.startOfHourUtil = startOfHourUtil;
 exports.startOfMinuteUtil = startOfMinuteUtil;
@@ -1071,6 +1240,7 @@ exports.timeSinceInSeconds = timeSinceInSeconds;
 exports.timeSinceInYears = timeSinceInYears;
 exports.timeZonesAvailable = timeZonesAvailable;
 exports.toDateUtil = toDateUtil;
+exports.toDuration = toDuration;
 exports.toInstantUtil = toInstantUtil;
 exports.toTemporalUtil = toTemporalUtil;
 exports.toZonedDateTimeUtil = toZonedDateTimeUtil;

package/index.esm.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";