@bash-app/bash-common 29.66.0 → 29.68.0

package/src/utils/dateTimeUtils.ts

@@ -1,17 +1,16 @@
-import {DateType, DateValueType} from "react-tailwindcss-datepicker";
-import dayjs, {Dayjs} from "dayjs";
+import { DateType, DateValueType } from "react-tailwindcss-datepicker";
+import dayjs, { Dayjs } from "dayjs";
 import dayjsUtc from "dayjs/plugin/utc";
 import dayjsTimeZone from "dayjs/plugin/timezone";
-import {DateTimeArgType} from "../definitions";
+import { DateTimeArgType } from "../definitions";
 
 dayjs.extend(dayjsUtc);
 dayjs.extend(dayjsTimeZone);
 
-
 const PARSE_TIME_REG = /^(\d{1,2}):(\d{2}) ?([APM]{0,2})$/i;
 
 export const DATETIME_FORMAT_STANDARD = "MMM D, YYYY - h:mm A";
-export const DATETIME_FORMAT_ISO_LIKE = "YYYY-MM-DD HH:mm"
+export const DATETIME_FORMAT_ISO_LIKE = "YYYY-MM-DD HH:mm";
 export const DATE_FORMAT_STANDARD = "MM/DD/YYYY";
 export const DATE_FORMAT_ISO = "YYYY-MM-DD";
 export const TIME_FORMAT_AM_PM = "h:mm A";
@@ -19,27 +18,62 @@ export const TIME_FORMAT_AM_PM = "h:mm A";
 export interface ITime {
   hours: number;
   minutes: number;
-  ampm: 'AM' | 'PM';
+  ampm: "AM" | "PM";
 }
 
-export function formatDateRange(startDateTimeArg: Date | null, endDateTimeArg: Date | null): string {
-  const startDateTime = ensureDateTimeIsLocalDateTime(startDateTimeArg).tz(dayjs.tz.guess());
-  const endDateTime = ensureDateTimeIsLocalDateTime(endDateTimeArg).tz(dayjs.tz.guess());
-  if (startDateTime.isSame(endDateTime, 'day')) {
-      return `${startDateTime.format(DATETIME_FORMAT_STANDARD)} to ${endDateTime.format(TIME_FORMAT_AM_PM)}`;
+export function formatDateRangeBasic(
+  startDateTimeArg: Date | null,
+  endDateTimeArg: Date | null
+): string {
+  const startDateTime = dayjs(startDateTimeArg).tz(dayjs.tz.guess());
+  const endDateTime = dayjs(endDateTimeArg).tz(dayjs.tz.guess());
+  if (startDateTime.isSame(endDateTime, "day")) {
+    return `${startDateTime.format(
+      DATETIME_FORMAT_STANDARD
+    )} to ${endDateTime.format(TIME_FORMAT_AM_PM)}`;
   }
 
-  return `${startDateTime.format(DATETIME_FORMAT_STANDARD)} to ${endDateTime.format(DATETIME_FORMAT_STANDARD)}`;
+  return `${startDateTime.format(
+    DATETIME_FORMAT_STANDARD
+  )} to ${endDateTime.format(DATETIME_FORMAT_STANDARD)}`;
 }
 
-export function ensureIsDateTime(possiblyADate: DateTimeArgType): Date | undefined {
+export function formatDateRange(
+  startDateTimeArg: Date | null,
+  endDateTimeArg: Date | null
+): string {
+  const startDateTime = ensureDateTimeIsLocalDateTime(startDateTimeArg).tz(
+    dayjs.tz.guess()
+  );
+  const endDateTime = ensureDateTimeIsLocalDateTime(endDateTimeArg).tz(
+    dayjs.tz.guess()
+  );
+  if (startDateTime.isSame(endDateTime, "day")) {
+    return `${startDateTime.format(
+      DATETIME_FORMAT_STANDARD
+    )} to ${endDateTime.format(TIME_FORMAT_AM_PM)}`;
+  }
+
+  return `${startDateTime.format(
+    DATETIME_FORMAT_STANDARD
+  )} to ${endDateTime.format(DATETIME_FORMAT_STANDARD)}`;
+}
+
+export function ensureIsDateTime(
+  possiblyADate: DateTimeArgType
+): Date | undefined {
   if (!possiblyADate) {
     return undefined;
   }
-  return typeof possiblyADate === 'string' ? new Date(possiblyADate) : possiblyADate;
+  return typeof possiblyADate === "string"
+    ? new Date(possiblyADate)
+    : possiblyADate;
 }
 
-export function normalizeDate(validDate: Date | string | undefined | null): Date | undefined {
+//convert to utc and round minutes
+export function normalizeDate(
+  validDate: Date | string | undefined | null
+): Date | undefined {
   if (!validDate) return undefined;
 
   const date = new Date(validDate);
@@ -52,14 +86,17 @@ export function normalizeDate(validDate: Date | string | undefined | null): Date
   // Normalize to UTC and start of minute
   return dayjs(date).utc().startOf("minute").toDate();
 }
-export function normalizeDates(dates: (Date | string | undefined | null)[]): Date[] {
+export function normalizeDates(
+  dates: (Date | string | undefined | null)[]
+): Date[] {
   return dates
     .map((date) => normalizeDate(date)) // Normalize each date
     .filter((date): date is Date => !!date); // Filter out invalid dates
 }
 
-
-export function formatDateTimeToISODateTimeString(date: DateTimeArgType): string | undefined {
+export function formatDateTimeToISODateTimeString(
+  date: DateTimeArgType
+): string | undefined {
   if (!date) {
     return undefined;
   }
@@ -67,25 +104,31 @@ export function formatDateTimeToISODateTimeString(date: DateTimeArgType): string
   return date.toISOString();
 }
 
-export function dateWithinDateRange(date: DateTimeArgType, dateRange: DateValueType | undefined): boolean {
-  const startDate = dayjs(dateRange?.startDate).startOf('day').toDate();
-  const endDate = dayjs(dateRange?.endDate).endOf('day').toDate();
+export function dateWithinDateRange(
+  date: DateTimeArgType,
+  dateRange: DateValueType | undefined
+): boolean {
+  const startDate = dayjs(dateRange?.startDate).startOf("day").toDate();
+  const endDate = dayjs(dateRange?.endDate).endOf("day").toDate();
 
-  return compareDateTime(date, startDate) >= 0 &&
-    compareDateTime(date, endDate) < 0;
+  return (
+    compareDateTime(date, startDate) >= 0 && compareDateTime(date, endDate) < 0
+  );
 }
 
-export function findLatestDateTime(date1Arg: DateTimeArgType, date2Arg: DateTimeArgType): Date | undefined {
+export function findLatestDateTime(
+  date1Arg: DateTimeArgType,
+  date2Arg: DateTimeArgType
+): Date | undefined {
   const date1 = dateTimeTypeToDate(date1Arg);
   const date2 = dateTimeTypeToDate(date2Arg);
   return compareDateTime(date1, date2) > 0 ? date1 : date2;
 }
 
 function dateTimeTypeToDate(date: DateTimeArgType): Date | undefined {
-  if (typeof date === 'string') {
+  if (typeof date === "string") {
     return new Date(date);
-  }
-  else {
+  } else {
     return date ?? undefined;
   }
 }
@@ -94,8 +137,10 @@ export function isDateTimeLaterThanNow(date: DateTimeArgType): boolean {
   return compareDateTime(date, new Date()) > 0;
 }
 
-export function areDateTimesEqual(date1: DateTimeArgType,
-                                  date2: DateTimeArgType): boolean {
+export function areDateTimesEqual(
+  date1: DateTimeArgType,
+  date2: DateTimeArgType
+): boolean {
   return compareDateTime(date1, date2) === 0;
 }
 
@@ -104,8 +149,10 @@ export function areDateTimesEqual(date1: DateTimeArgType,
  * @param date1
  * @param date2
  */
-export function compareDateTime(date1: DateTimeArgType,
-                                date2: DateTimeArgType): number {
+export function compareDateTime(
+  date1: DateTimeArgType,
+  date2: DateTimeArgType
+): number {
   if (!date1 && !date2) {
     return 0;
   }
@@ -115,10 +162,10 @@ export function compareDateTime(date1: DateTimeArgType,
   if (!date2) {
     return 1;
   }
-  if (typeof date1 === 'string') {
+  if (typeof date1 === "string") {
     date1 = new Date(date1);
   }
-  if (typeof date2 === 'string') {
+  if (typeof date2 === "string") {
     date2 = new Date(date2);
   }
 
@@ -130,8 +177,7 @@ export function compareDateTime(date1: DateTimeArgType,
   }
   if (date1Time === date2Time) {
     return 0;
-  }
-  else {
+  } else {
     return -1;
   }
 }
@@ -141,8 +187,13 @@ export function setDateButPreserveTime(
   dateWithTheTimeYouWantToKeep: DateType | undefined
 ): Date {
   if (!dateArg || !dateWithTheTimeYouWantToKeep) {
-    console.error("Invalid arguments:", { dateArg, dateWithTheTimeYouWantToKeep });
-    throw new Error("Both dateArg and dateWithTheTimeYouWantToKeep are required.");
+    console.error("Invalid arguments:", {
+      dateArg,
+      dateWithTheTimeYouWantToKeep,
+    });
+    throw new Error(
+      "Both dateArg and dateWithTheTimeYouWantToKeep are required."
+    );
   }
 
   // Get local timezone
@@ -150,7 +201,9 @@ export function setDateButPreserveTime(
 
   // Format date and time parts
   const datePart = dayjs(dateArg).tz(localTimeZone).format("YYYY-MM-DD"); // Local date
-  const timePart = dayjs(dateWithTheTimeYouWantToKeep).tz(localTimeZone).format("HH:mm"); // Local time
+  const timePart = dayjs(dateWithTheTimeYouWantToKeep)
+    .tz(localTimeZone)
+    .format("HH:mm"); // Local time
 
   // Combine into an ISO string
   const combinedDateTimeString = `${datePart}T${timePart}`;
@@ -162,7 +215,9 @@ export function setDateButPreserveTime(
   });
 
   // Convert to UTC
-  const combinedDateTime = dayjs.tz(combinedDateTimeString, localTimeZone).toDate();
+  const combinedDateTime = dayjs
+    .tz(combinedDateTimeString, localTimeZone)
+    .toDate();
   if (isNaN(combinedDateTime.getTime())) {
     console.error("Invalid combined datetime:", combinedDateTimeString);
     throw new Error("Invalid date or time format.");
@@ -172,8 +227,10 @@ export function setDateButPreserveTime(
   return combinedDateTime;
 }
 
-
-export function setTimeOnDate(date: DateType | Date | undefined, parsedTime: ITime | null): Date {
+export function setTimeOnDate(
+  date: DateType | Date | undefined,
+  parsedTime: ITime | null
+): Date {
   const isValidDate = dayjs(date).isValid();
   const dateTime = new Date(isValidDate && date ? date : Date.now());
   if (parsedTime) {
@@ -185,23 +242,28 @@ export function setTimeOnDate(date: DateType | Date | undefined, parsedTime: ITi
   return dateTime;
 }
 
-export function ensureDateTimeIsLocalDateTime(dateArg: DateType | Dayjs | undefined): Dayjs {
+export function ensureDateTimeIsLocalDateTime(
+  dateArg: DateType | Dayjs | undefined
+): Dayjs {
   if (dayjs(dateArg).isUTC()) {
     const dateLocalTimeZone = dayjs(dateArg);
     return dateLocalTimeZone;
-  }
-  else {
+  } else {
     return dayjs(dateArg ?? Date.now());
   }
 }
 
-export function formatDateTimeToTimeString(date: Date | string | undefined | null): string {
+export function formatDateTimeToTimeString(
+  date: Date | string | undefined | null
+): string {
   date = new Date(date ?? Date.now());
   const result = dayjs(date).format("h:mm A");
   return result;
 }
 
-export function formatDateTimeToTimeString24hr(date: Date | string | undefined | null): string {
+export function formatDateTimeToTimeString24hr(
+  date: Date | string | undefined | null
+): string {
   date = new Date(date ?? Date.now());
   const result = dayjs(date).format("h:mm");
   return result;
@@ -215,24 +277,22 @@ export function parseTimeString(timeStr: string): ITime | null {
     const minutes = parseInt(match[2], 10);
     const ampm = match[3].toUpperCase();
 
-    if ((hours >= 0 && hours <= 12) && (minutes >= 0 && minutes <= 59) && (ampm === 'AM' || ampm === 'PM')) {
+    if (
+      hours >= 0 &&
+      hours <= 12 &&
+      minutes >= 0 &&
+      minutes <= 59 &&
+      (ampm === "AM" || ampm === "PM")
+    ) {
       return {
-        hours: ampm === 'PM' && hours < 12 ? hours + 12 : hours,
+        hours: ampm === "PM" && hours < 12 ? hours + 12 : hours,
         minutes,
-        ampm };
+        ampm,
+      };
     }
   }
   return null;
 }
-
-export function localDateToUTC(date: Date): Date {
-  const newDate = new Date(date.getUTCFullYear(), date.getUTCMonth(),
-              date.getUTCDate(), date.getUTCHours(),
-              date.getUTCMinutes(), date.getUTCSeconds());
-
-  return newDate;
+export function timestampMinutesFromNow(minutes: number): number {
+  return Math.floor(new Date().getTime() / 1000 + minutes * 60);
 }
-
-export function timestampMinutseFromNow(minutes: number): number {
-  return Math.floor((new Date().getTime() / 1000) + (minutes * 60));
-}

package/src/utils/generalDateTimeUtils.ts

@@ -0,0 +1,43 @@
+import { DayOfWeek } from "@prisma/client";
+
+export type DayOfWeekIdx = 1 | 2 | 3 | 4 | 5 | 6 | 7;
+
+export const dayOfWeekToString: { [key in DayOfWeek]: string } = {
+  [DayOfWeek.Monday]: "M",
+  [DayOfWeek.Tuesday]: "T",
+  [DayOfWeek.Wednesday]: "W",
+  [DayOfWeek.Thursday]: "TR",
+  [DayOfWeek.Friday]: "F",
+  [DayOfWeek.Saturday]: "S",
+  [DayOfWeek.Sunday]: "S",
+} as const;
+
+export const dayOfWeekToIdx: { [key in DayOfWeek]: DayOfWeekIdx } = {
+  [DayOfWeek.Monday]: 1,
+  [DayOfWeek.Tuesday]: 2,
+  [DayOfWeek.Wednesday]: 3,
+  [DayOfWeek.Thursday]: 4,
+  [DayOfWeek.Friday]: 5,
+  [DayOfWeek.Saturday]: 6,
+  [DayOfWeek.Sunday]: 7,
+} as const;
+
+export const dayOfWeekIdxToDayOfWeek: { [key in DayOfWeekIdx]: DayOfWeek } = {
+  [1]: DayOfWeek.Monday,
+  [2]: DayOfWeek.Tuesday,
+  [3]: DayOfWeek.Wednesday,
+  [4]: DayOfWeek.Thursday,
+  [5]: DayOfWeek.Friday,
+  [6]: DayOfWeek.Saturday,
+  [7]: DayOfWeek.Sunday,
+} as const;
+
+export const dayOfWeekIdxToDay: { [key in DayOfWeekIdx]: DayOfWeekIdx } = {
+  [7]: 1,
+  [1]: 2,
+  [2]: 3,
+  [3]: 4,
+  [4]: 5,
+  [5]: 6,
+  [6]: 7,
+} as const;