@naturalcycles/js-lib 14.243.1 → 14.244.0

package/dist/datetime/dateInterval.js

@@ -63,7 +63,7 @@ class DateInterval {
      */
     cmp(d) {
         d = DateInterval.parse(d);
-        return this.start.cmp(d.start) || this.end.cmp(d.end);
+        return this.start.compare(d.start) || this.end.compare(d.end);
     }
     getDays(incl = '[]') {
         return localDate_1.localDate.range(this.start, this.end, incl, 1, 'day');

package/dist/datetime/localDate.d.ts

@@ -11,19 +11,16 @@ export type LocalDateFormatter = (ld: LocalDate) => string;
  * It is timezone-independent.
  */
 export declare class LocalDate {
-    private $year;
-    private $month;
-    private $day;
-    constructor($year: number, $month: number, $day: number);
+    year: number;
+    month: number;
+    day: number;
+    constructor(year: number, month: number, day: number);
     get(unit: LocalDateUnitStrict): number;
     set(unit: LocalDateUnitStrict, v: number, mutate?: boolean): LocalDate;
-    year(): number;
-    year(v: number): LocalDate;
-    month(): number;
-    month(v: number): LocalDate;
-    day(): number;
-    day(v: number): LocalDate;
-    dayOfWeek(): ISODayOfWeek;
+    setYear(v: number): LocalDate;
+    setMonth(v: number): LocalDate;
+    setDay(v: number): LocalDate;
+    get dayOfWeek(): ISODayOfWeek;
     isSame(d: LocalDateInput): boolean;
     isBefore(d: LocalDateInput, inclusive?: boolean): boolean;
     isSameOrBefore(d: LocalDateInput): boolean;
@@ -67,7 +64,7 @@ export declare class LocalDate {
      * returns 0 if they are equal
      * returns -1 if this < d
      */
-    cmp(d: LocalDateInput): -1 | 0 | 1;
+    compare(d: LocalDateInput): -1 | 0 | 1;
     /**
      * Same as Math.abs( diff )
      */
@@ -94,7 +91,7 @@ export declare class LocalDate {
      * Returns how many days are in the current month.
      * E.g 31 for January.
      */
-    daysInMonth(): number;
+    get daysInMonth(): number;
     clone(): LocalDate;
     /**
      * Converts LocalDate into instance of Date.
@@ -140,19 +137,15 @@ export declare class LocalDate {
     /**
      * Returns unix timestamp of 00:00:00 of that date (in UTC, because unix timestamp always reflects UTC).
      */
-    unix(): UnixTimestampNumber;
+    get unix(): UnixTimestampNumber;
     /**
      * Same as .unix(), but in milliseconds.
      */
-    unixMillis(): UnixTimestampMillisNumber;
+    get unixMillis(): UnixTimestampMillisNumber;
     toJSON(): IsoDateString;
     format(fmt: Intl.DateTimeFormat | LocalDateFormatter): string;
 }
 declare class LocalDateFactory {
-    /**
-     * Create LocalDate from year, month and day components.
-     */
-    create(year: number, month: number, day: number): LocalDate;
     /**
      * Create LocalDate from LocalDateInput.
      * Input can already be a LocalDate - it is returned as-is in that case.
@@ -162,20 +155,19 @@ declare class LocalDateFactory {
      *
      * Will throw if it fails to parse/construct LocalDate.
      */
-    of(d: LocalDateInput): LocalDate;
+    from(input: LocalDateInput): LocalDate;
     /**
      * Tries to construct LocalDate from LocalDateInput, returns null otherwise.
      * Does not throw (returns null instead).
      */
-    parseOrNull(d: LocalDateInputNullable): LocalDate | null;
+    fromOrNull(d: LocalDateInputNullable): LocalDate | null;
+    fromString(s: string): LocalDate;
+    fromStringOrNull(s: string | undefined | null): LocalDate | null;
     /**
      * Parses "compact iso8601 format", e.g `19840621` into LocalDate.
      * Throws if it fails to do so.
      */
-    parseCompact(d: string): LocalDate;
-    getYearLength(year: number): number;
-    getMonthLength(year: number, month: number): number;
-    isLeapYear(year: number): boolean;
+    fromCompactString(s: string): LocalDate;
     /**
      * Constructs LocalDate from Date.
      * Takes Date as-is, in its timezone - local or UTC.
@@ -186,10 +178,23 @@ declare class LocalDateFactory {
      * Takes Date's year/month/day components in UTC, using getUTCFullYear, getUTCMonth, getUTCDate.
      */
     fromDateInUTC(d: Date): LocalDate;
+    /**
+     * Create LocalDate from year, month and day components.
+     */
+    fromComponents(year: number, month: number, day: number): LocalDate;
+    fromDateObject(o: DateObject): LocalDate;
+    private assertNotNull;
+    getYearLength(year: number): number;
+    getMonthLength(year: number, month: number): number;
+    isLeapYear(year: number): boolean;
+    /**
+     * Returns true if input is valid to create LocalDate.
+     */
+    isValid(input: LocalDateInputNullable): boolean;
     /**
      * Returns true if isoString is a valid iso8601 string like `yyyy-mm-dd`.
      */
-    isValid(isoString: string | undefined | null): boolean;
+    isValidString(isoString: string | undefined | null): boolean;
     /**
      * Creates LocalDate that represents `today` (in local timezone).
      */