coer-elements 2.0.81 → 2.0.83

package/fesm2022/coer-elements-tools.mjs

@@ -20,21 +20,20 @@ class Numbers {
     static IsNotNumber(value) {
         return !this.IsNumber(value);
     }
-    /** Return a string with numeric format */
-    static GetNumericFormat(value, decimals = 0) {
+    /** */
+    static SetDecimals(value, decimals = 2) {
         if (typeof value === 'string')
             value = Number(value);
         if (this.IsNotNumber(value))
             return '0';
         let valueInteger = '';
         let valueDecimal = '';
-        value = value.toString().replaceAll(' ', '');
+        value = String(value);
         if (value.includes('.') || (decimals > 0)) {
             valueInteger = value.includes('.') ? value.split('.')[0] : value;
             if (decimals > 0) {
-                const PADDING = decimals - valueDecimal.length;
                 valueDecimal = value.includes('.') ? value.split('.')[1] : '';
-                for (let i = 0; i < PADDING; i++)
+                for (let i = 0; i < decimals; i++)
                     valueDecimal += '0';
                 valueDecimal = valueDecimal.substring(0, decimals);
                 valueDecimal = `.${valueDecimal}`;
@@ -43,19 +42,15 @@ class Numbers {
         else {
             valueInteger = value;
         }
-        let counter = 0;
-        const VALUE_INTEGER_ARRAY = [];
-        for (const char of valueInteger.split('').reverse()) {
-            if (counter == 3) {
-                VALUE_INTEGER_ARRAY.push(',');
-                counter = 0;
-            }
-            VALUE_INTEGER_ARRAY.push(char);
-            ++counter;
-        }
-        valueInteger = VALUE_INTEGER_ARRAY.reverse().join('');
         return `${valueInteger}${valueDecimal}`;
     }
+    /** Return a string with numeric format */
+    static GetNumericFormat(value, decimals = 0) {
+        const [INTEGER, DECIMAL = ''] = this.SetDecimals(value).split('.');
+        return decimals > 0
+            ? `${INTEGER.replace(/\B(?=(\d{3})+(?!\d))/g, ',')}.${DECIMAL}`
+            : INTEGER.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    }
     /** Return a string with currency format */
     static GetCurrencyFormat(value, symbol = '$', currency = '') {
         return `${symbol}${this.GetNumericFormat(value, 2)}${currency.length > 0 ? ` ${currency}` : ''}`;
@@ -711,6 +706,12 @@ class Strings {
             ? String(value).split(' ').filter(x => x.length > 0).map(x => Strings.FirstCharToUpper(x.toLowerCase())).join(' ')
             : '';
     }
+    /** Remove whitespaces */
+    static RemoveWhiteSpaces(value) {
+        return Tools.IsNotOnlyWhiteSpace(value)
+            ? String(value).replaceAll(' ', '')
+            : '';
+    }
     /** Removes the last character */
     static RemoveLastChar(value) {
         return Tools.IsNotOnlyWhiteSpace(value)
@@ -784,17 +785,22 @@ class Dates {
         [1, 'Jan'], [2, 'Feb'], [3, 'Mar'], [4, 'Apr'], [5, 'May'], [6, 'Jun'],
         [7, 'Jul'], [8, 'Aug'], [9, 'Sep'], [10, 'Oct'], [11, 'Nov'], [12, 'Dec'],
     ]); }
-    /** Get UTC Offset */
+    /** */
     static GetOffset() {
         return -(new Date().getTimezoneOffset());
     }
     /** */
+    static GetLastDay(date) {
+        const DATE = this._CleanDate(date);
+        return new Date(DATE.getFullYear(), DATE.getMonth() + 1, 0).getDate();
+    }
+    /** */
     static IsValidDate(date) {
         return !isNaN(new Date(date).getTime());
     }
-    /** YYYY-MM-DD HH:mm:ss */
-    static GetCurrentDateTime() {
-        return this.GetFormatDB(new Date());
+    /** */
+    static GetCurrentDate() {
+        return new Date();
     }
     /** */
     static _CleanDate(date) {
@@ -806,16 +812,16 @@ class Dates {
         else
             return date;
     }
-    /** Convert UTC Date to Local Zone. YYYY-MM-DD HH:mm:ss */
+    /** */
     static ToLocalZone(utcDate) {
-        return this.GetFormatDB(new Date(new Date(utcDate).getTime() + this.GetOffset() * 60000));
+        return new Date(new Date(utcDate).getTime() + this.GetOffset() * 60000);
     }
-    /** Convert Local Zone Date to UTC. YYYY-MM-DD HH:mm:ss */
+    /** */
     static ToUTC(date) {
-        return this.GetFormatDB(new Date(new Date(date).getTime() - this.GetOffset() * 60000));
+        return new Date(new Date(date).getTime() - this.GetOffset() * 60000);
     }
     /** YYYY-MM-DD HH:mm:ss */
-    static GetFormatDB(date) {
+    static ToFormatDB(date) {
         const DATE = this._CleanDate(date);
         return `${DATE.getFullYear()}` + '-'
             + `${DATE.getMonth() + 1}`.padStart(2, '0') + '-'
@@ -846,7 +852,7 @@ class Dates {
             + `${DATE.getDate()}`.padStart(2, '0') + ' ';
     }
     /** */
-    static GetFormatDate(date, format) {
+    static ToFormatDate(date, format) {
         switch (format || Tools.AvoidNull(appSettings?.dateTime?.format, 'string')) {
             case 'DMY': return this._GetFormatDateDMY(date);
             case 'YMD': return this._GetFormatDateYMD(date);
@@ -854,50 +860,50 @@ class Dates {
         }
     }
     /** */
-    static GetFormatDateTime(date, ampm = true) {
+    static ToFormatDateTime(date, ampm = true, format) {
         const DATE = this._CleanDate(date);
         if (ampm) {
             let hours = DATE.getHours();
             const AM_PM = hours >= 12 ? 'pm' : 'am';
             hours = hours % 12;
             hours = hours === 0 ? 12 : hours;
-            return `${this.GetFormatDate(DATE)}` + ' at '
+            return `${this.ToFormatDate(DATE, format)}` + ' at '
                 + `${hours}`.padStart(2, '0') + ':'
                 + `${DATE.getMinutes()}`.padStart(2, '0') + ' '
                 + `${AM_PM}`;
         }
         else {
-            return `${this.GetFormatDate(DATE)}` + ' at '
+            return `${this.ToFormatDate(DATE, format)}` + ' at '
                 + `${DATE.getHours()}`.padStart(2, '0') + ':'
                 + `${DATE.getMinutes()}`.padStart(2, '0') + ' ';
         }
     }
-    /** Add milliseconds */
+    /** */
     static AddMilliseconds(date, milliseconds) {
         return new Date(this._CleanDate(date).getTime() + milliseconds);
     }
-    /** Add seconds */
-    static AddSeconds(date, seconds) {
+    /** */
+    static AddSeconds(date, seconds = 1) {
         return this.AddMilliseconds(date, seconds * 1000);
     }
-    /** Add minutes */
-    static AddMinutes(date, minutes) {
+    /** */
+    static AddMinutes(date, minutes = 1) {
         return this.AddMilliseconds(date, minutes * 60 * 1000);
     }
-    /** Add hours */
-    static AddHour(date, hours) {
+    /** */
+    static AddHours(date, hours = 1) {
         return this.AddMilliseconds(date, hours * 60 * 60 * 1000);
     }
     /** Add days */
-    static AddDay(date, days) {
+    static AddDays(date, days = 1) {
         return this.AddMilliseconds(date, days * 24 * 60 * 60 * 1000);
     }
-    /** Add N weeks to a given date */
-    static AddWeek(date, weeks) {
+    /** Add weeks */
+    static AddWeeks(date, weeks = 1) {
         return this.AddMilliseconds(date, weeks * 7 * 24 * 60 * 60 * 1000);
     }
     /** Add months */
-    static AddMonth(date, months) {
+    static AddMonths(date, months = 1) {
         const DATE = this._CleanDate(date);
         const DATE_UPDATED = new Date(DATE.getFullYear(), (DATE.getMonth() + months), 1);
         DATE_UPDATED.setDate(Math.min(DATE.getDate(), new Date(DATE_UPDATED.getFullYear(), (DATE_UPDATED.getMonth() + 1), 0).getDate()));
@@ -905,51 +911,91 @@ class Dates {
         return DATE_UPDATED;
     }
     /** Add years */
-    static AddYear(date, years) {
+    static AddYears(date, years = 1) {
         const DATE = this._CleanDate(date);
         const DATE_UPDATED = new Date((DATE.getFullYear() + years), DATE.getMonth(), 1);
         DATE_UPDATED.setDate(Math.min(DATE.getDate(), new Date(DATE_UPDATED.getFullYear(), DATE_UPDATED.getMonth() + 1, 0).getDate()));
         DATE_UPDATED.setHours(DATE.getHours(), DATE.getMinutes(), DATE.getSeconds(), DATE.getMilliseconds());
         return DATE_UPDATED;
     }
-    /** Set Hour. YYYY-MM-DD HH:mm:ss */
-    static SetHour(date, hour) {
+    /** */
+    static SetMillisecond(date, millisecond = 0) {
         const DATE = this._CleanDate(date);
-        if (hour < 0 || hour >= 24) {
-            hour = DATE.getHours();
+        if (millisecond < 0 || millisecond >= 1000) {
+            millisecond = DATE.getMilliseconds();
         }
-        DATE.setHours(hour, DATE.getMinutes(), DATE.getSeconds());
-        return this.GetFormatDB(DATE);
+        DATE.setMilliseconds(millisecond);
+        return DATE;
     }
-    /** Set minute. YYYY-MM-DD HH:mm:ss */
-    static SetMinute(date, minute) {
+    /** */
+    static SetSecond(date, second = 0) {
+        const DATE = this._CleanDate(date);
+        if (second < 0 || second >= 60) {
+            second = DATE.getSeconds();
+        }
+        DATE.setSeconds(second);
+        return DATE;
+    }
+    /** */
+    static SetMinute(date, minute = 0) {
         const DATE = this._CleanDate(date);
         if (minute < 0 || minute >= 60) {
             minute = DATE.getMinutes();
         }
         DATE.setMinutes(minute, DATE.getSeconds());
-        return this.GetFormatDB(DATE);
+        return DATE;
     }
-    /** Set second. YYYY-MM-DD HH:mm:ss */
-    static SetSecond(date, second) {
+    /** */
+    static SetHour(date, hour = 0) {
         const DATE = this._CleanDate(date);
-        if (second < 0 || second >= 60) {
-            second = DATE.getSeconds();
+        if (hour < 0 || hour >= 24) {
+            hour = DATE.getHours();
         }
-        DATE.setSeconds(second);
-        return this.GetFormatDB(DATE);
+        DATE.setHours(hour, DATE.getMinutes(), DATE.getSeconds());
+        return DATE;
     }
-    /** Set 00:00:00. YYYY-MM-DD HH:mm:ss */
+    /** Set 00:00:00 */
     static SetFirstHour(date) {
         const DATE = this._CleanDate(date);
         DATE.setHours(0, 0, 0);
-        return this.GetFormatDB(DATE);
+        return DATE;
     }
-    /** Set 23:59:59. YYYY-MM-DD HH:mm:ss */
+    /** Set 23:59:59 */
     static SetLastHour(date) {
         const DATE = this._CleanDate(date);
         DATE.setHours(23, 59, 59);
-        return this.GetFormatDB(DATE);
+        return DATE;
+    }
+    /** */
+    static SetDay(date, day = 1) {
+        const DATE = this._CleanDate(date);
+        if (day < 1 || day > this.GetLastDay(DATE)) {
+            day = DATE.getDate();
+        }
+        DATE.setDate(day);
+        return DATE;
+    }
+    /** */
+    static SetFirstDay(date) {
+        return this.SetDay(date, 1);
+    }
+    /**  */
+    static SetLastDay(date) {
+        return this.SetDay(date, this.GetLastDay(date));
+    }
+    /** */
+    static GetDiffNow(date, unit = 'minutes') {
+        return this.GetDiff(this.GetCurrentDate(), date, unit);
+    }
+    /** */
+    static GetDiff(fromDate, toDate, unit = 'minutes') {
+        switch (unit) {
+            case 'milliseconds': return Number(Numbers.SetDecimals(this._CleanDate(fromDate).getTime() - this._CleanDate(toDate).getTime(), 0));
+            case 'seconds': return Number(Numbers.SetDecimals((this._CleanDate(fromDate).getTime() - this._CleanDate(toDate).getTime()) / 1000, 0));
+            case 'minutes': return Number(Numbers.SetDecimals((this._CleanDate(fromDate).getTime() - this._CleanDate(toDate).getTime()) / (1000 * 60), 0));
+            case 'hours': return Number(Numbers.SetDecimals((this._CleanDate(fromDate).getTime() - this._CleanDate(toDate).getTime()) / (1000 * 60 * 60), 0));
+            case 'days': return Number(Numbers.SetDecimals((this._CleanDate(fromDate).getTime() - this._CleanDate(toDate).getTime()) / (1000 * 60 * 60 * 24), 0));
+        }
     }
 }