@naturalcycles/js-lib 14.98.3 → 14.99.2

package/src/datetime/localTime.ts

@@ -3,9 +3,20 @@ import { _ms } from '../time/time.util'
 import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types'
 import { Inclusiveness, LocalDate } from './localDate'
 
-export type LocalTimeUnit = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'
+export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'
+
+export enum ISODayOfWeek {
+  MONDAY = 1,
+  TUESDAY = 2,
+  WEDNESDAY = 3,
+  THURSDAY = 4,
+  FRIDAY = 5,
+  SATURDAY = 6,
+  SUNDAY = 7,
+}
 
 export type LocalTimeConfig = LocalTime | Date | IsoDateTimeString | UnixTimestampNumber
+export type LocalTimeFormatter = (ld: LocalTime) => string
 
 export interface LocalTimeComponents {
   year: number
@@ -16,13 +27,20 @@ export interface LocalTimeComponents {
   second: number
 }
 
+const weekStartsOn = 1 // mon, as per ISO
+const MILLISECONDS_IN_WEEK = 604800000
+const SECONDS_IN_DAY = 86400
+// const MILLISECONDS_IN_DAY = 86400000
+// const MILLISECONDS_IN_MINUTE = 60000
+const VALID_DAYS_OF_WEEK = new Set([1, 2, 3, 4, 5, 6, 7])
+
 /* eslint-disable no-dupe-class-members */
 
 /**
  * @experimental
  */
 export class LocalTime {
-  private constructor(private $date: Date, public utcMode: boolean) {}
+  private constructor(private $date: Date) {}
 
   /**
    * Parses input String into LocalDate.
@@ -38,16 +56,6 @@ export class LocalTime {
     return t
   }
 
-  utc(): this {
-    this.utcMode = true
-    return this
-  }
-
-  local(): this {
-    this.utcMode = false
-    return this
-  }
-
   /**
    * Returns null if invalid
    */
@@ -75,7 +83,7 @@ export class LocalTime {
     //   date.setMinutes(date.getMinutes() + date.getTimezoneOffset())
     // }
 
-    return new LocalTime(date, false)
+    return new LocalTime(date)
   }
 
   static parseToDate(d: LocalTimeConfig): Date {
@@ -109,53 +117,56 @@ export class LocalTime {
   }
 
   static now(): LocalTime {
-    return new LocalTime(new Date(), false)
+    return new LocalTime(new Date())
   }
 
   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), false)
+    return new LocalTime(new Date(c.year, c.month - 1, c.day, c.hour, c.minute, c.second))
   }
 
   get(unit: LocalTimeUnit): number {
     if (unit === 'year') {
-      return this.utcMode ? this.$date.getUTCFullYear() : this.$date.getFullYear()
+      return this.$date.getFullYear()
     }
     if (unit === 'month') {
-      return (this.utcMode ? this.$date.getUTCMonth() : this.$date.getMonth()) + 1
+      return this.$date.getMonth() + 1
     }
     if (unit === 'day') {
-      return this.utcMode ? this.$date.getUTCDate() : this.$date.getDate()
+      return this.$date.getDate()
     }
     if (unit === 'hour') {
-      return this.utcMode ? this.$date.getUTCHours() : this.$date.getHours()
+      return this.$date.getHours()
     }
     if (unit === 'minute') {
-      return this.utcMode ? this.$date.getUTCMinutes() : this.$date.getMinutes()
+      return this.$date.getMinutes()
+    }
+    if (unit === 'week') {
+      return getWeek(this.$date)
     }
     // second
-    return this.utcMode ? this.$date.getUTCSeconds() : this.$date.getSeconds()
+    return this.$date.getSeconds()
   }
 
   set(unit: LocalTimeUnit, v: number, mutate = false): LocalTime {
     const t = mutate ? this : this.clone()
 
-    /* eslint-disable @typescript-eslint/no-unused-expressions */
     if (unit === 'year') {
-      this.utcMode ? t.$date.setUTCFullYear(v) : t.$date.setFullYear(v)
+      t.$date.setFullYear(v)
     } else if (unit === 'month') {
-      this.utcMode ? t.$date.setUTCMonth(v - 1) : t.$date.setMonth(v - 1)
+      t.$date.setMonth(v - 1)
     } else if (unit === 'day') {
-      this.utcMode ? t.$date.setUTCDate(v) : t.$date.setDate(v)
+      t.$date.setDate(v)
     } else if (unit === 'hour') {
-      this.utcMode ? t.$date.setUTCHours(v) : t.$date.setHours(v)
+      t.$date.setHours(v)
     } else if (unit === 'minute') {
-      this.utcMode ? t.$date.setUTCMinutes(v) : t.$date.setMinutes(v)
+      t.$date.setMinutes(v)
     } else if (unit === 'second') {
-      this.utcMode ? t.$date.setUTCSeconds(v) : t.$date.setSeconds(v)
+      t.$date.setSeconds(v)
+    } else if (unit === 'week') {
+      setWeek(t.$date, v, true)
     }
-    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
     return t
   }
@@ -170,11 +181,33 @@ export class LocalTime {
   month(v?: number): number | LocalTime {
     return v === undefined ? this.get('month') : this.set('month', v)
   }
+  week(): number
+  week(v: number): LocalTime
+  week(v?: number): number | LocalTime {
+    return v === undefined ? getWeek(this.$date) : this.set('week', v)
+  }
   day(): number
   day(v: number): LocalTime
   day(v?: number): number | LocalTime {
     return v === undefined ? this.get('day') : this.set('day', v)
   }
+
+  /**
+   * Based on ISO: 1-7 is Mon-Sun.
+   */
+  dayOfWeek(): ISODayOfWeek
+  dayOfWeek(v: ISODayOfWeek): LocalTime
+  dayOfWeek(v?: ISODayOfWeek): ISODayOfWeek | LocalTime {
+    const dow = (this.$date.getDay() || 7) as ISODayOfWeek
+
+    if (v === undefined) {
+      return dow
+    }
+
+    if (!VALID_DAYS_OF_WEEK.has(v)) throw new Error(`Invalid dayOfWeek: ${v}`)
+
+    return this.add(v - dow, 'day')
+  }
   hour(): number
   hour(v: number): LocalTime
   hour(v?: number): number | LocalTime {
@@ -194,31 +227,33 @@ export class LocalTime {
   setComponents(c: Partial<LocalTimeComponents>, mutate = false): LocalTime {
     const d = mutate ? this.$date : new Date(this.$date)
 
-    /* eslint-disable @typescript-eslint/no-unused-expressions */
     if (c.year) {
-      this.utcMode ? d.setUTCFullYear(c.year) : d.setFullYear(c.year)
+      d.setFullYear(c.year)
     }
     if (c.month) {
-      this.utcMode ? d.setUTCMonth(c.month - 1) : d.setMonth(c.month - 1)
+      d.setMonth(c.month - 1)
     }
     if (c.day) {
-      this.utcMode ? d.setUTCDate(c.day) : d.setDate(c.day)
+      d.setDate(c.day)
     }
     if (c.hour !== undefined) {
-      this.utcMode ? d.setUTCHours(c.hour) : d.setHours(c.hour)
+      d.setHours(c.hour)
     }
     if (c.minute !== undefined) {
-      this.utcMode ? d.setUTCMinutes(c.minute) : d.setMinutes(c.minute)
+      d.setMinutes(c.minute)
     }
     if (c.second !== undefined) {
-      this.utcMode ? d.setUTCSeconds(c.second) : d.setSeconds(c.second)
+      d.setSeconds(c.second)
     }
-    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
-    return mutate ? this : new LocalTime(d, this.utcMode)
+    return mutate ? this : new LocalTime(d)
   }
 
   add(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
+    if (unit === 'week') {
+      num *= 7
+      unit = 'day'
+    }
     return this.set(unit, this.get(unit) + num, mutate)
   }
 
@@ -233,24 +268,45 @@ export class LocalTime {
   diff(other: LocalTimeConfig, unit: LocalTimeUnit): number {
     const date2 = LocalTime.parseToDate(other)
 
-    if (unit === 'year') {
-      return this.$date.getFullYear() - date2.getFullYear()
-    }
-    if (unit === 'month') {
-      return (
-        (this.$date.getFullYear() - date2.getFullYear()) * 12 +
-        this.$date.getMonth() -
-        date2.getMonth()
-      )
+    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
+      }
     }
 
-    const secDiff = (this.$date.valueOf() - date2.valueOf()) / 1000
     let r
 
     if (unit === 'day') {
-      r = secDiff / (24 * 60 * 60)
+      r = secDiff / SECONDS_IN_DAY
+    } else if (unit === 'week') {
+      r = secDiff / (7 * 24 * 60 * 60)
     } else if (unit === 'hour') {
-      r = secDiff / (60 * 60)
+      r = secDiff / 3600
     } else if (unit === 'minute') {
       r = secDiff / 60
     } else {
@@ -258,34 +314,66 @@ export class LocalTime {
       r = secDiff
     }
 
-    r = r < 0 ? -Math.floor(-r) : Math.floor(r)
-    if (Object.is(r, -0)) return 0
-    return r
+    // `|| 0` is to avoid returning -0
+    return Math.trunc(r) || 0
   }
 
   startOf(unit: LocalTimeUnit, mutate = false): LocalTime {
     if (unit === 'second') return this
+    const d = mutate ? this.$date : new Date(this.$date)
+    d.setSeconds(0, 0)
+
+    if (unit !== 'minute') {
+      d.setMinutes(0)
+      if (unit !== 'hour') {
+        d.setHours(0)
+        if (unit !== 'day') {
+          // year, month or week
+
+          if (unit === 'year') {
+            d.setMonth(0)
+            d.setDate(1)
+          } else if (unit === 'month') {
+            d.setDate(1)
+          } else {
+            // week
+            startOfWeek(d, true)
+          }
+        }
+      }
+    }
+
+    return mutate ? this : new LocalTime(d)
+  }
 
+  endOf(unit: LocalTimeUnit, mutate = false): LocalTime {
+    if (unit === 'second') return this
     const d = mutate ? this.$date : new Date(this.$date)
-    d.setMilliseconds(0)
-    d.setSeconds(0)
+    d.setSeconds(59, 0)
 
-    /* eslint-disable @typescript-eslint/no-unused-expressions */
     if (unit !== 'minute') {
-      this.utcMode ? d.setUTCMinutes(0) : d.setMinutes(0)
+      d.setMinutes(59)
       if (unit !== 'hour') {
-        this.utcMode ? d.setUTCHours(0) : d.setHours(0)
+        d.setHours(23)
         if (unit !== 'day') {
-          this.utcMode ? d.setUTCDate(0) : d.setDate(0)
-          if (unit !== 'month') {
-            this.utcMode ? d.setUTCMonth(0) : d.setMonth(0)
+          // year, month or week
+
+          if (unit === 'year') {
+            d.setMonth(11)
+          }
+
+          if (unit === 'week') {
+            endOfWeek(d, true)
+          } else {
+            // year or month
+            const lastDay = LocalDate.getMonthLength(d.getFullYear(), d.getMonth() + 1)
+            d.setDate(lastDay)
           }
         }
       }
     }
-    /* eslint-enable @typescript-eslint/no-unused-expressions */
 
-    return mutate ? this : new LocalTime(d, this.utcMode)
+    return mutate ? this : new LocalTime(d)
   }
 
   static sort(items: LocalTime[], mutate = false, descending = false): LocalTime[] {
@@ -298,24 +386,28 @@ export class LocalTime {
     })
   }
 
-  static earliestOrUndefined(items: LocalTime[]): LocalTime | undefined {
+  static earliestOrUndefined(items: LocalTimeConfig[]): LocalTime | undefined {
     return items.length ? LocalTime.earliest(items) : undefined
   }
 
-  static earliest(items: LocalTime[]): LocalTime {
+  static earliest(items: LocalTimeConfig[]): LocalTime {
     _assert(items.length, 'LocalTime.earliest called on empty array')
 
-    return items.reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
+    return items
+      .map(i => LocalTime.of(i))
+      .reduce((min, item) => (min.isSameOrBefore(item) ? min : item))
   }
 
-  static latestOrUndefined(items: LocalTime[]): LocalTime | undefined {
+  static latestOrUndefined(items: LocalTimeConfig[]): LocalTime | undefined {
     return items.length ? LocalTime.latest(items) : undefined
   }
 
-  static latest(items: LocalTime[]): LocalTime {
+  static latest(items: LocalTimeConfig[]): LocalTime {
     _assert(items.length, 'LocalTime.latest called on empty array')
 
-    return items.reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
+    return items
+      .map(i => LocalTime.of(i))
+      .reduce((max, item) => (max.isSameOrAfter(item) ? max : item))
   }
 
   isSame(d: LocalTimeConfig): boolean {
@@ -360,20 +452,7 @@ export class LocalTime {
     return t1 < t2 ? -1 : 1
   }
 
-  // todo: endOf
-
   components(): LocalTimeComponents {
-    if (this.utcMode) {
-      return {
-        year: this.$date.getUTCFullYear(),
-        month: this.$date.getUTCMonth() + 1,
-        day: this.$date.getUTCDate(),
-        hour: this.$date.getUTCHours(),
-        minute: this.$date.getUTCMinutes(),
-        second: this.$date.getSeconds(),
-      }
-    }
-
     return {
       year: this.$date.getFullYear(),
       month: this.$date.getMonth() + 1,
@@ -401,7 +480,7 @@ export class LocalTime {
   }
 
   clone(): LocalTime {
-    return new LocalTime(new Date(this.$date), this.utcMode)
+    return new LocalTime(new Date(this.$date))
   }
 
   unix(): UnixTimestampNumber {
@@ -417,14 +496,6 @@ export class LocalTime {
   }
 
   toLocalDate(): LocalDate {
-    if (this.utcMode) {
-      return LocalDate.create(
-        this.$date.getUTCFullYear(),
-        this.$date.getUTCMonth() + 1,
-        this.$date.getUTCDate(),
-      )
-    }
-
     return LocalDate.create(
       this.$date.getFullYear(),
       this.$date.getMonth() + 1,
@@ -520,6 +591,10 @@ export class LocalTime {
   toJSON(): UnixTimestampNumber {
     return this.unix()
   }
+
+  format(fmt: LocalTimeFormatter): string {
+    return fmt(this)
+  }
 }
 
 /**
@@ -528,3 +603,97 @@ export class LocalTime {
 export function localTime(d?: LocalTimeConfig): LocalTime {
   return d ? LocalTime.of(d) : LocalTime.now()
 }
+
+// based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
+function getWeek(date: Date): number {
+  const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime()
+  return Math.round(diff / MILLISECONDS_IN_WEEK) + 1
+}
+
+function setWeek(date: Date, week: number, mutate = false): Date {
+  const d = mutate ? date : new Date(date)
+  const diff = getWeek(d) - week
+  d.setDate(d.getDate() - diff * 7)
+  return d
+}
+
+// based on: https://github.com/date-fns/date-fns/blob/master/src/startOfISOWeekYear/index.ts
+function startOfWeekYear(date: Date): Date {
+  const year = getWeekYear(date)
+  const fourthOfJanuary = new Date(0)
+  fourthOfJanuary.setFullYear(year, 0, 4)
+  fourthOfJanuary.setHours(0, 0, 0, 0)
+  return startOfWeek(fourthOfJanuary, true)
+}
+
+// based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/getISOWeekYear/index.ts
+function getWeekYear(date: Date): number {
+  const year = date.getFullYear()
+
+  const fourthOfJanuaryOfNextYear = new Date(0)
+  fourthOfJanuaryOfNextYear.setFullYear(year + 1, 0, 4)
+  fourthOfJanuaryOfNextYear.setHours(0, 0, 0, 0)
+  const startOfNextYear = startOfWeek(fourthOfJanuaryOfNextYear, true)
+
+  const fourthOfJanuaryOfThisYear = new Date(0)
+  fourthOfJanuaryOfThisYear.setFullYear(year, 0, 4)
+  fourthOfJanuaryOfThisYear.setHours(0, 0, 0, 0)
+  const startOfThisYear = startOfWeek(fourthOfJanuaryOfThisYear, true)
+
+  if (date.getTime() >= startOfNextYear.getTime()) {
+    return year + 1
+  } else if (date.getTime() >= startOfThisYear.getTime()) {
+    return year
+  } else {
+    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: Date, mutate = false): Date {
+  const d = mutate ? date : new Date(date)
+
+  const day = d.getDay()
+  const diff = (day < weekStartsOn ? 7 : 0) + day - weekStartsOn
+
+  d.setDate(d.getDate() - diff)
+  d.setHours(0, 0, 0, 0)
+  return d
+}
+
+// based on: https://github.com/date-fns/date-fns/blob/master/src/endOfWeek/index.ts
+function endOfWeek(date: Date, mutate = false): Date {
+  const d = mutate ? date : new Date(date)
+
+  const day = d.getDay()
+  const diff = (day < weekStartsOn ? -7 : 0) + 6 - (day - weekStartsOn)
+
+  d.setDate(d.getDate() + diff)
+  return d
+}

package/src/index.ts

@@ -162,8 +162,20 @@ export * from './datetime/localDate'
 export * from './datetime/localTime'
 export * from './datetime/dateInterval'
 export * from './datetime/timeInterval'
-import { LocalDateConfig, LocalDateUnit, Inclusiveness } from './datetime/localDate'
-import { LocalTimeConfig, LocalTimeUnit, LocalTimeComponents } from './datetime/localTime'
+import {
+  LocalDateConfig,
+  LocalDateFormatter,
+  LocalDateUnit,
+  LocalDateUnitStrict,
+  Inclusiveness,
+} from './datetime/localDate'
+import {
+  LocalTimeConfig,
+  LocalTimeFormatter,
+  LocalTimeUnit,
+  LocalTimeComponents,
+  ISODayOfWeek,
+} from './datetime/localTime'
 import { DateIntervalConfig, DateIntervalString } from './datetime/dateInterval'
 import { TimeIntervalConfig, TimeIntervalString } from './datetime/timeInterval'
 
@@ -173,10 +185,14 @@ export type {
   TimeIntervalConfig,
   TimeIntervalString,
   LocalDateConfig,
+  LocalDateFormatter,
   LocalDateUnit,
+  LocalDateUnitStrict,
   Inclusiveness,
   LocalTimeConfig,
+  LocalTimeFormatter,
   LocalTimeUnit,
+  ISODayOfWeek,
   LocalTimeComponents,
   AbortableMapper,
   AbortablePredicate,