@naturalcycles/js-lib 14.186.0 → 14.187.0

package/dist/datetime/localDate.d.ts

@@ -59,6 +59,16 @@ export declare class LocalDate {
      * Third argument allows to override "today".
      */
     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
@@ -77,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

@@ -191,6 +191,18 @@ class LocalDate {
     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".
+     */
+    isYoungerThan(n, unit, today) {
+        return !this.isOlderThan(n, unit, today);
+    }
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal
@@ -340,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;
@@ -97,6 +101,16 @@ export declare class LocalTime {
      * 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".
+     */
+    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));
     }
@@ -369,6 +375,18 @@ class LocalTime {
     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".
+     */
+    isYoungerThan(n, unit, now) {
+        return !this.isOlderThan(n, unit, now);
+    }
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/dist-esm/datetime/localDate.js

@@ -188,6 +188,18 @@ export class LocalDate {
     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".
+     */
+    isYoungerThan(n, unit, today) {
+        return !this.isOlderThan(n, unit, today);
+    }
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal
@@ -337,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));
     }
@@ -367,6 +373,18 @@ export class LocalTime {
     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".
+     */
+    isYoungerThan(n, unit, now) {
+        return !this.isOlderThan(n, unit, now);
+    }
     /**
      * Returns 1 if this > d
      * returns 0 if they are equal

package/package.json

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

package/src/datetime/localDate.ts

@@ -253,6 +253,19 @@ export class LocalDate {
     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".
+   */
+  isYoungerThan(n: number, unit: LocalDateUnitStrict, today?: LocalDateInput): boolean {
+    return !this.isOlderThan(n, unit, today)
+  }
+
   /**
    * Returns 1 if this > d
    * returns 0 if they are equal
@@ -419,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))
   }
@@ -453,6 +460,19 @@ export class LocalTime {
     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".
+   */
+  isYoungerThan(n: number, unit: LocalTimeUnit, now?: LocalTimeInput): boolean {
+    return !this.isOlderThan(n, unit, now)
+  }
+
   /**
    * Returns 1 if this > d
    * returns 0 if they are equal