@naturalcycles/js-lib 14.185.0 → 14.187.0

package/dist/datetime/localDate.d.ts

@@ -55,8 +55,20 @@ export declare class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n: number, unit: LocalDateUnitStrict): boolean;
+    isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean;
+    /**
+     * Checks if this localDate is younger than "today" by X units.
+     *
+     * Example:
+     *
+     * localDate(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "today".
+     */
+    isYoungerThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal
@@ -75,6 +87,10 @@ export declare class LocalDate {
     diff(d: LocalDateInput, unit: LocalDateUnit): number;
     add(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     subtract(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
+    /**
+     * Alias to subtract
+     */
+    minus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     startOf(unit: LocalDateUnitStrict): LocalDate;
     endOf(unit: LocalDateUnitStrict): LocalDate;
     static getYearLength(year: number): number;

package/dist/datetime/localDate.js

@@ -185,9 +185,23 @@ class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
+     */
+    isOlderThan(n, unit, today) {
+        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localDate is younger than "today" by X units.
+     *
+     * Example:
+     *
+     * localDate(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalDate.today().add(-n, unit));
+    isYoungerThan(n, unit, today) {
+        return !this.isOlderThan(n, unit, today);
     }
     /**
      * Returns 1 if this > d
@@ -338,6 +352,12 @@ class LocalDate {
     subtract(num, unit, mutate = false) {
         return this.add(-num, unit, mutate);
     }
+    /**
+     * Alias to subtract
+     */
+    minus(num, unit, mutate = false) {
+        return this.add(-num, unit, mutate);
+    }
     startOf(unit) {
         if (unit === 'day')
             return this;

package/dist/datetime/localTime.d.ts

@@ -72,6 +72,10 @@ export declare class LocalTime {
     setComponents(c: Partial<LocalTimeComponents>, mutate?: boolean): LocalTime;
     add(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     subtract(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
+    /**
+     * Alias to subtract.
+     */
+    minus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     diff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     startOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;
@@ -93,8 +97,20 @@ export declare class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
+     */
+    isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
+    /**
+     * Checks if this localTime is younger than "now" by X units.
+     *
+     * Example:
+     *
+     * localTime(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n: number, unit: LocalTimeUnit): boolean;
+    isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean;
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/dist/datetime/localTime.js

@@ -214,6 +214,12 @@ class LocalTime {
     subtract(num, unit, mutate = false) {
         return this.add(num * -1, unit, mutate);
     }
+    /**
+     * Alias to subtract.
+     */
+    minus(num, unit, mutate = false) {
+        return this.add(num * -1, unit, mutate);
+    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }
@@ -363,9 +369,23 @@ class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
+     */
+    isOlderThan(n, unit, now) {
+        return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localTime is younger than "now" by X units.
+     *
+     * Example:
+     *
+     * localTime(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalTime.now().add(-n, unit));
+    isYoungerThan(n, unit, now) {
+        return !this.isOlderThan(n, unit, now);
     }
     /**
      * Returns 1 if this > d

package/dist-esm/datetime/localDate.js

@@ -182,9 +182,23 @@ export class LocalDate {
      * Example:
      *
      * localDate(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "today".
+     */
+    isOlderThan(n, unit, today) {
+        return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localDate is younger than "today" by X units.
+     *
+     * Example:
+     *
+     * localDate(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "today".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalDate.today().add(-n, unit));
+    isYoungerThan(n, unit, today) {
+        return !this.isOlderThan(n, unit, today);
     }
     /**
      * Returns 1 if this > d
@@ -335,6 +349,12 @@ export class LocalDate {
     subtract(num, unit, mutate = false) {
         return this.add(-num, unit, mutate);
     }
+    /**
+     * Alias to subtract
+     */
+    minus(num, unit, mutate = false) {
+        return this.add(-num, unit, mutate);
+    }
     startOf(unit) {
         if (unit === 'day')
             return this;

package/dist-esm/datetime/localTime.js

@@ -212,6 +212,12 @@ export class LocalTime {
     subtract(num, unit, mutate = false) {
         return this.add(num * -1, unit, mutate);
     }
+    /**
+     * Alias to subtract.
+     */
+    minus(num, unit, mutate = false) {
+        return this.add(num * -1, unit, mutate);
+    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }
@@ -361,9 +367,23 @@ export class LocalTime {
      * Example:
      *
      * localTime(expirationDate).isOlderThan(5, 'day')
+     *
+     * Third argument allows to override "now".
+     */
+    isOlderThan(n, unit, now) {
+        return this.isBefore(LocalTime.of(now !== null && now !== void 0 ? now : new Date()).add(-n, unit));
+    }
+    /**
+     * Checks if this localTime is younger than "now" by X units.
+     *
+     * Example:
+     *
+     * localTime(expirationDate).isYoungerThan(5, 'day')
+     *
+     * Third argument allows to override "now".
      */
-    isOlderThan(n, unit) {
-        return this.isBefore(LocalTime.now().add(-n, unit));
+    isYoungerThan(n, unit, now) {
+        return !this.isOlderThan(n, unit, now);
     }
     /**
      * Returns 1 if this > d

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.185.0",
+  "version": "14.187.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/localDate.ts

@@ -246,9 +246,24 @@ export class LocalDate {
    * Example:
    *
    * localDate(expirationDate).isOlderThan(5, 'day')
+   *
+   * Third argument allows to override "today".
+   */
+  isOlderThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
+    return this.isBefore(LocalDate.of(today || new Date()).add(-n, unit))
+  }
+
+  /**
+   * Checks if this localDate is younger than "today" by X units.
+   *
+   * Example:
+   *
+   * localDate(expirationDate).isYoungerThan(5, 'day')
+   *
+   * Third argument allows to override "today".
    */
-  isOlderThan(n: number, unit: LocalDateUnitStrict): boolean {
-    return this.isBefore(LocalDate.today().add(-n, unit))
+  isYoungerThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
+    return !this.isOlderThan(n, unit, today)
   }
 
   /**
@@ -417,6 +432,13 @@ export class LocalDate {
     return this.add(-num, unit, mutate)
   }
 
+  /**
+   * Alias to subtract
+   */
+  minus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
+    return this.add(-num, unit, mutate)
+  }
+
   startOf(unit: LocalDateUnitStrict): LocalDate {
     if (unit === 'day') return this
     if (unit === 'month') return LocalDate.create(this.$year, this.$month, 1)

package/src/datetime/localTime.ts

@@ -284,6 +284,13 @@ export class LocalTime {
     return this.add(num * -1, unit, mutate)
   }
 
+  /**
+   * Alias to subtract.
+   */
+  minus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
+    return this.add(num * -1, unit, mutate)
+  }
+
   absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number {
     return Math.abs(this.diff(other, unit))
   }
@@ -446,9 +453,24 @@ export class LocalTime {
    * Example:
    *
    * localTime(expirationDate).isOlderThan(5, 'day')
+   *
+   * Third argument allows to override "now".
+   */
+  isOlderThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return this.isBefore(LocalTime.of(now ?? new Date()).add(-n, unit))
+  }
+
+  /**
+   * Checks if this localTime is younger than "now" by X units.
+   *
+   * Example:
+   *
+   * localTime(expirationDate).isYoungerThan(5, 'day')
+   *
+   * Third argument allows to override "now".
    */
-  isOlderThan(n: number, unit: LocalTimeUnit): boolean {
-    return this.isBefore(LocalTime.now().add(-n, unit))
+  isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return !this.isOlderThan(n, unit, now)
   }
 
   /**