@trackunit/react-date-and-time-hooks 1.21.0 → 1.21.2

package/index.cjs.js

@@ -154,12 +154,10 @@ const useDateAndTime = () => {
     const currentLocale = useLocale();
     const { current, assetTimeZone, preferred } = useTimezone();
     const currentTimeZone = react.useMemo(() => current.id || preferred.id || assetTimeZone?.id, [current, assetTimeZone, preferred]);
+    const getNowDate = react.useCallback(() => {
+        return dateAndTimeUtils.toDateUtil(dateAndTimeUtils.toZonedDateTimeUtil(dateAndTimeUtils.Temporal.Now.instant(), currentTimeZone));
+    }, [currentTimeZone]);
     const currentDate = react.useMemo(() => dateAndTimeUtils.toZonedDateTimeUtil(dateAndTimeUtils.Temporal.Now.instant(), currentTimeZone), [currentTimeZone]);
-    /**
-     * Returns the current date and time.
-     *
-     * @returns {Date}
-     */
     const nowDate = react.useMemo(() => dateAndTimeUtils.toDateUtil(currentDate), [currentDate]);
     /**
      * Formats a date using the current locale and time zone.
@@ -489,6 +487,7 @@ const useDateAndTime = () => {
         return dateAndTimeUtils.getUTCFromTimeZonedUtil(from, timeZoneId);
     }, []);
     return react.useMemo(() => ({
+        getNowDate,
         nowDate,
         formatDate,
         formatDateWithTimezone,
@@ -521,6 +520,7 @@ const useDateAndTime = () => {
         formatDate,
         formatDateWithTimezone,
         formatRange,
+        getNowDate,
         getUTCFromTimeZonedDate,
         monthName,
         months,

package/index.esm.js

@@ -1,4 +1,4 @@
-import { getTimeZone, Temporal, toZonedDateTimeUtil, toDateUtil, 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, 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';
@@ -152,12 +152,10 @@ const useDateAndTime = () => {
     const currentLocale = useLocale();
     const { current, assetTimeZone, preferred } = useTimezone();
     const currentTimeZone = useMemo(() => current.id || preferred.id || assetTimeZone?.id, [current, assetTimeZone, preferred]);
+    const getNowDate = useCallback(() => {
+        return toDateUtil(toZonedDateTimeUtil(Temporal.Now.instant(), currentTimeZone));
+    }, [currentTimeZone]);
     const currentDate = useMemo(() => toZonedDateTimeUtil(Temporal.Now.instant(), currentTimeZone), [currentTimeZone]);
-    /**
-     * Returns the current date and time.
-     *
-     * @returns {Date}
-     */
     const nowDate = useMemo(() => toDateUtil(currentDate), [currentDate]);
     /**
      * Formats a date using the current locale and time zone.
@@ -487,6 +485,7 @@ const useDateAndTime = () => {
         return getUTCFromTimeZonedUtil(from, timeZoneId);
     }, []);
     return useMemo(() => ({
+        getNowDate,
         nowDate,
         formatDate,
         formatDateWithTimezone,
@@ -519,6 +518,7 @@ const useDateAndTime = () => {
         formatDate,
         formatDateWithTimezone,
         formatRange,
+        getNowDate,
         getUTCFromTimeZonedDate,
         monthName,
         months,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-date-and-time-hooks",
-  "version": "1.21.0",
+  "version": "1.21.2",
   "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.2",
-    "@trackunit/react-core-contexts-test": "1.15.12",
-    "@trackunit/date-and-time-utils": "1.11.99",
-    "@trackunit/shared-utils": "1.13.97",
-    "@trackunit/react-core-hooks": "1.15.12",
-    "@trackunit/react-components": "1.22.0",
-    "@trackunit/react-graphql-hooks": "1.22.0",
-    "@trackunit/iris-app-runtime-core-api": "1.14.11"
+    "@trackunit/iris-app-api": "1.17.3",
+    "@trackunit/react-core-contexts-test": "1.15.13",
+    "@trackunit/date-and-time-utils": "1.11.100",
+    "@trackunit/shared-utils": "1.13.98",
+    "@trackunit/react-core-hooks": "1.15.13",
+    "@trackunit/react-components": "1.22.1",
+    "@trackunit/react-graphql-hooks": "1.22.1",
+    "@trackunit/iris-app-runtime-core-api": "1.14.12"
   },
   "peerDependencies": {
     "@apollo/client": "^3.13.8",

package/src/useDateAndTime.d.ts

@@ -9,6 +9,11 @@ export type TemporalIsType = "past" | "present" | "future" | "between";
 export type TemporalSameType = Extract<TemporalTypes, "day" | "week" | "month" | "year">;
 export type TemporalTimeRounding = Extract<TemporalTypes, "hour" | "minute" | "second">;
 interface UseDateAndTimeReturn {
+    /** Current instant in the active timezone as a `Date`. Call when you need “now”; the function reference is stable until the timezone changes; each call returns a fresh time. */
+    getNowDate: () => Date;
+    /**
+     * @deprecated Use `getNowDate()` instead. This snapshot only updates when the active timezone changes, not as wall-clock time advances (so long-lived sessions can show stale “now”).
+     */
     nowDate: Date;
     formatDate: (date: TemporalDate, format?: TemporalFormat) => string;
     formatDateWithTimezone: (date: TemporalDate, format?: TemporalFormat, timezone?: string, locale?: string) => string;