feat(query): add date query convenience methods 🍓

- Add isFuture and isPast methods for temporal comparisons
- Add isSameDay, isSameMonth, isSameQuarter, isSameWeek, and isSameYear methods
- Add isThisMonth, isThisQuarter, isThisWeek, and isThisYear methods
- Add isToday, isTomorrow, and isYesterday methods
- Add test coverage for all query methods
- Update IDaytime interface with new query methods
- Format test code with improved readability

Author: NeaByteLab

src/Daytime.ts

@@ -209,6 +209,15 @@ export class Daytime implements Types.IDaytime {
     return Helpers.isDST(this.date)
   }
 
+  /**
+   * Checks if this date is in the future (after today).
+   * @returns True if this date is in the future, false otherwise
+   */
+  isFuture(): boolean {
+    const now = new Date()
+    return Utils.isAfter(this.date, now)
+  }
+
   /**
    * Checks if the year of the date is a leap year.
    * @returns True if the year is a leap year, false otherwise
@@ -217,6 +226,15 @@ export class Daytime implements Types.IDaytime {
     return Helpers.isLeapYear(this.date)
   }
 
+  /**
+   * Checks if this date is in the past (before today).
+   * @returns True if this date is in the past, false otherwise
+   */
+  isPast(): boolean {
+    const now = new Date()
+    return Utils.isBefore(this.date, now)
+  }
+
   /**
    * Checks if this date is the same as another date.
    * @param other - The other date to compare with
@@ -228,6 +246,24 @@ export class Daytime implements Types.IDaytime {
     return Utils.isSame(this.date, otherDate, unit)
   }
 
+  /**
+   * Checks if this date is the same day as another date.
+   * @param other - The other date to compare with
+   * @returns True if dates are on the same day, false otherwise
+   */
+  isSameDay(other: Types.DateInput): boolean {
+    return this.isSame(other, 'day')
+  }
+
+  /**
+   * Checks if this date is the same month as another date.
+   * @param other - The other date to compare with
+   * @returns True if dates are in the same month, false otherwise
+   */
+  isSameMonth(other: Types.DateInput): boolean {
+    return this.isSame(other, 'month')
+  }
+
   /**
    * Checks if this date is the same as or after another date.
    * @param other - The other date to compare with
@@ -250,6 +286,88 @@ export class Daytime implements Types.IDaytime {
     return Utils.isSameOrBefore(this.date, otherDate, unit)
   }
 
+  /**
+   * Checks if this date is the same quarter as another date.
+   * @param other - The other date to compare with
+   * @returns True if dates are in the same quarter, false otherwise
+   */
+  isSameQuarter(other: Types.DateInput): boolean {
+    return this.isSame(other, 'quarter')
+  }
+
+  /**
+   * Checks if this date is the same week as another date.
+   * @param other - The other date to compare with
+   * @returns True if dates are in the same week, false otherwise
+   */
+  isSameWeek(other: Types.DateInput): boolean {
+    return this.isSame(other, 'week')
+  }
+
+  /**
+   * Checks if this date is the same year as another date.
+   * @param other - The other date to compare with
+   * @returns True if dates are in the same year, false otherwise
+   */
+  isSameYear(other: Types.DateInput): boolean {
+    return this.isSame(other, 'year')
+  }
+
+  /**
+   * Checks if this date is in the current month.
+   * @returns True if this date is in the current month, false otherwise
+   */
+  isThisMonth(): boolean {
+    const now = new Date()
+    return this.isSame(now, 'month')
+  }
+
+  /**
+   * Checks if this date is in the current quarter.
+   * @returns True if this date is in the current quarter, false otherwise
+   */
+  isThisQuarter(): boolean {
+    const now = new Date()
+    return this.isSame(now, 'quarter')
+  }
+
+  /**
+   * Checks if this date is in the current week.
+   * @returns True if this date is in the current week, false otherwise
+   */
+  isThisWeek(): boolean {
+    const now = new Date()
+    return this.isSame(now, 'week')
+  }
+
+  /**
+   * Checks if this date is in the current year.
+   * @returns True if this date is in the current year, false otherwise
+   */
+  isThisYear(): boolean {
+    const now = new Date()
+    return this.isSame(now, 'year')
+  }
+
+  /**
+   * Checks if this date is today.
+   * @returns True if this date is today, false otherwise
+   */
+  isToday(): boolean {
+    const now = new Date()
+    return this.isSame(now, 'day')
+  }
+
+  /**
+   * Checks if this date is tomorrow.
+   * @returns True if this date is tomorrow, false otherwise
+   */
+  isTomorrow(): boolean {
+    const tomorrow = new Date()
+    tomorrow.setDate(tomorrow.getDate() + 1)
+    return this.isSame(tomorrow, 'day')
+  }
+
   /**
    * Checks if the date is valid.
    * @returns True if the date is valid, false otherwise
@@ -274,6 +392,16 @@ export class Daytime implements Types.IDaytime {
     return Helpers.isWeekend(this.date)
   }
 
+  /**
+   * Checks if this date is yesterday.
+   * @returns True if this date is yesterday, false otherwise
+   */
+  isYesterday(): boolean {
+    const yesterday = new Date()
+    yesterday.setDate(yesterday.getDate() - 1)
+    return this.isSame(yesterday, 'day')
+  }
+
   /**
    * Gets the ISO week number (1-53).
    * @returns The ISO week number (1-53)

src/Types.ts

@@ -76,20 +76,48 @@ export interface IDaytime {
   isBusinessDay(): boolean
   /** Checks if the date is in daylight saving time */
   isDST(): boolean
+  /** Checks if the date is in the future */
+  isFuture(): boolean
   /** Checks if the date is a leap year */
   isLeapYear(): boolean
+  /** Checks if the date is in the past */
+  isPast(): boolean
   /** Checks if the date is the same as another date */
   isSame(other: DateInput, unit?: TimeUnit): boolean
+  /** Checks if the date is the same day as another date */
+  isSameDay(other: DateInput): boolean
+  /** Checks if the date is the same month as another date */
+  isSameMonth(other: DateInput): boolean
   /** Checks if the date is the same as or after another date */
   isSameOrAfter(other: DateInput, unit?: TimeUnit): boolean
   /** Checks if the date is the same as or before another date */
   isSameOrBefore(other: DateInput, unit?: TimeUnit): boolean
+  /** Checks if the date is the same quarter as another date */
+  isSameQuarter(other: DateInput): boolean
+  /** Checks if the date is the same week as another date */
+  isSameWeek(other: DateInput): boolean
+  /** Checks if the date is the same year as another date */
+  isSameYear(other: DateInput): boolean
+  /** Checks if the date is in the current month */
+  isThisMonth(): boolean
+  /** Checks if the date is in the current quarter */
+  isThisQuarter(): boolean
+  /** Checks if the date is in the current week */
+  isThisWeek(): boolean
+  /** Checks if the date is in the current year */
+  isThisYear(): boolean
+  /** Checks if the date is today */
+  isToday(): boolean
+  /** Checks if the date is tomorrow */
+  isTomorrow(): boolean
   /** Checks if the date is valid */
   isValid(): boolean
   /** Checks if the date is in UTC */
   isUTC(): boolean
   /** Checks if the date is a weekend */
   isWeekend(): boolean
+  /** Checks if the date is yesterday */
+  isYesterday(): boolean
   /** Gets the ISO week number */
   isoWeek(): number
   /** Gets the ISO weekday number */