@naturalcycles/js-lib 14.99.2 → 14.100.0

package/dist/datetime/localDate.js

@@ -218,15 +218,23 @@ class LocalDate {
         const [big, small] = sign === 1 ? [this, d] : [d, this];
         if (unit === 'year') {
             let years = big.$year - small.$year;
-            if (big.$month < small.$month || (big.$month === small.$month && big.$day < small.$day)) {
+            if (big.$month < small.$month ||
+                (big.$month === small.$month &&
+                    big.$day < small.$day &&
+                    !(big.$day === LocalDate.getMonthLength(big.$year, big.$month) &&
+                        small.$day === LocalDate.getMonthLength(small.$year, small.$month)))) {
                 years--;
             }
             return years * sign || 0;
         }
         if (unit === 'month') {
             let months = (big.$year - small.$year) * 12 + (big.$month - small.$month);
-            if (big.$day < small.$day)
-                months--;
+            if (big.$day < small.$day) {
+                const bigMonthLen = LocalDate.getMonthLength(big.$year, big.$month);
+                if (big.$day !== bigMonthLen || small.$day < bigMonthLen) {
+                    months--;
+                }
+            }
             return months * sign || 0;
         }
         // unit is 'day' or 'week'
@@ -266,20 +274,36 @@ class LocalDate {
         else if (unit === 'year') {
             $year += num;
         }
+        // check month overflow
+        while ($month > 12) {
+            $year += 1;
+            $month -= 12;
+        }
+        while ($month < 1) {
+            $year -= 1;
+            $month += 12;
+        }
         // check day overflow
-        if (unit === 'day') {
-            if ($day < 1) {
-                while ($day < 1) {
-                    $month -= 1;
-                    if ($month < 1) {
-                        $year -= 1;
-                        $month += 12;
-                    }
-                    $day += LocalDate.getMonthLength($year, $month);
+        // Applies not only for 'day' unit, but also e.g 2022-05-31 plus 1 month should be 2022-06-30 (not 31!)
+        if ($day < 1) {
+            while ($day < 1) {
+                $month -= 1;
+                if ($month < 1) {
+                    $year -= 1;
+                    $month += 12;
+                }
+                $day += LocalDate.getMonthLength($year, $month);
+            }
+        }
+        else {
+            let monLen = LocalDate.getMonthLength($year, $month);
+            if (unit !== 'day') {
+                if ($day > monLen) {
+                    // Case of 2022-05-31 plus 1 month should be 2022-06-30, not 31
+                    $day = monLen;
                 }
             }
             else {
-                let monLen = LocalDate.getMonthLength($year, $month);
                 while ($day > monLen) {
                     $day -= monLen;
                     $month += 1;
@@ -291,15 +315,6 @@ class LocalDate {
                 }
             }
         }
-        // check month overflow
-        while ($month > 12) {
-            $year += 1;
-            $month -= 12;
-        }
-        while ($month < 1) {
-            $year -= 1;
-            $month += 12;
-        }
         if (mutate) {
             this.$year = $year;
             this.$month = $month;

package/dist/datetime/localTime.d.ts

@@ -31,6 +31,10 @@ export declare class LocalTime {
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d: LocalTimeConfig): LocalTime;
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis: number): LocalTime;
     /**
      * Returns null if invalid
      */

package/dist/datetime/localTime.js

@@ -39,6 +39,12 @@ class LocalTime {
         }
         return t;
     }
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis) {
+        return LocalTime.of(new Date(millis));
+    }
     /**
      * Returns null if invalid
      */
@@ -96,7 +102,7 @@ class LocalTime {
         return new LocalTime(new Date());
     }
     static fromComponents(c) {
-        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second));
+        return new LocalTime(new Date(c.year, c.month - 1, c.day || 1, c.hour || 0, c.minute || 0, c.second || 0));
     }
     get(unit) {
         if (unit === 'year') {
@@ -177,14 +183,9 @@ class LocalTime {
     }
     setComponents(c, mutate = false) {
         const d = mutate ? this.$date : new Date(this.$date);
-        if (c.year) {
-            d.setFullYear(c.year);
-        }
-        if (c.month) {
-            d.setMonth(c.month - 1);
-        }
-        if (c.day) {
-            d.setDate(c.day);
+        // Year, month and day set all-at-once, to avoid 30/31 (and 28/29) mishap
+        if (c.day || c.month !== undefined || c.year !== undefined) {
+            d.setFullYear(c.year ?? d.getFullYear(), c.month ? c.month - 1 : d.getMonth(), c.day || d.getDate());
         }
         if (c.hour !== undefined) {
             d.setHours(c.hour);
@@ -202,6 +203,10 @@ class LocalTime {
             num *= 7;
             unit = 'day';
         }
+        if (unit === 'year' || unit === 'month') {
+            const d = addMonths(this.$date, unit === 'month' ? num : num * 12, mutate);
+            return mutate ? this : LocalTime.of(d);
+        }
         return this.set(unit, this.get(unit) + num, mutate);
     }
     subtract(num, unit, mutate = false) {
@@ -215,33 +220,14 @@ class LocalTime {
         const secDiff = (this.$date.valueOf() - date2.valueOf()) / 1000;
         if (!secDiff)
             return 0;
-        if (unit === 'year' || unit === 'month') {
-            const sign = secDiff > 0 ? 1 : -1;
-            // Put items in descending order: "big minus small"
-            const [big, small] = sign === 1 ? [this.$date, date2] : [date2, this.$date];
-            if (unit === 'year') {
-                let years = big.getFullYear() - small.getFullYear();
-                const big2 = new Date(big);
-                const small2 = new Date(small);
-                big2.setFullYear(1584);
-                small2.setFullYear(1584);
-                if (big2 < small2)
-                    years--;
-                return years * sign || 0;
-            }
-            if (unit === 'month') {
-                let months = (big.getFullYear() - small.getFullYear()) * 12 + big.getMonth() - small.getMonth();
-                const big2 = new Date(big);
-                const small2 = new Date(small);
-                big2.setFullYear(1584, 0);
-                small2.setFullYear(1584, 0);
-                if (big2 < small2)
-                    months--;
-                return months * sign || 0;
-            }
-        }
         let r;
-        if (unit === 'day') {
+        if (unit === 'year') {
+            r = differenceInMonths(this.getDate(), date2) / 12;
+        }
+        else if (unit === 'month') {
+            r = differenceInMonths(this.getDate(), date2);
+        }
+        else if (unit === 'day') {
             r = secDiff / SECONDS_IN_DAY;
         }
         else if (unit === 'week') {
@@ -486,7 +472,7 @@ class LocalTime {
         ].join('');
     }
     toString() {
-        return String(this.unix());
+        return this.toISODateTime();
     }
     toJSON() {
         return this.unix();
@@ -543,29 +529,6 @@ function getWeekYear(date) {
         return year - 1;
     }
 }
-// function setWeekYear(
-//   date: Date,
-//   year: number,
-// ): Date {
-//   const diff = differenceInCalendarDays(date, startOfWeekYear(date))
-//   const fourthOfJanuary = new Date(0)
-//   fourthOfJanuary.setFullYear(year, 0, 4)
-//   fourthOfJanuary.setHours(0, 0, 0, 0)
-//   date = startOfWeekYear(fourthOfJanuary)
-//   date.setDate(date.getDate() + diff)
-//   return date
-// }
-// function differenceInCalendarDays(
-//   dateLeft: Date,
-//   dateRight: Date,
-// ): number {
-//   return Math.round((startOfDay(dateLeft).getTime() - startOfDay(dateRight).getTime()) / MILLISECONDS_IN_DAY)
-// }
-// function startOfDay(date: Date, mutate = false): Date {
-//   const d = mutate ? date : new Date(date)
-//   d.setHours(0, 0, 0, 0)
-//   return d
-// }
 // based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/startOfWeek/index.ts
 function startOfWeek(date, mutate = false) {
     const d = mutate ? date : new Date(date);
@@ -583,3 +546,36 @@ function endOfWeek(date, mutate = false) {
     d.setDate(d.getDate() + diff);
     return d;
 }
+function addMonths(d, num, mutate = false) {
+    if (!mutate)
+        d = new Date(d);
+    let day = d.getDate();
+    let month = d.getMonth() + 1 + num;
+    if (day < 29) {
+        d.setMonth(month - 1);
+        return d;
+    }
+    let year = d.getFullYear();
+    while (month > 12) {
+        year++;
+        month -= 12;
+    }
+    while (month < 1) {
+        year--;
+        month += 12;
+    }
+    const monthLen = localDate_1.LocalDate.getMonthLength(year, month);
+    if (day > monthLen)
+        day = monthLen;
+    d.setFullYear(year, month - 1, day);
+    return d;
+}
+function differenceInMonths(a, b) {
+    if (a.getDate() < b.getDate())
+        return -differenceInMonths(b, a);
+    const wholeMonthDiff = (b.getFullYear() - a.getFullYear()) * 12 + (b.getMonth() - a.getMonth());
+    const anchor = addMonths(a, wholeMonthDiff).getTime();
+    const sign = b.getTime() - anchor >= 0 ? 1 : -1;
+    const anchor2 = addMonths(a, wholeMonthDiff + sign).getTime();
+    return -(wholeMonthDiff + ((b.getTime() - anchor) / (anchor2 - anchor)) * sign);
+}

package/dist-esm/datetime/localDate.js

@@ -215,15 +215,23 @@ export class LocalDate {
         const [big, small] = sign === 1 ? [this, d] : [d, this];
         if (unit === 'year') {
             let years = big.$year - small.$year;
-            if (big.$month < small.$month || (big.$month === small.$month && big.$day < small.$day)) {
+            if (big.$month < small.$month ||
+                (big.$month === small.$month &&
+                    big.$day < small.$day &&
+                    !(big.$day === LocalDate.getMonthLength(big.$year, big.$month) &&
+                        small.$day === LocalDate.getMonthLength(small.$year, small.$month)))) {
                 years--;
             }
             return years * sign || 0;
         }
         if (unit === 'month') {
             let months = (big.$year - small.$year) * 12 + (big.$month - small.$month);
-            if (big.$day < small.$day)
-                months--;
+            if (big.$day < small.$day) {
+                const bigMonthLen = LocalDate.getMonthLength(big.$year, big.$month);
+                if (big.$day !== bigMonthLen || small.$day < bigMonthLen) {
+                    months--;
+                }
+            }
             return months * sign || 0;
         }
         // unit is 'day' or 'week'
@@ -263,20 +271,36 @@ export class LocalDate {
         else if (unit === 'year') {
             $year += num;
         }
+        // check month overflow
+        while ($month > 12) {
+            $year += 1;
+            $month -= 12;
+        }
+        while ($month < 1) {
+            $year -= 1;
+            $month += 12;
+        }
         // check day overflow
-        if (unit === 'day') {
-            if ($day < 1) {
-                while ($day < 1) {
-                    $month -= 1;
-                    if ($month < 1) {
-                        $year -= 1;
-                        $month += 12;
-                    }
-                    $day += LocalDate.getMonthLength($year, $month);
+        // Applies not only for 'day' unit, but also e.g 2022-05-31 plus 1 month should be 2022-06-30 (not 31!)
+        if ($day < 1) {
+            while ($day < 1) {
+                $month -= 1;
+                if ($month < 1) {
+                    $year -= 1;
+                    $month += 12;
+                }
+                $day += LocalDate.getMonthLength($year, $month);
+            }
+        }
+        else {
+            let monLen = LocalDate.getMonthLength($year, $month);
+            if (unit !== 'day') {
+                if ($day > monLen) {
+                    // Case of 2022-05-31 plus 1 month should be 2022-06-30, not 31
+                    $day = monLen;
                 }
             }
             else {
-                let monLen = LocalDate.getMonthLength($year, $month);
                 while ($day > monLen) {
                     $day -= monLen;
                     $month += 1;
@@ -288,15 +312,6 @@ export class LocalDate {
                 }
             }
         }
-        // check month overflow
-        while ($month > 12) {
-            $year += 1;
-            $month -= 12;
-        }
-        while ($month < 1) {
-            $year -= 1;
-            $month += 12;
-        }
         if (mutate) {
             this.$year = $year;
             this.$month = $month;

package/dist-esm/datetime/localTime.js

@@ -36,6 +36,12 @@ export class LocalTime {
         }
         return t;
     }
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis) {
+        return LocalTime.of(new Date(millis));
+    }
     /**
      * Returns null if invalid
      */
@@ -93,7 +99,7 @@ export class LocalTime {
         return new LocalTime(new Date());
     }
     static fromComponents(c) {
-        return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second));
+        return new LocalTime(new Date(c.year, c.month - 1, c.day || 1, c.hour || 0, c.minute || 0, c.second || 0));
     }
     get(unit) {
         if (unit === 'year') {
@@ -173,15 +179,11 @@ export class LocalTime {
         return v === undefined ? this.get('second') : this.set('second', v);
     }
     setComponents(c, mutate = false) {
+        var _a;
         const d = mutate ? this.$date : new Date(this.$date);
-        if (c.year) {
-            d.setFullYear(c.year);
-        }
-        if (c.month) {
-            d.setMonth(c.month - 1);
-        }
-        if (c.day) {
-            d.setDate(c.day);
+        // Year, month and day set all-at-once, to avoid 30/31 (and 28/29) mishap
+        if (c.day || c.month !== undefined || c.year !== undefined) {
+            d.setFullYear((_a = c.year) !== null && _a !== void 0 ? _a : d.getFullYear(), c.month ? c.month - 1 : d.getMonth(), c.day || d.getDate());
         }
         if (c.hour !== undefined) {
             d.setHours(c.hour);
@@ -199,6 +201,10 @@ export class LocalTime {
             num *= 7;
             unit = 'day';
         }
+        if (unit === 'year' || unit === 'month') {
+            const d = addMonths(this.$date, unit === 'month' ? num : num * 12, mutate);
+            return mutate ? this : LocalTime.of(d);
+        }
         return this.set(unit, this.get(unit) + num, mutate);
     }
     subtract(num, unit, mutate = false) {
@@ -212,33 +218,14 @@ export class LocalTime {
         const secDiff = (this.$date.valueOf() - date2.valueOf()) / 1000;
         if (!secDiff)
             return 0;
-        if (unit === 'year' || unit === 'month') {
-            const sign = secDiff > 0 ? 1 : -1;
-            // Put items in descending order: "big minus small"
-            const [big, small] = sign === 1 ? [this.$date, date2] : [date2, this.$date];
-            if (unit === 'year') {
-                let years = big.getFullYear() - small.getFullYear();
-                const big2 = new Date(big);
-                const small2 = new Date(small);
-                big2.setFullYear(1584);
-                small2.setFullYear(1584);
-                if (big2 < small2)
-                    years--;
-                return years * sign || 0;
-            }
-            if (unit === 'month') {
-                let months = (big.getFullYear() - small.getFullYear()) * 12 + big.getMonth() - small.getMonth();
-                const big2 = new Date(big);
-                const small2 = new Date(small);
-                big2.setFullYear(1584, 0);
-                small2.setFullYear(1584, 0);
-                if (big2 < small2)
-                    months--;
-                return months * sign || 0;
-            }
-        }
         let r;
-        if (unit === 'day') {
+        if (unit === 'year') {
+            r = differenceInMonths(this.getDate(), date2) / 12;
+        }
+        else if (unit === 'month') {
+            r = differenceInMonths(this.getDate(), date2);
+        }
+        else if (unit === 'day') {
             r = secDiff / SECONDS_IN_DAY;
         }
         else if (unit === 'week') {
@@ -483,7 +470,7 @@ export class LocalTime {
         ].join('');
     }
     toString() {
-        return String(this.unix());
+        return this.toISODateTime();
     }
     toJSON() {
         return this.unix();
@@ -538,29 +525,6 @@ function getWeekYear(date) {
         return year - 1;
     }
 }
-// function setWeekYear(
-//   date: Date,
-//   year: number,
-// ): Date {
-//   const diff = differenceInCalendarDays(date, startOfWeekYear(date))
-//   const fourthOfJanuary = new Date(0)
-//   fourthOfJanuary.setFullYear(year, 0, 4)
-//   fourthOfJanuary.setHours(0, 0, 0, 0)
-//   date = startOfWeekYear(fourthOfJanuary)
-//   date.setDate(date.getDate() + diff)
-//   return date
-// }
-// function differenceInCalendarDays(
-//   dateLeft: Date,
-//   dateRight: Date,
-// ): number {
-//   return Math.round((startOfDay(dateLeft).getTime() - startOfDay(dateRight).getTime()) / MILLISECONDS_IN_DAY)
-// }
-// function startOfDay(date: Date, mutate = false): Date {
-//   const d = mutate ? date : new Date(date)
-//   d.setHours(0, 0, 0, 0)
-//   return d
-// }
 // based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/startOfWeek/index.ts
 function startOfWeek(date, mutate = false) {
     const d = mutate ? date : new Date(date);
@@ -578,3 +542,36 @@ function endOfWeek(date, mutate = false) {
     d.setDate(d.getDate() + diff);
     return d;
 }
+function addMonths(d, num, mutate = false) {
+    if (!mutate)
+        d = new Date(d);
+    let day = d.getDate();
+    let month = d.getMonth() + 1 + num;
+    if (day < 29) {
+        d.setMonth(month - 1);
+        return d;
+    }
+    let year = d.getFullYear();
+    while (month > 12) {
+        year++;
+        month -= 12;
+    }
+    while (month < 1) {
+        year--;
+        month += 12;
+    }
+    const monthLen = LocalDate.getMonthLength(year, month);
+    if (day > monthLen)
+        day = monthLen;
+    d.setFullYear(year, month - 1, day);
+    return d;
+}
+function differenceInMonths(a, b) {
+    if (a.getDate() < b.getDate())
+        return -differenceInMonths(b, a);
+    const wholeMonthDiff = (b.getFullYear() - a.getFullYear()) * 12 + (b.getMonth() - a.getMonth());
+    const anchor = addMonths(a, wholeMonthDiff).getTime();
+    const sign = b.getTime() - anchor >= 0 ? 1 : -1;
+    const anchor2 = addMonths(a, wholeMonthDiff + sign).getTime();
+    return -(wholeMonthDiff + ((b.getTime() - anchor) / (anchor2 - anchor)) * sign);
+}

package/package.json

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

package/src/datetime/localDate.ts

@@ -269,7 +269,15 @@ export class LocalDate {
     if (unit === 'year') {
       let years = big.$year - small.$year
 
-      if (big.$month < small.$month || (big.$month === small.$month && big.$day < small.$day)) {
+      if (
+        big.$month < small.$month ||
+        (big.$month === small.$month &&
+          big.$day < small.$day &&
+          !(
+            big.$day === LocalDate.getMonthLength(big.$year, big.$month) &&
+            small.$day === LocalDate.getMonthLength(small.$year, small.$month)
+          ))
+      ) {
         years--
       }
 
@@ -278,7 +286,12 @@ export class LocalDate {
 
     if (unit === 'month') {
       let months = (big.$year - small.$year) * 12 + (big.$month - small.$month)
-      if (big.$day < small.$day) months--
+      if (big.$day < small.$day) {
+        const bigMonthLen = LocalDate.getMonthLength(big.$year, big.$month)
+        if (big.$day !== bigMonthLen || small.$day < bigMonthLen) {
+          months--
+        }
+      }
       return months * sign || 0
     }
 
@@ -324,21 +337,37 @@ export class LocalDate {
       $year += num
     }
 
+    // check month overflow
+    while ($month > 12) {
+      $year += 1
+      $month -= 12
+    }
+    while ($month < 1) {
+      $year -= 1
+      $month += 12
+    }
+
     // check day overflow
-    if (unit === 'day') {
-      if ($day < 1) {
-        while ($day < 1) {
-          $month -= 1
-          if ($month < 1) {
-            $year -= 1
-            $month += 12
-          }
+    // Applies not only for 'day' unit, but also e.g 2022-05-31 plus 1 month should be 2022-06-30 (not 31!)
+    if ($day < 1) {
+      while ($day < 1) {
+        $month -= 1
+        if ($month < 1) {
+          $year -= 1
+          $month += 12
+        }
 
-          $day += LocalDate.getMonthLength($year, $month)
+        $day += LocalDate.getMonthLength($year, $month)
+      }
+    } else {
+      let monLen = LocalDate.getMonthLength($year, $month)
+
+      if (unit !== 'day') {
+        if ($day > monLen) {
+          // Case of 2022-05-31 plus 1 month should be 2022-06-30, not 31
+          $day = monLen
         }
       } else {
-        let monLen = LocalDate.getMonthLength($year, $month)
-
         while ($day > monLen) {
           $day -= monLen
           $month += 1
@@ -352,16 +381,6 @@ export class LocalDate {
       }
     }
 
-    // check month overflow
-    while ($month > 12) {
-      $year += 1
-      $month -= 12
-    }
-    while ($month < 1) {
-      $year -= 1
-      $month += 12
-    }
-
     if (mutate) {
       this.$year = $year
       this.$month = $month

package/src/datetime/localTime.ts

@@ -56,6 +56,13 @@ export class LocalTime {
     return t
   }
 
+  /**
+   * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+   */
+  static ofMillis(millis: number): LocalTime {
+    return LocalTime.of(new Date(millis))
+  }
+
   /**
    * Returns null if invalid
    */
@@ -123,7 +130,9 @@ export class LocalTime {
   static fromComponents(
     c: { year: number; month: number } & Partial<LocalTimeComponents>,
   ): LocalTime {
-    return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second))
+    return new LocalTime(
+      new Date(c.year, c.month - 1, c.day || 1, c.hour || 0, c.minute || 0, c.second || 0),
+    )
   }
 
   get(unit: LocalTimeUnit): number {
@@ -227,15 +236,15 @@ export class LocalTime {
   setComponents(c: Partial<LocalTimeComponents>, mutate = false): LocalTime {
     const d = mutate ? this.$date : new Date(this.$date)
 
-    if (c.year) {
-      d.setFullYear(c.year)
-    }
-    if (c.month) {
-      d.setMonth(c.month - 1)
-    }
-    if (c.day) {
-      d.setDate(c.day)
+    // Year, month and day set all-at-once, to avoid 30/31 (and 28/29) mishap
+    if (c.day || c.month !== undefined || c.year !== undefined) {
+      d.setFullYear(
+        c.year ?? d.getFullYear(),
+        c.month ? c.month - 1 : d.getMonth(),
+        c.day || d.getDate(),
+      )
     }
+
     if (c.hour !== undefined) {
       d.setHours(c.hour)
     }
@@ -254,6 +263,12 @@ export class LocalTime {
       num *= 7
       unit = 'day'
     }
+
+    if (unit === 'year' || unit === 'month') {
+      const d = addMonths(this.$date, unit === 'month' ? num : num * 12, mutate)
+      return mutate ? this : LocalTime.of(d)
+    }
+
     return this.set(unit, this.get(unit) + num, mutate)
   }
 
@@ -271,37 +286,13 @@ export class LocalTime {
     const secDiff = (this.$date.valueOf() - date2.valueOf()) / 1000
     if (!secDiff) return 0
 
-    if (unit === 'year' || unit === 'month') {
-      const sign = secDiff > 0 ? 1 : -1
-
-      // Put items in descending order: "big minus small"
-      const [big, small] = sign === 1 ? [this.$date, date2] : [date2, this.$date]
-
-      if (unit === 'year') {
-        let years = big.getFullYear() - small.getFullYear()
-        const big2 = new Date(big)
-        const small2 = new Date(small)
-        big2.setFullYear(1584)
-        small2.setFullYear(1584)
-        if (big2 < small2) years--
-        return years * sign || 0
-      }
-
-      if (unit === 'month') {
-        let months =
-          (big.getFullYear() - small.getFullYear()) * 12 + big.getMonth() - small.getMonth()
-        const big2 = new Date(big)
-        const small2 = new Date(small)
-        big2.setFullYear(1584, 0)
-        small2.setFullYear(1584, 0)
-        if (big2 < small2) months--
-        return months * sign || 0
-      }
-    }
-
     let r
 
-    if (unit === 'day') {
+    if (unit === 'year') {
+      r = differenceInMonths(this.getDate(), date2) / 12
+    } else if (unit === 'month') {
+      r = differenceInMonths(this.getDate(), date2)
+    } else if (unit === 'day') {
       r = secDiff / SECONDS_IN_DAY
     } else if (unit === 'week') {
       r = secDiff / (7 * 24 * 60 * 60)
@@ -585,7 +576,7 @@ export class LocalTime {
   }
 
   toString(): string {
-    return String(this.unix())
+    return this.toISODateTime()
   }
 
   toJSON(): UnixTimestampNumber {
@@ -649,32 +640,6 @@ function getWeekYear(date: Date): number {
   }
 }
 
-// function setWeekYear(
-//   date: Date,
-//   year: number,
-// ): Date {
-//   const diff = differenceInCalendarDays(date, startOfWeekYear(date))
-//   const fourthOfJanuary = new Date(0)
-//   fourthOfJanuary.setFullYear(year, 0, 4)
-//   fourthOfJanuary.setHours(0, 0, 0, 0)
-//   date = startOfWeekYear(fourthOfJanuary)
-//   date.setDate(date.getDate() + diff)
-//   return date
-// }
-
-// function differenceInCalendarDays(
-//   dateLeft: Date,
-//   dateRight: Date,
-// ): number {
-//   return Math.round((startOfDay(dateLeft).getTime() - startOfDay(dateRight).getTime()) / MILLISECONDS_IN_DAY)
-// }
-
-// function startOfDay(date: Date, mutate = false): Date {
-//   const d = mutate ? date : new Date(date)
-//   d.setHours(0, 0, 0, 0)
-//   return d
-// }
-
 // based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/startOfWeek/index.ts
 function startOfWeek(date: Date, mutate = false): Date {
   const d = mutate ? date : new Date(date)
@@ -697,3 +662,41 @@ function endOfWeek(date: Date, mutate = false): Date {
   d.setDate(d.getDate() + diff)
   return d
 }
+
+function addMonths(d: Date, num: number, mutate = false): Date {
+  if (!mutate) d = new Date(d)
+
+  let day = d.getDate()
+  let month = d.getMonth() + 1 + num
+
+  if (day < 29) {
+    d.setMonth(month - 1)
+    return d
+  }
+
+  let year = d.getFullYear()
+
+  while (month > 12) {
+    year++
+    month -= 12
+  }
+  while (month < 1) {
+    year--
+    month += 12
+  }
+
+  const monthLen = LocalDate.getMonthLength(year, month)
+  if (day > monthLen) day = monthLen
+
+  d.setFullYear(year, month - 1, day)
+  return d
+}
+
+function differenceInMonths(a: Date, b: Date): number {
+  if (a.getDate() < b.getDate()) return -differenceInMonths(b, a)
+  const wholeMonthDiff = (b.getFullYear() - a.getFullYear()) * 12 + (b.getMonth() - a.getMonth())
+  const anchor = addMonths(a, wholeMonthDiff).getTime()
+  const sign = b.getTime() - anchor >= 0 ? 1 : -1
+  const anchor2 = addMonths(a, wholeMonthDiff + sign).getTime()
+  return -(wholeMonthDiff + ((b.getTime() - anchor) / (anchor2 - anchor)) * sign)
+}