feat: localDate/localTime.getAgeIn

Author: kirillgroshkov

src/datetime/localDate.test.ts

@@ -64,6 +64,10 @@ test('basic', () => {
   expect(ld.isYoungerThan(5, 'day')).toBe(false)
   expect(ld.isOlderThan(100, 'year')).toBe(false)
   expect(ld.isYoungerThan(100, 'year')).toBe(true)
+  expect(ld.getAgeInYears('2024-05-15')).toBe(39)
+  expect(ld.getAgeInMonths('2024-05-15')).toBe(478)
+  expect(ld.getAgeInDays('2024-05-15')).toBe(14573)
+  expect(ld.getAgeIn('day', '2024-05-15')).toBe(14573)
 })
 
 test('isBetween', () => {

src/datetime/localDate.ts

@@ -141,6 +141,19 @@ export class LocalDate {
     return this.isSameOrAfter(localDate.of(today || new Date()).plus(-n, unit))
   }
 
+  getAgeInYears(today?: LocalDateInput): number {
+    return this.getAgeIn('year', today)
+  }
+  getAgeInMonths(today?: LocalDateInput): number {
+    return this.getAgeIn('month', today)
+  }
+  getAgeInDays(today?: LocalDateInput): number {
+    return this.getAgeIn('day', today)
+  }
+  getAgeIn(unit: LocalDateUnit, today?: LocalDateInput): number {
+    return localDate.of(today || new Date()).diff(this, unit)
+  }
+
   /**
    * Returns 1 if this > d
    * returns 0 if they are equal

src/datetime/localTime.test.ts

@@ -46,6 +46,10 @@ test('basic', () => {
   expect(lt.isOlderThan(5, 'day')).toBe(true)
   expect(lt.isYoungerThan(5, 'day')).toBe(false)
   expect(lt.isOlderThan(100, 'year')).toBe(false)
+  expect(lt.getAgeInYears('2024-05-15')).toBe(2)
+  expect(lt.getAgeInMonths('2024-05-15')).toBe(28)
+  expect(lt.getAgeInDays('2024-05-15')).toBe(865)
+  expect(lt.getAgeIn('day', '2024-05-15')).toBe(865)
 
   expect(lt.year(2023).year()).toBe(2023)
   expect(lt.year()).toBe(2022) // not changed

src/datetime/localTime.ts

@@ -500,6 +500,28 @@ export class LocalTime {
     return this.isSameOrAfter(localTime.of(now ?? new Date()).plus(-n, unit))
   }
 
+  getAgeInYears(now?: LocalTimeInput): number {
+    return this.getAgeIn('year', now)
+  }
+  getAgeInMonths(now?: LocalTimeInput): number {
+    return this.getAgeIn('month', now)
+  }
+  getAgeInDays(now?: LocalTimeInput): number {
+    return this.getAgeIn('day', now)
+  }
+  getAgeInHours(now?: LocalTimeInput): number {
+    return this.getAgeIn('hour', now)
+  }
+  getAgeInMinutes(now?: LocalTimeInput): number {
+    return this.getAgeIn('minute', now)
+  }
+  getAgeInSeconds(now?: LocalTimeInput): number {
+    return this.getAgeIn('second', now)
+  }
+  getAgeIn(unit: LocalTimeUnit, now?: LocalTimeInput): number {
+    return localTime.of(now ?? new Date()).diff(this, unit)
+  }
+
   /**
    * Returns 1 if this > d
    * returns 0 if they are equal