@trackunit/react-date-and-time-hooks 1.21.4 → 1.21.6

package/index.cjs.js

@@ -486,6 +486,14 @@ const useDateAndTime = () => {
     const getUTCFromTimeZonedDate = react.useCallback((from, timeZoneId) => {
         return dateAndTimeUtils.getUTCFromTimeZonedUtil(from, timeZoneId);
     }, []);
+    /**
+     * Formats a {@link Date} as a short locale-aware calendar day using the hook's current locale.
+     *
+     * @param {Date | undefined} date - The date to format.
+     * @returns {string} Short date such as `"Mar 7, 2025"` (English), or `""` when the input is
+     * `undefined` or an invalid Date.
+     */
+    const formatShortDate = react.useCallback((date) => dateAndTimeUtils.formatShortDateUtil(date, currentLocale), [currentLocale]);
     return react.useMemo(() => ({
         getNowDate,
         nowDate,
@@ -508,6 +516,11 @@ const useDateAndTime = () => {
         dayName,
         days,
         getUTCFromTimeZonedDate,
+        parseYYYYMMDD: dateAndTimeUtils.parseYYYYMMDDUtil,
+        dateToYYYYMMDD: dateAndTimeUtils.dateToYYYYMMDDUtil,
+        YYYYMMDDToUTCMidnightISO: dateAndTimeUtils.YYYYMMDDToUTCMidnightISOUtil,
+        dateToUTCMidnightISO: dateAndTimeUtils.dateToUTCMidnightISOUtil,
+        formatShortDate,
     }), [
         add,
         convert,
@@ -520,6 +533,7 @@ const useDateAndTime = () => {
         formatDate,
         formatDateWithTimezone,
         formatRange,
+        formatShortDate,
         getNowDate,
         getUTCFromTimeZonedDate,
         monthName,

package/index.esm.js

@@ -1,4 +1,4 @@
-import { getTimeZone, Temporal, toDateUtil, toZonedDateTimeUtil, formatDateUtil, formatRangeUtil, subtractYearsUtil, subtractMonthsUtil, subtractWeeksUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, addYearsUtil, addMonthsUtil, addWeeksUtil, addDaysUtil, addHoursUtil, addMinutesUtil, startOfMonthUtil, startOfWeekUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, differenceInYearsUtil, differenceInMonthsUtil, differenceInWeeksUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInSecondsUtil, isBetweenUtil, isTodayUtil, isFutureUtil, isPastUtil, isSameYearUtil, isSameMonthUtil, isSameWeekUtil, isSameDayUtil, timeSinceInYears, timeSinceInMonths, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInSeconds, timeSinceAuto, toDuration, getDurationFormat, convertMillisecondsUtil, convertSecondsUtil, convertMinutesUtil, convertHoursUtil, dayNameUtil, daysUtil, monthNameUtil, monthsUtil, getUTCFromTimeZonedUtil, isEqualUtil } from '@trackunit/date-and-time-utils';
+import { getTimeZone, Temporal, toDateUtil, toZonedDateTimeUtil, formatDateUtil, formatRangeUtil, subtractYearsUtil, subtractMonthsUtil, subtractWeeksUtil, subtractDaysUtil, subtractHoursUtil, subtractMinutesUtil, addYearsUtil, addMonthsUtil, addWeeksUtil, addDaysUtil, addHoursUtil, addMinutesUtil, startOfMonthUtil, startOfWeekUtil, startOfDayUtil, startOfHourUtil, startOfMinuteUtil, endOfMonthUtil, endOfWeekUtil, endOfDayUtil, endOfHourUtil, endOfMinuteUtil, differenceInYearsUtil, differenceInMonthsUtil, differenceInWeeksUtil, differenceInDaysUtil, differenceInHoursUtil, differenceInMinutesUtil, differenceInSecondsUtil, isBetweenUtil, isTodayUtil, isFutureUtil, isPastUtil, isSameYearUtil, isSameMonthUtil, isSameWeekUtil, isSameDayUtil, timeSinceInYears, timeSinceInMonths, timeSinceInDays, timeSinceInHours, timeSinceInMinutes, timeSinceInSeconds, timeSinceAuto, toDuration, getDurationFormat, convertMillisecondsUtil, convertSecondsUtil, convertMinutesUtil, convertHoursUtil, dayNameUtil, daysUtil, monthNameUtil, monthsUtil, getUTCFromTimeZonedUtil, formatShortDateUtil, dateToUTCMidnightISOUtil, YYYYMMDDToUTCMidnightISOUtil, dateToYYYYMMDDUtil, parseYYYYMMDDUtil, isEqualUtil } from '@trackunit/date-and-time-utils';
 import { exhaustiveCheck } from '@trackunit/shared-utils';
 import { useMemo, useCallback } from 'react';
 import { TimeZonePreference } from '@trackunit/iris-app-runtime-core-api';
@@ -484,6 +484,14 @@ const useDateAndTime = () => {
     const getUTCFromTimeZonedDate = useCallback((from, timeZoneId) => {
         return getUTCFromTimeZonedUtil(from, timeZoneId);
     }, []);
+    /**
+     * Formats a {@link Date} as a short locale-aware calendar day using the hook's current locale.
+     *
+     * @param {Date | undefined} date - The date to format.
+     * @returns {string} Short date such as `"Mar 7, 2025"` (English), or `""` when the input is
+     * `undefined` or an invalid Date.
+     */
+    const formatShortDate = useCallback((date) => formatShortDateUtil(date, currentLocale), [currentLocale]);
     return useMemo(() => ({
         getNowDate,
         nowDate,
@@ -506,6 +514,11 @@ const useDateAndTime = () => {
         dayName,
         days,
         getUTCFromTimeZonedDate,
+        parseYYYYMMDD: parseYYYYMMDDUtil,
+        dateToYYYYMMDD: dateToYYYYMMDDUtil,
+        YYYYMMDDToUTCMidnightISO: YYYYMMDDToUTCMidnightISOUtil,
+        dateToUTCMidnightISO: dateToUTCMidnightISOUtil,
+        formatShortDate,
     }), [
         add,
         convert,
@@ -518,6 +531,7 @@ const useDateAndTime = () => {
         formatDate,
         formatDateWithTimezone,
         formatRange,
+        formatShortDate,
         getNowDate,
         getUTCFromTimeZonedDate,
         monthName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-date-and-time-hooks",
-  "version": "1.21.4",
+  "version": "1.21.6",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -10,14 +10,14 @@
     "@graphql-codegen/cli": "^5.0.3",
     "@graphql-typed-document-node/core": "^3.2.0",
     "zod": "^3.25.76",
-    "@trackunit/iris-app-api": "1.17.4",
-    "@trackunit/react-core-contexts-test": "1.15.14",
-    "@trackunit/date-and-time-utils": "1.11.101",
-    "@trackunit/shared-utils": "1.13.99",
-    "@trackunit/react-core-hooks": "1.15.14",
-    "@trackunit/react-components": "1.22.2",
-    "@trackunit/react-graphql-hooks": "1.22.2",
-    "@trackunit/iris-app-runtime-core-api": "1.14.13"
+    "@trackunit/iris-app-api": "1.17.5",
+    "@trackunit/react-core-contexts-test": "1.15.15",
+    "@trackunit/date-and-time-utils": "1.11.103",
+    "@trackunit/shared-utils": "1.13.100",
+    "@trackunit/react-core-hooks": "1.15.15",
+    "@trackunit/react-components": "1.22.3",
+    "@trackunit/react-graphql-hooks": "1.22.3",
+    "@trackunit/iris-app-runtime-core-api": "1.14.14"
   },
   "peerDependencies": {
     "@apollo/client": "^3.13.8",

package/src/useDateAndTime.d.ts

@@ -34,6 +34,32 @@ interface UseDateAndTimeReturn {
     months: (format?: TemporalFormatStyle) => Array<string>;
     getUTCFromTimeZonedDate: (from: Date, timeZoneId: string) => Date;
     isEqual: (date1: TemporalDate, date2: TemporalDate) => boolean;
+    /**
+     * Parses a strict `YYYY-MM-DD` string into a local-midnight {@link Date}. Returns `null` for
+     * any other format or for an invalid calendar day.
+     */
+    parseYYYYMMDD: (value: string) => Date | null;
+    /**
+     * Converts a {@link Date} to the canonical `YYYY-MM-DD` string for its local calendar day.
+     * Time-zone safe replacement for `date.toISOString().split("T")[0]`. `undefined` and invalid
+     * Dates yield `""`.
+     */
+    dateToYYYYMMDD: (date: Date | undefined) => string;
+    /**
+     * Converts a strict `YYYY-MM-DD` string to the ISO timestamp at UTC midnight for that day.
+     * Returns `null` for invalid input.
+     */
+    YYYYMMDDToUTCMidnightISO: (value: string) => string | null;
+    /**
+     * Converts a {@link Date} to the ISO timestamp at UTC midnight for its local calendar day.
+     * Invalid Dates yield `""`.
+     */
+    dateToUTCMidnightISO: (date: Date) => string;
+    /**
+     * Formats a {@link Date} as a short locale-aware calendar day using the hook's current locale
+     * (e.g. `"Mar 7, 2025"` in English). `undefined` and invalid Dates yield `""`.
+     */
+    formatShortDate: (date: Date | undefined) => string;
 }
 /**
  * Hook for managing date and time operations.