@trackunit/date-and-time-utils 1.10.26 → 1.11.7

package/index.cjs.js

@@ -1609,11 +1609,24 @@ const startOfWeek = (date, weekStartsOn) => {
 /**
  *
  * @param date - The date to check if it is valid.
+ * @returns {boolean} - True if the date is valid, false otherwise.
  */
 const isValidDate = (date) => {
     const isDate = new Date(date).getTime();
     return !isNaN(isDate);
 };
+/**
+ * Parses a date, if it is valid, returns a valid Date object, otherwise returns null.
+ *
+ * @param date - The date to parse.
+ * @returns {Date | null} - The parsed date or null if the date is invalid.
+ */
+const parseValidDate = (date) => {
+    if (isValidDate(date)) {
+        return new Date(date);
+    }
+    return null;
+};
 
 exports.addDaysUtil = addDaysUtil;
 exports.addHoursUtil = addHoursUtil;
@@ -1659,6 +1672,7 @@ exports.isTodayUtil = isTodayUtil;
 exports.isValidDate = isValidDate;
 exports.monthNameUtil = monthNameUtil;
 exports.monthsUtil = monthsUtil;
+exports.parseValidDate = parseValidDate;
 exports.startOfDayUtil = startOfDayUtil;
 exports.startOfHourUtil = startOfHourUtil;
 exports.startOfMinuteUtil = startOfMinuteUtil;

package/index.esm.js

@@ -1607,10 +1607,23 @@ const startOfWeek = (date, weekStartsOn) => {
 /**
  *
  * @param date - The date to check if it is valid.
+ * @returns {boolean} - True if the date is valid, false otherwise.
  */
 const isValidDate = (date) => {
     const isDate = new Date(date).getTime();
     return !isNaN(isDate);
 };
+/**
+ * Parses a date, if it is valid, returns a valid Date object, otherwise returns null.
+ *
+ * @param date - The date to parse.
+ * @returns {Date | null} - The parsed date or null if the date is invalid.
+ */
+const parseValidDate = (date) => {
+    if (isValidDate(date)) {
+        return new Date(date);
+    }
+    return null;
+};
 
-export { addDaysUtil, addHoursUtil, addMinutesUtil, addMonthsUtil, addWeeksUtil, addYearsUtil, convertHoursUtil, convertMillisecondsUtil, convertMinutesUtil, convertSecondsUtil, dayNameUtil, daysUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInMonthsUtil, differenceInSecondsUtil, differenceInWeeksUtil, differenceInYearsUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, formatDateUtil, formatRangeUtil, getDurationFormat, getHourCycle, getTimeZone, getTimeZoneOffset, getUTCFromTimeZonedUtil, getWeekUtil, isBetweenUtil, isEqualUtil, isFutureUtil, isPastUtil, isSameDayUtil, isSameMonthUtil, isSameWeekUtil, isSameYearUtil, isTodayUtil, isValidDate, 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 };
+export { addDaysUtil, addHoursUtil, addMinutesUtil, addMonthsUtil, addWeeksUtil, addYearsUtil, convertHoursUtil, convertMillisecondsUtil, convertMinutesUtil, convertSecondsUtil, dayNameUtil, daysUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInMonthsUtil, differenceInSecondsUtil, differenceInWeeksUtil, differenceInYearsUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, formatDateUtil, formatRangeUtil, getDurationFormat, getHourCycle, getTimeZone, getTimeZoneOffset, getUTCFromTimeZonedUtil, getWeekUtil, isBetweenUtil, isEqualUtil, isFutureUtil, isPastUtil, isSameDayUtil, isSameMonthUtil, isSameWeekUtil, isSameYearUtil, isTodayUtil, isValidDate, monthNameUtil, monthsUtil, parseValidDate, 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,6 +1,6 @@
 {
   "name": "@trackunit/date-and-time-utils",
-  "version": "1.10.26",
+  "version": "1.11.7",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/DateAndTimeUtils.d.ts

@@ -1029,6 +1029,14 @@ export declare const convertHoursUtil: (hours: number, unit: Extract<Temporal.Ti
 /**
  *
  * @param date - The date to check if it is valid.
+ * @returns {boolean} - True if the date is valid, false otherwise.
  */
 export declare const isValidDate: (date: Date | string | number) => boolean;
+/**
+ * Parses a date, if it is valid, returns a valid Date object, otherwise returns null.
+ *
+ * @param date - The date to parse.
+ * @returns {Date | null} - The parsed date or null if the date is invalid.
+ */
+export declare const parseValidDate: (date: Date | string | number) => Date | null;
 export {};