@naturalcycles/js-lib 14.233.0 → 14.234.0

package/dist/datetime/localDate.d.ts

@@ -73,6 +73,14 @@ export declare class LocalDate {
      * a.diff(b) means "a minus b"
      */
     diff(d: LocalDateInput, unit: LocalDateUnit): number;
+    plusDays(num: number): LocalDate;
+    plusWeeks(num: number): LocalDate;
+    plusMonths(num: number): LocalDate;
+    plusYears(num: number): LocalDate;
+    minusDays(num: number): LocalDate;
+    minusWeeks(num: number): LocalDate;
+    minusMonths(num: number): LocalDate;
+    minusYears(num: number): LocalDate;
     plus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     minus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     startOf(unit: LocalDateUnitStrict): LocalDate;
@@ -221,11 +229,11 @@ declare class LocalDateFactory {
      *
      * Similar to `localDate.orToday`, but that will instead return Today on falsy input.
      */
-    orUndefined(d?: LocalDateInput | null): LocalDate | undefined;
+    orUndefined(d: LocalDateInput | null | undefined): LocalDate | undefined;
     /**
      * Creates a LocalDate from the input, unless it's falsy - then returns localDate.today.
      */
-    orToday(d?: LocalDateInput | null): LocalDate;
+    orToday(d: LocalDateInput | null | undefined): LocalDate;
 }
 interface LocalDateFn extends LocalDateFactory {
     (d: LocalDateInput): LocalDate;

package/dist/datetime/localDate.js

@@ -190,6 +190,30 @@ class LocalDate {
         }
         return days * sign || 0;
     }
+    plusDays(num) {
+        return this.plus(num, 'day');
+    }
+    plusWeeks(num) {
+        return this.plus(num, 'week');
+    }
+    plusMonths(num) {
+        return this.plus(num, 'month');
+    }
+    plusYears(num) {
+        return this.plus(num, 'year');
+    }
+    minusDays(num) {
+        return this.plus(-num, 'day');
+    }
+    minusWeeks(num) {
+        return this.plus(-num, 'week');
+    }
+    minusMonths(num) {
+        return this.plus(-num, 'month');
+    }
+    minusYears(num) {
+        return this.plus(-num, 'year');
+    }
     plus(num, unit, mutate = false) {
         let { $day, $month, $year } = this;
         if (unit === 'week') {

package/dist/datetime/localTime.d.ts

@@ -58,6 +58,20 @@ export declare class LocalTime {
     second(): number;
     second(v: number): LocalTime;
     setComponents(c: Partial<LocalTimeComponents>, mutate?: boolean): LocalTime;
+    plusSeconds(num: number): LocalTime;
+    plusMinutes(num: number): LocalTime;
+    plusHours(num: number): LocalTime;
+    plusDays(num: number): LocalTime;
+    plusWeeks(num: number): LocalTime;
+    plusMonths(num: number): LocalTime;
+    plusYears(num: number): LocalTime;
+    minusSeconds(num: number): LocalTime;
+    minusMinutes(num: number): LocalTime;
+    minusHours(num: number): LocalTime;
+    minusDays(num: number): LocalTime;
+    minusWeeks(num: number): LocalTime;
+    minusMonths(num: number): LocalTime;
+    minusYears(num: number): LocalTime;
     plus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     minus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number;
@@ -169,11 +183,11 @@ declare class LocalTimeFactory {
      *
      * `localTime` function will instead return LocalTime of `now` for falsy input.
      */
-    orUndefined(d?: LocalTimeInput | null): LocalTime | undefined;
+    orUndefined(d: LocalTimeInput | null | undefined): LocalTime | undefined;
     /**
      * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
      */
-    orNow(d?: LocalTimeInput | null): LocalTime;
+    orNow(d: LocalTimeInput | null | undefined): LocalTime;
     fromComponents(c: {
         year: number;
         month: number;

package/dist/datetime/localTime.js

@@ -131,6 +131,48 @@ class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
+    plusSeconds(num) {
+        return this.plus(num, 'second');
+    }
+    plusMinutes(num) {
+        return this.plus(num, 'minute');
+    }
+    plusHours(num) {
+        return this.plus(num, 'hour');
+    }
+    plusDays(num) {
+        return this.plus(num, 'day');
+    }
+    plusWeeks(num) {
+        return this.plus(num, 'week');
+    }
+    plusMonths(num) {
+        return this.plus(num, 'month');
+    }
+    plusYears(num) {
+        return this.plus(num, 'year');
+    }
+    minusSeconds(num) {
+        return this.plus(-num, 'second');
+    }
+    minusMinutes(num) {
+        return this.plus(-num, 'minute');
+    }
+    minusHours(num) {
+        return this.plus(-num, 'hour');
+    }
+    minusDays(num) {
+        return this.plus(-num, 'day');
+    }
+    minusWeeks(num) {
+        return this.plus(-num, 'week');
+    }
+    minusMonths(num) {
+        return this.plus(-num, 'month');
+    }
+    minusYears(num) {
+        return this.plus(-num, 'year');
+    }
     plus(num, unit, mutate = false) {
         if (unit === 'week') {
             num *= 7;

package/dist-esm/datetime/localDate.js

@@ -187,6 +187,30 @@ export class LocalDate {
         }
         return days * sign || 0;
     }
+    plusDays(num) {
+        return this.plus(num, 'day');
+    }
+    plusWeeks(num) {
+        return this.plus(num, 'week');
+    }
+    plusMonths(num) {
+        return this.plus(num, 'month');
+    }
+    plusYears(num) {
+        return this.plus(num, 'year');
+    }
+    minusDays(num) {
+        return this.plus(-num, 'day');
+    }
+    minusWeeks(num) {
+        return this.plus(-num, 'week');
+    }
+    minusMonths(num) {
+        return this.plus(-num, 'month');
+    }
+    minusYears(num) {
+        return this.plus(-num, 'year');
+    }
     plus(num, unit, mutate = false) {
         let { $day, $month, $year } = this;
         if (unit === 'week') {

package/dist-esm/datetime/localTime.js

@@ -129,6 +129,48 @@ export class LocalTime {
         }
         return mutate ? this : new LocalTime(d);
     }
+    plusSeconds(num) {
+        return this.plus(num, 'second');
+    }
+    plusMinutes(num) {
+        return this.plus(num, 'minute');
+    }
+    plusHours(num) {
+        return this.plus(num, 'hour');
+    }
+    plusDays(num) {
+        return this.plus(num, 'day');
+    }
+    plusWeeks(num) {
+        return this.plus(num, 'week');
+    }
+    plusMonths(num) {
+        return this.plus(num, 'month');
+    }
+    plusYears(num) {
+        return this.plus(num, 'year');
+    }
+    minusSeconds(num) {
+        return this.plus(-num, 'second');
+    }
+    minusMinutes(num) {
+        return this.plus(-num, 'minute');
+    }
+    minusHours(num) {
+        return this.plus(-num, 'hour');
+    }
+    minusDays(num) {
+        return this.plus(-num, 'day');
+    }
+    minusWeeks(num) {
+        return this.plus(-num, 'week');
+    }
+    minusMonths(num) {
+        return this.plus(-num, 'month');
+    }
+    minusYears(num) {
+        return this.plus(-num, 'year');
+    }
     plus(num, unit, mutate = false) {
         if (unit === 'week') {
             num *= 7;

package/package.json

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

package/src/datetime/localDate.ts

@@ -233,6 +233,31 @@ export class LocalDate {
     return days * sign || 0
   }
 
+  plusDays(num: number): LocalDate {
+    return this.plus(num, 'day')
+  }
+  plusWeeks(num: number): LocalDate {
+    return this.plus(num, 'week')
+  }
+  plusMonths(num: number): LocalDate {
+    return this.plus(num, 'month')
+  }
+  plusYears(num: number): LocalDate {
+    return this.plus(num, 'year')
+  }
+  minusDays(num: number): LocalDate {
+    return this.plus(-num, 'day')
+  }
+  minusWeeks(num: number): LocalDate {
+    return this.plus(-num, 'week')
+  }
+  minusMonths(num: number): LocalDate {
+    return this.plus(-num, 'month')
+  }
+  minusYears(num: number): LocalDate {
+    return this.plus(-num, 'year')
+  }
+
   plus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
     let { $day, $month, $year } = this
 
@@ -665,14 +690,14 @@ class LocalDateFactory {
    *
    * Similar to `localDate.orToday`, but that will instead return Today on falsy input.
    */
-  orUndefined(d?: LocalDateInput | null): LocalDate | undefined {
+  orUndefined(d: LocalDateInput | null | undefined): LocalDate | undefined {
     return d ? this.of(d) : undefined
   }
 
   /**
    * Creates a LocalDate from the input, unless it's falsy - then returns localDate.today.
    */
-  orToday(d?: LocalDateInput | null): LocalDate {
+  orToday(d: LocalDateInput | null | undefined): LocalDate {
     return d ? this.of(d) : this.today()
   }
 }

package/src/datetime/localTime.ts

@@ -191,6 +191,49 @@ export class LocalTime {
     return mutate ? this : new LocalTime(d)
   }
 
+  plusSeconds(num: number): LocalTime {
+    return this.plus(num, 'second')
+  }
+  plusMinutes(num: number): LocalTime {
+    return this.plus(num, 'minute')
+  }
+  plusHours(num: number): LocalTime {
+    return this.plus(num, 'hour')
+  }
+  plusDays(num: number): LocalTime {
+    return this.plus(num, 'day')
+  }
+  plusWeeks(num: number): LocalTime {
+    return this.plus(num, 'week')
+  }
+  plusMonths(num: number): LocalTime {
+    return this.plus(num, 'month')
+  }
+  plusYears(num: number): LocalTime {
+    return this.plus(num, 'year')
+  }
+  minusSeconds(num: number): LocalTime {
+    return this.plus(-num, 'second')
+  }
+  minusMinutes(num: number): LocalTime {
+    return this.plus(-num, 'minute')
+  }
+  minusHours(num: number): LocalTime {
+    return this.plus(-num, 'hour')
+  }
+  minusDays(num: number): LocalTime {
+    return this.plus(-num, 'day')
+  }
+  minusWeeks(num: number): LocalTime {
+    return this.plus(-num, 'week')
+  }
+  minusMonths(num: number): LocalTime {
+    return this.plus(-num, 'month')
+  }
+  minusYears(num: number): LocalTime {
+    return this.plus(-num, 'year')
+  }
+
   plus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
     if (unit === 'week') {
       num *= 7
@@ -638,14 +681,14 @@ class LocalTimeFactory {
    *
    * `localTime` function will instead return LocalTime of `now` for falsy input.
    */
-  orUndefined(d?: LocalTimeInput | null): LocalTime | undefined {
+  orUndefined(d: LocalTimeInput | null | undefined): LocalTime | undefined {
     return d ? this.of(d) : undefined
   }
 
   /**
    * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
    */
-  orNow(d?: LocalTimeInput | null): LocalTime {
+  orNow(d: LocalTimeInput | null | undefined): LocalTime {
     return d ? this.of(d) : this.now()
   }