@naturalcycles/js-lib 14.233.1 → 14.235.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;

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;

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/number/number.util.d.ts

@@ -22,8 +22,11 @@ export declare function _runLessOften(percent: number): boolean;
  * _isBetween(3, 1, 5) // true
  * _isBetween(5, 1, 5) // false
  * _isBetween(7, 1, 5) // false
+ *
+ * Also works with strings:
+ * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
-export declare function _isBetween(x: number, min: number, max: number, incl?: Inclusiveness): boolean;
+export declare function _isBetween<T extends number | string>(x: T, min: T, max: T, incl?: Inclusiveness): boolean;
 export declare function _clamp(x: number, minIncl: number, maxIncl: number): number;
 /**
  * This function exists, because in JS you cannot just .sort() numbers,

package/dist/number/number.util.js

@@ -34,6 +34,9 @@ exports._runLessOften = _runLessOften;
  * _isBetween(3, 1, 5) // true
  * _isBetween(5, 1, 5) // false
  * _isBetween(7, 1, 5) // false
+ *
+ * Also works with strings:
+ * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
 function _isBetween(x, min, max, incl = '[)') {
     if (incl === '[)') {
@@ -45,7 +48,6 @@ function _isBetween(x, min, max, incl = '[)') {
     else if (incl === '(]') {
         return x > min && x <= max;
     }
-    // ()
     return x > min && x < max;
 }
 exports._isBetween = _isBetween;

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/dist-esm/number/number.util.js

@@ -28,6 +28,9 @@ export function _runLessOften(percent) {
  * _isBetween(3, 1, 5) // true
  * _isBetween(5, 1, 5) // false
  * _isBetween(7, 1, 5) // false
+ *
+ * Also works with strings:
+ * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
 export function _isBetween(x, min, max, incl = '[)') {
     if (incl === '[)') {
@@ -39,7 +42,6 @@ export function _isBetween(x, min, max, incl = '[)') {
     else if (incl === '(]') {
         return x > min && x <= max;
     }
-    // ()
     return x > min && x < max;
 }
 export function _clamp(x, minIncl, maxIncl) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.233.1",
+  "version": "14.235.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
 

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

package/src/number/number.util.ts

@@ -34,11 +34,14 @@ export function _runLessOften(percent: number): boolean {
  * _isBetween(3, 1, 5) // true
  * _isBetween(5, 1, 5) // false
  * _isBetween(7, 1, 5) // false
+ *
+ * Also works with strings:
+ * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
-export function _isBetween(
-  x: number,
-  min: number,
-  max: number,
+export function _isBetween<T extends number | string>(
+  x: T,
+  min: T,
+  max: T,
   incl: Inclusiveness = '[)',
 ): boolean {
   if (incl === '[)') {
@@ -48,7 +51,6 @@ export function _isBetween(
   } else if (incl === '(]') {
     return x > min && x <= max
   }
-  // ()
   return x > min && x < max
 }