@trackunit/date-and-time-utils 1.6.5 → 1.6.10

package/index.cjs.js

@@ -149,7 +149,7 @@ const formatRangeUtil = (range, locale, format) => Intl.DateTimeFormat(locale, f
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of minutes.
+ * @returns {TemporalZonedDateTime} 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);
@@ -166,7 +166,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of hours.
+ * @returns {TemporalZonedDateTime} 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);
@@ -183,7 +183,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -200,7 +200,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -217,7 +217,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -234,7 +234,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -251,7 +251,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of minutes.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of minutes.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -268,7 +268,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of hours.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of hours.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -285,7 +285,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -302,7 +302,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -319,7 +319,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -336,7 +336,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -352,7 +352,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 {Temporal.ZonedDateTime} The temporal date representing the start of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -367,7 +367,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 {Temporal.ZonedDateTime} The temporal date representing the end of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -385,7 +385,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 {Temporal.ZonedDateTime} The temporal date representing the start of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:30.000Z"
  * const date = new Date(dateString);
@@ -400,7 +400,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 {Temporal.ZonedDateTime} The temporal date representing the end of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -418,7 +418,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 {Temporal.ZonedDateTime} The temporal date representing the start of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -433,7 +433,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 {Temporal.ZonedDateTime} The temporal date representing the end of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -449,7 +449,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 {Temporal.ZonedDateTime} The temporal date representing the start of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -466,7 +466,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 {Temporal.ZonedDateTime} The temporal date representing the end of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -484,7 +484,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 {Temporal.ZonedDateTime} The temporal date representing the start of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the month.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -501,7 +501,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 {Temporal.ZonedDateTime} The temporal date representing the end of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the month.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -1161,7 +1161,7 @@ const getDurationFormat = (duration, locale, format) => {
  *
  * @param {number} number - 230.45
  * @param {TemporalTimeTypes} unit - "days | "hours" | "minutes" | "seconds"
- * @param {Temporal.TimeUnit} roundAt - smallest unit to show
+ * @param {TemporalTimeUnit} roundAt - smallest unit to show
  */
 const toDuration = (number, unit, roundAt) => {
     switch (unit) {
@@ -1296,7 +1296,7 @@ const convertToMinutes = (number) => {
  * Converts a JavaScript Date object to a Temporal Instant.
  *
  * @param {Date} date - The JavaScript Date object to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const jsDate = new Date();
  * const result = toTemporalUtil(jsDate);
@@ -1311,7 +1311,7 @@ const toTemporalUtil = (date) => {
 /**
  * Converts a Temporal Instant or Temporal ZonedDateTime to a JavaScript Date object.
  *
- * @param {Temporal.Instant|Temporal.ZonedDateTime} date - The Temporal date object to convert.
+ * @param {TemporalInstant|TemporalZonedDateTime} date - The Temporal date object to convert.
  * @returns {Date} The equivalent JavaScript Date object.
  * @example
  * const temporalInstant = Temporal.now.instant();
@@ -1338,8 +1338,8 @@ const toDateUtil = (date) => {
 /**
  * Converts a Temporal ZonedDateTime to a Temporal Instant.
  *
- * @param {Temporal.ZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @param {TemporalZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const zonedDateTime = Temporal.now.zonedDateTime();
  * const result = toInstantUtil(zonedDateTime);
@@ -1360,7 +1360,7 @@ const toInstantUtil = (zonedDateTime) => {
  * @param {TemporalDate | Date} date - The temporal or JavaScript Date object to convert.
  * @param {string} [timeZoneId] - The time zone identifier to use for the conversion. If not provided, the system's default time zone will be used.
  * @param {string} [calendar] - The calendar identifier to use for the conversion. If not provided, the ISO 8601 calendar will be used.
- * @returns {Temporal.ZonedDateTime} The temporal zoned date-time representation of the input date.
+ * @returns {TemporalZonedDateTime} The temporal zoned date-time representation of the input date.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -1485,7 +1485,7 @@ const getUTCFromTimeZonedUtil = (from, timeZoneId) => {
  * Get the local week index of the given date using Temporal.
  * The exact calculation depends on the values of `weekStartsOn` (the index of the first day of the week)
  * and `firstWeekContainsDate` (the day in January, which is always in the first week of the week-numbering year).
- * @param {Temporal.PlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
+ * @param {TemporalPlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
  * @param {GetWeekUtilOptions} [options] - Optional settings for the week calculation.
  * @returns {number} - The week number of the year.
  * @example
@@ -1519,6 +1519,7 @@ const getWeekUtil = (date, options) => {
  * @description
  * Convert milliseconds to the specified unit using Temporal.
  * @param {number} milliseconds - The number of milliseconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMillisecondsUtil(60000, "minute")
@@ -1539,6 +1540,7 @@ const convertMillisecondsUtil = (milliseconds, unit) => {
  * @description
  * Convert seconds to the specified unit using Temporal.
  * @param {number} seconds - The number of seconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertSecondsUtil(60, "minute")
@@ -1556,6 +1558,7 @@ const convertSecondsUtil = (seconds, unit) => {
  * @description
  * Convert minutes to the specified unit using Temporal.
  * @param {number} minutes - The number of minutes to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMinutesUtil(60, "minute")
@@ -1573,6 +1576,7 @@ const convertMinutesUtil = (minutes, unit) => {
  * @description
  * Convert hours to the specified unit using Temporal.
  * @param {number} hours - The number of hours to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertHoursUtil(24, "day")

package/index.esm.js

@@ -147,7 +147,7 @@ const formatRangeUtil = (range, locale, format) => Intl.DateTimeFormat(locale, f
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of minutes.
+ * @returns {TemporalZonedDateTime} 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);
@@ -164,7 +164,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of hours.
+ * @returns {TemporalZonedDateTime} 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);
@@ -181,7 +181,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -198,7 +198,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -215,7 +215,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -232,7 +232,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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -249,7 +249,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of minutes.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of minutes.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -266,7 +266,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of hours.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of hours.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -283,7 +283,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -300,7 +300,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -317,7 +317,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -334,7 +334,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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -350,7 +350,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 {Temporal.ZonedDateTime} The temporal date representing the start of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -365,7 +365,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 {Temporal.ZonedDateTime} The temporal date representing the end of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -383,7 +383,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 {Temporal.ZonedDateTime} The temporal date representing the start of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:30.000Z"
  * const date = new Date(dateString);
@@ -398,7 +398,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 {Temporal.ZonedDateTime} The temporal date representing the end of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -416,7 +416,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 {Temporal.ZonedDateTime} The temporal date representing the start of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -431,7 +431,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 {Temporal.ZonedDateTime} The temporal date representing the end of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -447,7 +447,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 {Temporal.ZonedDateTime} The temporal date representing the start of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -464,7 +464,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 {Temporal.ZonedDateTime} The temporal date representing the end of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -482,7 +482,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 {Temporal.ZonedDateTime} The temporal date representing the start of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the month.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -499,7 +499,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 {Temporal.ZonedDateTime} The temporal date representing the end of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the month.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -1159,7 +1159,7 @@ const getDurationFormat = (duration, locale, format) => {
  *
  * @param {number} number - 230.45
  * @param {TemporalTimeTypes} unit - "days | "hours" | "minutes" | "seconds"
- * @param {Temporal.TimeUnit} roundAt - smallest unit to show
+ * @param {TemporalTimeUnit} roundAt - smallest unit to show
  */
 const toDuration = (number, unit, roundAt) => {
     switch (unit) {
@@ -1294,7 +1294,7 @@ const convertToMinutes = (number) => {
  * Converts a JavaScript Date object to a Temporal Instant.
  *
  * @param {Date} date - The JavaScript Date object to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const jsDate = new Date();
  * const result = toTemporalUtil(jsDate);
@@ -1309,7 +1309,7 @@ const toTemporalUtil = (date) => {
 /**
  * Converts a Temporal Instant or Temporal ZonedDateTime to a JavaScript Date object.
  *
- * @param {Temporal.Instant|Temporal.ZonedDateTime} date - The Temporal date object to convert.
+ * @param {TemporalInstant|TemporalZonedDateTime} date - The Temporal date object to convert.
  * @returns {Date} The equivalent JavaScript Date object.
  * @example
  * const temporalInstant = Temporal.now.instant();
@@ -1336,8 +1336,8 @@ const toDateUtil = (date) => {
 /**
  * Converts a Temporal ZonedDateTime to a Temporal Instant.
  *
- * @param {Temporal.ZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @param {TemporalZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const zonedDateTime = Temporal.now.zonedDateTime();
  * const result = toInstantUtil(zonedDateTime);
@@ -1358,7 +1358,7 @@ const toInstantUtil = (zonedDateTime) => {
  * @param {TemporalDate | Date} date - The temporal or JavaScript Date object to convert.
  * @param {string} [timeZoneId] - The time zone identifier to use for the conversion. If not provided, the system's default time zone will be used.
  * @param {string} [calendar] - The calendar identifier to use for the conversion. If not provided, the ISO 8601 calendar will be used.
- * @returns {Temporal.ZonedDateTime} The temporal zoned date-time representation of the input date.
+ * @returns {TemporalZonedDateTime} The temporal zoned date-time representation of the input date.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -1483,7 +1483,7 @@ const getUTCFromTimeZonedUtil = (from, timeZoneId) => {
  * Get the local week index of the given date using Temporal.
  * The exact calculation depends on the values of `weekStartsOn` (the index of the first day of the week)
  * and `firstWeekContainsDate` (the day in January, which is always in the first week of the week-numbering year).
- * @param {Temporal.PlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
+ * @param {TemporalPlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
  * @param {GetWeekUtilOptions} [options] - Optional settings for the week calculation.
  * @returns {number} - The week number of the year.
  * @example
@@ -1517,6 +1517,7 @@ const getWeekUtil = (date, options) => {
  * @description
  * Convert milliseconds to the specified unit using Temporal.
  * @param {number} milliseconds - The number of milliseconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMillisecondsUtil(60000, "minute")
@@ -1537,6 +1538,7 @@ const convertMillisecondsUtil = (milliseconds, unit) => {
  * @description
  * Convert seconds to the specified unit using Temporal.
  * @param {number} seconds - The number of seconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertSecondsUtil(60, "minute")
@@ -1554,6 +1556,7 @@ const convertSecondsUtil = (seconds, unit) => {
  * @description
  * Convert minutes to the specified unit using Temporal.
  * @param {number} minutes - The number of minutes to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMinutesUtil(60, "minute")
@@ -1571,6 +1574,7 @@ const convertMinutesUtil = (minutes, unit) => {
  * @description
  * Convert hours to the specified unit using Temporal.
  * @param {number} hours - The number of hours to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertHoursUtil(24, "day")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/date-and-time-utils",
-  "version": "1.6.5",
+  "version": "1.6.10",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -10,7 +10,7 @@
     "@formatjs/intl-enumerator": "^1.8.1",
     "@js-temporal/polyfill": "^0.4.4",
     "@formatjs/intl-durationformat": "^0.6.1",
-    "@trackunit/react-test-setup": "1.3.5"
+    "@trackunit/react-test-setup": "1.3.10"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/DateAndTimeUtils.d.ts

@@ -1,5 +1,6 @@
 import "@formatjs/intl-durationformat/polyfill";
 import { Temporal } from "@js-temporal/polyfill";
+export type TemporalTimeUnit = Temporal.TimeUnit;
 export type TemporalDate = Temporal.Instant | Temporal.ZonedDateTime | Date;
 type TemporalFormatTypes = Intl.DateTimeFormatOptions;
 type TemporalTimeTypes = Extract<Intl.RelativeTimeFormatUnit, "days" | "hours" | "minutes" | "seconds">;
@@ -98,7 +99,7 @@ export declare const formatRangeUtil: (range: DateRange, locale: string, format?
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of minutes.
+ * @returns {TemporalZonedDateTime} 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);
@@ -113,7 +114,7 @@ export declare const subtractMinutesUtil: (date: TemporalDate, amount: number, t
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of hours.
+ * @returns {TemporalZonedDateTime} 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);
@@ -128,7 +129,7 @@ export declare const subtractHoursUtil: (date: TemporalDate, amount: number, tim
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -143,7 +144,7 @@ export declare const subtractDaysUtil: (date: TemporalDate, amount: number, time
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -158,7 +159,7 @@ export declare const subtractWeeksUtil: (date: TemporalDate, amount: number, tim
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -173,7 +174,7 @@ export declare const subtractMonthsUtil: (date: TemporalDate, amount: number, ti
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after subtracting the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after subtracting the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -188,7 +189,7 @@ export declare const subtractYearsUtil: (date: TemporalDate, amount: number, tim
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of minutes.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of minutes.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -203,7 +204,7 @@ export declare const addMinutesUtil: (date: TemporalDate, amount: number, timeZo
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of hours.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of hours.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -218,7 +219,7 @@ export declare const addHoursUtil: (date: TemporalDate, amount: number, 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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of days.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of days.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -233,7 +234,7 @@ export declare const addDaysUtil: (date: TemporalDate, amount: number, 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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of weeks.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of weeks.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -248,7 +249,7 @@ export declare const addWeeksUtil: (date: TemporalDate, amount: number, 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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of months.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of months.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -263,7 +264,7 @@ export declare const addMonthsUtil: (date: TemporalDate, amount: number, timeZon
  * @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 {Temporal.ZonedDateTime} The resulting temporal date after adding the specified number of years.
+ * @returns {TemporalZonedDateTime} The resulting temporal date after adding the specified number of years.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -277,7 +278,7 @@ export declare const addYearsUtil: (date: TemporalDate, amount: number, 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 {Temporal.ZonedDateTime} The temporal date representing the start of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -290,7 +291,7 @@ export declare const startOfMinuteUtil: (date: TemporalDate, timeZone?: string)
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the end of the minute.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the minute.
  * @example
  * const dateString = "2023-05-10T10:30:10.000Z"
  * const date = new Date(dateString);
@@ -303,7 +304,7 @@ export declare const endOfMinuteUtil: (date: TemporalDate, timeZone?: string) =>
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the start of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:30.000Z"
  * const date = new Date(dateString);
@@ -316,7 +317,7 @@ export declare const startOfHourUtil: (date: TemporalDate, timeZone?: string) =>
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the end of the hour.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the hour.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -329,7 +330,7 @@ export declare const endOfHourUtil: (date: TemporalDate, timeZone?: string) => T
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the start of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -342,7 +343,7 @@ export declare const startOfDayUtil: (date: TemporalDate, timeZone?: string) =>
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the end of the day.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the day.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -355,7 +356,7 @@ export declare const endOfDayUtil: (date: TemporalDate, timeZone?: string) => Te
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the start of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -368,7 +369,7 @@ export declare const startOfWeekUtil: (date: TemporalDate, timeZone?: string) =>
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the end of the week.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the week.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -381,7 +382,7 @@ export declare const endOfWeekUtil: (date: TemporalDate, timeZone?: string) => T
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the start of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the start of the month.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -394,7 +395,7 @@ export declare const startOfMonthUtil: (date: TemporalDate, timeZone?: string) =
  *
  * @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 {Temporal.ZonedDateTime} The temporal date representing the end of the month.
+ * @returns {TemporalZonedDateTime} The temporal date representing the end of the month.
  * @example
  * const dateString = "2023-05-10"
  * const date = new Date(dateString);
@@ -803,14 +804,14 @@ export declare const getDurationFormat: (duration: Intl.Duration, locale?: strin
  *
  * @param {number} number - 230.45
  * @param {TemporalTimeTypes} unit - "days | "hours" | "minutes" | "seconds"
- * @param {Temporal.TimeUnit} roundAt - smallest unit to show
+ * @param {TemporalTimeUnit} roundAt - smallest unit to show
  */
 export declare const toDuration: (number: number, unit: TemporalTimeTypes, roundAt?: Extract<Temporal.TimeUnit, "hour" | "minute" | "second">) => Intl.Duration;
 /**
  * Converts a JavaScript Date object to a Temporal Instant.
  *
  * @param {Date} date - The JavaScript Date object to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const jsDate = new Date();
  * const result = toTemporalUtil(jsDate);
@@ -820,7 +821,7 @@ export declare const toTemporalUtil: (date: Date | string) => Temporal.Instant;
 /**
  * Converts a Temporal Instant or Temporal ZonedDateTime to a JavaScript Date object.
  *
- * @param {Temporal.Instant|Temporal.ZonedDateTime} date - The Temporal date object to convert.
+ * @param {TemporalInstant|TemporalZonedDateTime} date - The Temporal date object to convert.
  * @returns {Date} The equivalent JavaScript Date object.
  * @example
  * const temporalInstant = Temporal.now.instant();
@@ -836,8 +837,8 @@ export declare const toDateUtil: (date: Temporal.Instant | Temporal.ZonedDateTim
 /**
  * Converts a Temporal ZonedDateTime to a Temporal Instant.
  *
- * @param {Temporal.ZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
- * @returns {Temporal.Instant} The equivalent Temporal Instant.
+ * @param {TemporalZonedDateTime} zonedDateTime - The Temporal ZonedDateTime to convert.
+ * @returns {TemporalInstant} The equivalent Temporal Instant.
  * @example
  * const zonedDateTime = Temporal.now.zonedDateTime();
  * const result = toInstantUtil(zonedDateTime);
@@ -850,7 +851,7 @@ export declare const toInstantUtil: (zonedDateTime: Temporal.ZonedDateTime | Dat
  * @param {TemporalDate | Date} date - The temporal or JavaScript Date object to convert.
  * @param {string} [timeZoneId] - The time zone identifier to use for the conversion. If not provided, the system's default time zone will be used.
  * @param {string} [calendar] - The calendar identifier to use for the conversion. If not provided, the ISO 8601 calendar will be used.
- * @returns {Temporal.ZonedDateTime} The temporal zoned date-time representation of the input date.
+ * @returns {TemporalZonedDateTime} The temporal zoned date-time representation of the input date.
  * @example
  * const dateString = "2023-05-10T10:30:00.000Z"
  * const date = new Date(dateString);
@@ -940,7 +941,7 @@ interface GetWeekUtilOptions {
  * Get the local week index of the given date using Temporal.
  * The exact calculation depends on the values of `weekStartsOn` (the index of the first day of the week)
  * and `firstWeekContainsDate` (the day in January, which is always in the first week of the week-numbering year).
- * @param {Temporal.PlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
+ * @param {TemporalPlainDate | Date | string} date - The given date (can be either Temporal.PlainDate, a native Date, or an ISO date string).
  * @param {GetWeekUtilOptions} [options] - Optional settings for the week calculation.
  * @returns {number} - The week number of the year.
  * @example
@@ -963,6 +964,7 @@ export declare const getWeekUtil: (date: Temporal.PlainDate | Date | string, opt
  * @description
  * Convert milliseconds to the specified unit using Temporal.
  * @param {number} milliseconds - The number of milliseconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMillisecondsUtil(60000, "minute")
@@ -981,6 +983,7 @@ export declare const convertMillisecondsUtil: (milliseconds: number, unit: Extra
  * @description
  * Convert seconds to the specified unit using Temporal.
  * @param {number} seconds - The number of seconds to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertSecondsUtil(60, "minute")
@@ -996,6 +999,7 @@ export declare const convertSecondsUtil: (seconds: number, unit: Extract<Tempora
  * @description
  * Convert minutes to the specified unit using Temporal.
  * @param {number} minutes - The number of minutes to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertMinutesUtil(60, "minute")
@@ -1011,6 +1015,7 @@ export declare const convertMinutesUtil: (minutes: number, unit: Extract<Tempora
  * @description
  * Convert hours to the specified unit using Temporal.
  * @param {number} hours - The number of hours to convert.
+ * @param unit - The unit to convert to.
  * @returns {number} - The converted value.
  * @example
  * const result = convertHoursUtil(24, "day")