@trackunit/date-and-time-utils 1.17.5 → 1.17.6

package/index.cjs.js

@@ -1745,6 +1745,25 @@ const parseValidDate = (date) => {
     return null;
 };
 
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Parses a strict ISO date-only value without applying a timezone.
+ *
+ * @param value The date-only value in `YYYY-MM-DD` format.
+ * @returns {Temporal.PlainDate | undefined} The parsed calendar date, or `undefined` when the value is invalid.
+ */
+const parseCalendarDate = (value) => {
+    if (!DATE_ONLY_PATTERN.test(value)) {
+        return undefined;
+    }
+    try {
+        return polyfill.Temporal.PlainDate.from(value, { overflow: "reject" });
+    }
+    catch {
+        return undefined;
+    }
+};
+
 Object.defineProperty(exports, "Temporal", {
     enumerable: true,
     get: function () { return polyfill.Temporal; }
@@ -1793,6 +1812,7 @@ exports.isTodayUtil = isTodayUtil;
 exports.isValidDate = isValidDate;
 exports.monthNameUtil = monthNameUtil;
 exports.monthsUtil = monthsUtil;
+exports.parseCalendarDate = parseCalendarDate;
 exports.parseValidDate = parseValidDate;
 exports.startOfDayUtil = startOfDayUtil;
 exports.startOfHourUtil = startOfHourUtil;

package/index.esm.js

@@ -1744,4 +1744,23 @@ const parseValidDate = (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, parseValidDate, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, startOfMonthUtil, startOfWeekUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, subtractMonthsUtil, subtractWeeksUtil, subtractYearsUtil, timeFormatToHourCycle, timeSinceAuto, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInMonths, timeSinceInSeconds, timeSinceInYears, timeZonesAvailable, toDateUtil, toDuration, toInstantUtil, toTemporalUtil, toZonedDateTimeUtil };
+const DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * Parses a strict ISO date-only value without applying a timezone.
+ *
+ * @param value The date-only value in `YYYY-MM-DD` format.
+ * @returns {Temporal.PlainDate | undefined} The parsed calendar date, or `undefined` when the value is invalid.
+ */
+const parseCalendarDate = (value) => {
+    if (!DATE_ONLY_PATTERN.test(value)) {
+        return undefined;
+    }
+    try {
+        return Temporal.PlainDate.from(value, { overflow: "reject" });
+    }
+    catch {
+        return undefined;
+    }
+};
+
+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, parseCalendarDate, parseValidDate, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, startOfMonthUtil, startOfWeekUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, subtractMonthsUtil, subtractWeeksUtil, subtractYearsUtil, timeFormatToHourCycle, 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.17.5",
+  "version": "1.17.6",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./DateAndTimeUtils";
+export * from "./parseCalendarDate";
 export { Temporal } from "./temporal";

package/src/parseCalendarDate.d.ts

@@ -0,0 +1,8 @@
+import { Temporal } from "./temporal";
+/**
+ * Parses a strict ISO date-only value without applying a timezone.
+ *
+ * @param value The date-only value in `YYYY-MM-DD` format.
+ * @returns {Temporal.PlainDate | undefined} The parsed calendar date, or `undefined` when the value is invalid.
+ */
+export declare const parseCalendarDate: (value: string) => Temporal.PlainDate | undefined;