@qrvey/utils 1.10.0-11 → 1.10.0-13

package/dist/cjs/dates/adapters/ISOToNumericOffset.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ISOToNumericOffset = void 0;
 const isNaNV2_1 = require("../../general/mix/isNaNV2");
+const getSign_1 = require("../../general/numeric/getSign");
 const isValidISOOffset_1 = require("../helpers/isValidISOOffset");
 /**
  * Gets the numeric offset (minutes) from the ISO offset (string)
@@ -16,6 +17,8 @@ function ISOToNumericOffset(offset) {
     if (!(0, isValidISOOffset_1.isValidISOOffset)(offset))
         return 0;
     const [hours, minutes] = offset.split(":").map(Number);
-    return hours * 60 + minutes;
+    const sign = (0, getSign_1.getSign)(hours);
+    const absoluteOffset = Math.abs(hours) * 60 + minutes;
+    return sign === "-" ? -1 * absoluteOffset : absoluteOffset;
 }
 exports.ISOToNumericOffset = ISOToNumericOffset;

package/dist/cjs/general/array/getArrayByProperty.d.ts

@@ -4,4 +4,4 @@
  * @param property the property to get the value collection
  * @returns a collection of values by property
  */
-export declare function getArrayByProperty<T = any>(arr: T[], property: string): T[];
+export declare function getArrayByProperty<T = any>(arr: T[], property: string | number): T[];

package/dist/cjs/general/array/getUniqueArray.d.ts

@@ -6,4 +6,4 @@
  * @param prop Property name to search duplicated values
  * @return Array without duplicated items.
  */
-export declare function getUniqueArray(arr: any[], prop: string): any[];
+export declare function getUniqueArray<T = any>(arr: T[], prop: string | number): T[];

package/dist/cjs/general/array/getUniqueArray.js

@@ -10,6 +10,8 @@ exports.getUniqueArray = void 0;
  * @return Array without duplicated items.
  */
 function getUniqueArray(arr, prop) {
+    if (!Array.isArray(arr))
+        return arr;
     return arr
         .map((e) => e[prop])
         .map((e, i, final) => final.indexOf(e) === i && i)

package/dist/cjs/general/mix/isEmpty.js

@@ -26,6 +26,8 @@ function isEmpty(variable, includeFalsy = false) {
         (!(variable instanceof Date) &&
             typeof variable !== "function" &&
             (0, isObject_1.isObject)(variable) &&
+            Object.entries(variable).length === 0) ||
+        ((0, getTag_1.getTag)(variable) === "[object NodeList]" &&
             Object.entries(variable).length === 0));
 }
 exports.isEmpty = isEmpty;

package/dist/cjs/general/mix/isNaNV2.d.ts

@@ -8,6 +8,7 @@
  * Special case for isNaN
  * - The isNaN('') is considered as false statement. The empty string is converted to 0 which is not NaN.
  * - Boolean variables is considered as false statement.
+ * - Date objects is considered as true.
  *
  * @param variable the variable to validate
  * @return True: variable is a NaN; False: The variable is a number

package/dist/cjs/general/mix/isNaNV2.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isNaNV2 = void 0;
-const _1 = require(".");
+const isValidDateObject_1 = require("../../dates/helpers/isValidDateObject");
+const isEmpty_1 = require("./isEmpty");
 /**
  * Validates if the recieved number is NaN type.
  *
@@ -12,11 +13,15 @@ const _1 = require(".");
  * Special case for isNaN
  * - The isNaN('') is considered as false statement. The empty string is converted to 0 which is not NaN.
  * - Boolean variables is considered as false statement.
+ * - Date objects is considered as true.
  *
  * @param variable the variable to validate
  * @return True: variable is a NaN; False: The variable is a number
  */
 function isNaNV2(variable) {
-    return (0, _1.isEmpty)(variable) || typeof variable == "boolean" || isNaN(variable);
+    return ((0, isEmpty_1.isEmpty)(variable) ||
+        typeof variable == "boolean" ||
+        isNaN(variable) ||
+        (0, isValidDateObject_1.isValidDateObject)(variable));
 }
 exports.isNaNV2 = isNaNV2;

package/dist/cjs/general/numeric/getSign.js

@@ -7,6 +7,6 @@ exports.getSign = void 0;
  * @returns {string} an string with the sign
  */
 function getSign(num) {
-    return Math.sign(num) > -1 ? "+" : "-";
+    return Math.sign(num) < 0 ? "-" : "+";
 }
 exports.getSign = getSign;

package/dist/cjs/general/object/applyTimezoneDeep.d.ts

@@ -5,4 +5,4 @@ import { IDTimezone } from "../../dates/interfaces/IDTimezone";
  * @param {IDTimezone} timezone the timezone object
  * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
  */
-export declare function applyTimezoneDeep(obj: any, timezone: IDTimezone): any;
+export declare function applyTimezoneDeep<T = any>(obj: T, timezone: IDTimezone): T;

package/dist/cjs/general/object/applyTimezoneDeep.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyTimezoneDeep = void 0;
 const DATE_FORMAT_1 = require("../../dates/constants/DATE_FORMAT");
 const getDateByTimezone_1 = require("../../dates/helpers/getDateByTimezone");
+const isValidDateObject_1 = require("../../dates/helpers/isValidDateObject");
 const validateDate_1 = require("../../dates/helpers/validateDate");
 const isEmpty_1 = require("../mix/isEmpty");
 const isObject_1 = require("./isObject");
@@ -13,7 +14,7 @@ const isObject_1 = require("./isObject");
  * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
  */
 function applyTimezoneDeep(obj, timezone) {
-    if ((0, isEmpty_1.isEmpty)(obj))
+    if (!isValid(obj, timezone))
         return obj;
     let result;
     if ((0, isObject_1.isObject)(obj)) {
@@ -24,13 +25,13 @@ function applyTimezoneDeep(obj, timezone) {
     }
     try {
         for (const i in obj) {
-            if ((0, isObject_1.isObject)(obj[i]) || Array.isArray(obj[i])) {
-                result[i] = applyTimezoneDeep(obj[i], timezone);
-            }
-            else if (obj[i] instanceof Date ||
+            if ((0, isValidDateObject_1.isValidDateObject)(obj[i]) ||
                 (0, validateDate_1.validateDate)(obj[i], DATE_FORMAT_1.DATE_FORMAT.HOUR)) {
                 result[i] = (0, getDateByTimezone_1.getDateByTimezone)(obj[i], timezone);
             }
+            else if ((0, isObject_1.isObject)(obj[i]) || Array.isArray(obj[i])) {
+                result[i] = applyTimezoneDeep(obj[i], timezone);
+            }
             else {
                 result[i] = obj[i];
             }
@@ -42,3 +43,6 @@ function applyTimezoneDeep(obj, timezone) {
     }
 }
 exports.applyTimezoneDeep = applyTimezoneDeep;
+function isValid(obj, timezone) {
+    return (!(0, isEmpty_1.isEmpty)(obj) && (Array.isArray(obj) || (0, isObject_1.isObject)(obj)) && !(0, isEmpty_1.isEmpty)(timezone));
+}

package/dist/cjs/general/object/isObject.js

@@ -9,6 +9,8 @@ const getTag_1 = require("../mix/getTag");
  */
 function isObject(obj) {
     return (!Array.isArray(obj) &&
-        (obj === Object(obj) || (0, getTag_1.getTag)(obj) === "[object Object]"));
+        obj === Object(obj) &&
+        (0, getTag_1.getTag)(obj) !== "[object Function]" &&
+        ((0, getTag_1.getTag)(obj) === "[object Object]" || (0, getTag_1.getTag)(obj) === "[object Date]"));
 }
 exports.isObject = isObject;

package/dist/cjs/general/object/objectCopy.d.ts

@@ -4,4 +4,4 @@
  * @param cache
  * @returns A new reference of the given argument
  */
-export declare function objectCopy(entity: any, cache?: WeakMap<object, any>): any;
+export declare function objectCopy<T = any>(entity: T, cache?: WeakMap<object, any>): T;

package/dist/cjs/general/object/removeUndefinedDeep.js

@@ -1,17 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeUndefinedDeep = void 0;
-const cloneDeep_1 = require("./cloneDeep");
 const isObject_1 = require("./isObject");
+const objectCopy_1 = require("./objectCopy");
 /**
  * Removes and returns the given object cleaning the undefined values
  * @param obj an object
  * @returns the new object with no undefined values
  */
 function removeUndefinedDeep(obj) {
-    if (obj == null || !(0, isObject_1.isObject)(obj) || !Array.isArray(obj))
+    const isArray = Array.isArray(obj);
+    if (obj == null || (!(0, isObject_1.isObject)(obj) && !isArray))
         return obj;
-    const _obj = (0, cloneDeep_1.cloneDeep)(obj);
+    let _obj = (0, objectCopy_1.objectCopy)(obj);
+    if (isArray)
+        _obj = _obj.filter(Boolean);
     Object.keys(_obj).forEach((key) => {
         if ((0, isObject_1.isObject)(_obj[key]) || Array.isArray(_obj[key])) {
             _obj[key] = removeUndefinedDeep(_obj[key]);

package/dist/cjs/general/string/padLeadingZeros.d.ts

@@ -1 +1,28 @@
-export declare function padLeadingZeros(num: number | string, size?: number): string;
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * padding = true
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = true
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 2
+ * padding = false
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = false
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} size the quantity of zeros to add
+ * @param {number} padding True: to pad with missing zeros; depending on the num length. False: to fill zeros by the amount.
+ * @returns the string of the number with the prefixed zeros
+ */
+export declare function padLeadingZeros(num: number | string, amount?: number, padding?: boolean): string;

package/dist/cjs/general/string/padLeadingZeros.js

@@ -1,12 +1,80 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.padLeadingZeros = void 0;
-function padLeadingZeros(num, size = 0) {
-    if (isNaN(Number(num)))
-        return String(num);
-    let s = `${num}`;
-    while (s.length < size)
-        s = `0${s}`;
-    return s;
+const mix_1 = require("../mix");
+const isNaNV2_1 = require("../mix/isNaNV2");
+const getSign_1 = require("../numeric/getSign");
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * padding = true
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = true
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 2
+ * padding = false
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = false
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} size the quantity of zeros to add
+ * @param {number} padding True: to pad with missing zeros; depending on the num length. False: to fill zeros by the amount.
+ * @returns the string of the number with the prefixed zeros
+ */
+function padLeadingZeros(num, amount = 0, padding = true) {
+    if (isValidLeadingZerosParams(num, amount))
+        return num;
+    const newPadding = !(0, mix_1.isEmpty)(padding, true);
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    if (newPadding) {
+        while (absoluteStringNumber.length < amount)
+            absoluteStringNumber = `0${absoluteStringNumber}`;
+    }
+    else {
+        let i = 0;
+        while (i < amount) {
+            absoluteStringNumber = `0${absoluteStringNumber}`;
+            i = i + 1;
+        }
+    }
+    return `${sign}${absoluteStringNumber}`;
 }
 exports.padLeadingZeros = padLeadingZeros;
+function isValidLeadingZerosParams(num, amount) {
+    return (0, isNaNV2_1.isNaNV2)(num) || (0, isNaNV2_1.isNaNV2)(amount);
+}
+/**
+ * Gets the absolute number of the giving parameters
+ * @param {number | string} num the number
+ * @param {string} sign the sign of the number
+ * @returns {string} the absolute number
+ */
+function getAbsoluteNum(num, sign = "") {
+    const stringNum = `${num}`;
+    return sign !== "" && `${stringNum}`.charAt(0) === sign
+        ? stringNum.substring(1)
+        : stringNum;
+}
+/**
+ * Gets the number sign
+ * @param {number | string} num the number
+ * @returns {string} the number sign
+ */
+function getNumSign(num) {
+    const stringNum = `${num}`;
+    const sign = (0, getSign_1.getSign)(num);
+    if (stringNum.charAt(0) === sign)
+        return sign;
+    return "";
+}

package/dist/cjs/globalization/labels/formula_builder/I18N_FORMULA_BUILDER.js

@@ -341,7 +341,7 @@ exports.I18N_FORMULA_BUILDER = {
         function_placeholder: "String.length()",
     },
     function_now: {
-        description: "Return a date with the current time. Returned dates will have this format yyyy-MM-ddTHH:mm:ssZ.",
+        description: "Returns a date with the current time in the current timezone with the following format: yyyy-MM-ddTHH:mm:ss.",
         function_placeholder: "now()",
     },
     function_date_parse: {
@@ -396,7 +396,7 @@ exports.I18N_FORMULA_BUILDER = {
         param_column_name: "column",
         param_column_description: "Date column to check.",
         param_replacement_name: "replacement",
-        param_replacement_description: 'Date replacement value.<br>Common Replacement Value Formats:<br>○ Using another date column "dateIsNull(Column1, Column2)"<br>○ Using another date function "dateIsNull(Column, now())"<br>○ Using specified date "dateIsNull(Column, dateParse(\'dd/MM/yyyy\', \'dd/MM/yyyy\'))"',
+        param_replacement_description: 'Date replacement value.<br>Common Replacement Value Formats:<br>○ Using another date column "dateIsNull(Column1, Column2)"<br>○ Using another date function "dateIsNull(Column, now())"<br>○ Using specified date "dateIsNull(Column, dateParse(\'31/12/2021\', \'dd/MM/yyyy\'))"',
     },
     function_agg_sum: {
         description: "A single-value metrics aggregation that sums up numeric values that are extracted from the documents",

package/dist/dates/adapters/ISOToNumericOffset.js

@@ -1,4 +1,5 @@
 import { isNaNV2 } from "../../general/mix/isNaNV2";
+import { getSign } from "../../general/numeric/getSign";
 import { isValidISOOffset } from "../helpers/isValidISOOffset";
 /**
  * Gets the numeric offset (minutes) from the ISO offset (string)
@@ -13,5 +14,7 @@ export function ISOToNumericOffset(offset) {
     if (!isValidISOOffset(offset))
         return 0;
     const [hours, minutes] = offset.split(":").map(Number);
-    return hours * 60 + minutes;
+    const sign = getSign(hours);
+    const absoluteOffset = Math.abs(hours) * 60 + minutes;
+    return sign === "-" ? -1 * absoluteOffset : absoluteOffset;
 }

package/dist/general/array/getArrayByProperty.d.ts

@@ -4,4 +4,4 @@
  * @param property the property to get the value collection
  * @returns a collection of values by property
  */
-export declare function getArrayByProperty<T = any>(arr: T[], property: string): T[];
+export declare function getArrayByProperty<T = any>(arr: T[], property: string | number): T[];

package/dist/general/array/getUniqueArray.d.ts

@@ -6,4 +6,4 @@
  * @param prop Property name to search duplicated values
  * @return Array without duplicated items.
  */
-export declare function getUniqueArray(arr: any[], prop: string): any[];
+export declare function getUniqueArray<T = any>(arr: T[], prop: string | number): T[];

package/dist/general/array/getUniqueArray.js

@@ -7,6 +7,8 @@
  * @return Array without duplicated items.
  */
 export function getUniqueArray(arr, prop) {
+    if (!Array.isArray(arr))
+        return arr;
     return arr
         .map((e) => e[prop])
         .map((e, i, final) => final.indexOf(e) === i && i)

package/dist/general/mix/isEmpty.js

@@ -23,5 +23,7 @@ export function isEmpty(variable, includeFalsy = false) {
         (!(variable instanceof Date) &&
             typeof variable !== "function" &&
             isObject(variable) &&
+            Object.entries(variable).length === 0) ||
+        (getTag(variable) === "[object NodeList]" &&
             Object.entries(variable).length === 0));
 }

package/dist/general/mix/isNaNV2.d.ts

@@ -8,6 +8,7 @@
  * Special case for isNaN
  * - The isNaN('') is considered as false statement. The empty string is converted to 0 which is not NaN.
  * - Boolean variables is considered as false statement.
+ * - Date objects is considered as true.
  *
  * @param variable the variable to validate
  * @return True: variable is a NaN; False: The variable is a number

package/dist/general/mix/isNaNV2.js

@@ -1,4 +1,5 @@
-import { isEmpty } from ".";
+import { isValidDateObject } from "../../dates/helpers/isValidDateObject";
+import { isEmpty } from "./isEmpty";
 /**
  * Validates if the recieved number is NaN type.
  *
@@ -9,10 +10,14 @@ import { isEmpty } from ".";
  * Special case for isNaN
  * - The isNaN('') is considered as false statement. The empty string is converted to 0 which is not NaN.
  * - Boolean variables is considered as false statement.
+ * - Date objects is considered as true.
  *
  * @param variable the variable to validate
  * @return True: variable is a NaN; False: The variable is a number
  */
 export function isNaNV2(variable) {
-    return isEmpty(variable) || typeof variable == "boolean" || isNaN(variable);
+    return (isEmpty(variable) ||
+        typeof variable == "boolean" ||
+        isNaN(variable) ||
+        isValidDateObject(variable));
 }

package/dist/general/numeric/getSign.js

@@ -4,5 +4,5 @@
  * @returns {string} an string with the sign
  */
 export function getSign(num) {
-    return Math.sign(num) > -1 ? "+" : "-";
+    return Math.sign(num) < 0 ? "-" : "+";
 }

package/dist/general/object/applyTimezoneDeep.d.ts

@@ -5,4 +5,4 @@ import { IDTimezone } from "../../dates/interfaces/IDTimezone";
  * @param {IDTimezone} timezone the timezone object
  * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
  */
-export declare function applyTimezoneDeep(obj: any, timezone: IDTimezone): any;
+export declare function applyTimezoneDeep<T = any>(obj: T, timezone: IDTimezone): T;

package/dist/general/object/applyTimezoneDeep.js

@@ -1,5 +1,6 @@
 import { DATE_FORMAT } from "../../dates/constants/DATE_FORMAT";
 import { getDateByTimezone } from "../../dates/helpers/getDateByTimezone";
+import { isValidDateObject } from "../../dates/helpers/isValidDateObject";
 import { validateDate } from "../../dates/helpers/validateDate";
 import { isEmpty } from "../mix/isEmpty";
 import { isObject } from "./isObject";
@@ -10,7 +11,7 @@ import { isObject } from "./isObject";
  * @returns {IFSData | IFUData} the new filter data with the transformed datetime values
  */
 export function applyTimezoneDeep(obj, timezone) {
-    if (isEmpty(obj))
+    if (!isValid(obj, timezone))
         return obj;
     let result;
     if (isObject(obj)) {
@@ -21,13 +22,13 @@ export function applyTimezoneDeep(obj, timezone) {
     }
     try {
         for (const i in obj) {
-            if (isObject(obj[i]) || Array.isArray(obj[i])) {
-                result[i] = applyTimezoneDeep(obj[i], timezone);
-            }
-            else if (obj[i] instanceof Date ||
+            if (isValidDateObject(obj[i]) ||
                 validateDate(obj[i], DATE_FORMAT.HOUR)) {
                 result[i] = getDateByTimezone(obj[i], timezone);
             }
+            else if (isObject(obj[i]) || Array.isArray(obj[i])) {
+                result[i] = applyTimezoneDeep(obj[i], timezone);
+            }
             else {
                 result[i] = obj[i];
             }
@@ -38,3 +39,6 @@ export function applyTimezoneDeep(obj, timezone) {
         return obj;
     }
 }
+function isValid(obj, timezone) {
+    return (!isEmpty(obj) && (Array.isArray(obj) || isObject(obj)) && !isEmpty(timezone));
+}

package/dist/general/object/isObject.js

@@ -6,5 +6,7 @@ import { getTag } from "../mix/getTag";
  */
 export function isObject(obj) {
     return (!Array.isArray(obj) &&
-        (obj === Object(obj) || getTag(obj) === "[object Object]"));
+        obj === Object(obj) &&
+        getTag(obj) !== "[object Function]" &&
+        (getTag(obj) === "[object Object]" || getTag(obj) === "[object Date]"));
 }

package/dist/general/object/objectCopy.d.ts

@@ -4,4 +4,4 @@
  * @param cache
  * @returns A new reference of the given argument
  */
-export declare function objectCopy(entity: any, cache?: WeakMap<object, any>): any;
+export declare function objectCopy<T = any>(entity: T, cache?: WeakMap<object, any>): T;

package/dist/general/object/removeUndefinedDeep.js

@@ -1,14 +1,17 @@
-import { cloneDeep } from "./cloneDeep";
 import { isObject } from "./isObject";
+import { objectCopy } from "./objectCopy";
 /**
  * Removes and returns the given object cleaning the undefined values
  * @param obj an object
  * @returns the new object with no undefined values
  */
 export function removeUndefinedDeep(obj) {
-    if (obj == null || !isObject(obj) || !Array.isArray(obj))
+    const isArray = Array.isArray(obj);
+    if (obj == null || (!isObject(obj) && !isArray))
         return obj;
-    const _obj = cloneDeep(obj);
+    let _obj = objectCopy(obj);
+    if (isArray)
+        _obj = _obj.filter(Boolean);
     Object.keys(_obj).forEach((key) => {
         if (isObject(_obj[key]) || Array.isArray(_obj[key])) {
             _obj[key] = removeUndefinedDeep(_obj[key]);

package/dist/general/string/padLeadingZeros.d.ts

@@ -1 +1,28 @@
-export declare function padLeadingZeros(num: number | string, size?: number): string;
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * padding = true
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = true
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 2
+ * padding = false
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = false
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} size the quantity of zeros to add
+ * @param {number} padding True: to pad with missing zeros; depending on the num length. False: to fill zeros by the amount.
+ * @returns the string of the number with the prefixed zeros
+ */
+export declare function padLeadingZeros(num: number | string, amount?: number, padding?: boolean): string;

package/dist/general/string/padLeadingZeros.js

@@ -1,8 +1,76 @@
-export function padLeadingZeros(num, size = 0) {
-    if (isNaN(Number(num)))
-        return String(num);
-    let s = `${num}`;
-    while (s.length < size)
-        s = `0${s}`;
-    return s;
+import { isEmpty } from "../mix";
+import { isNaNV2 } from "../mix/isNaNV2";
+import { getSign } from "../numeric/getSign";
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * padding = true
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = true
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 2
+ * padding = false
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * padding = false
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} size the quantity of zeros to add
+ * @param {number} padding True: to pad with missing zeros; depending on the num length. False: to fill zeros by the amount.
+ * @returns the string of the number with the prefixed zeros
+ */
+export function padLeadingZeros(num, amount = 0, padding = true) {
+    if (isValidLeadingZerosParams(num, amount))
+        return num;
+    const newPadding = !isEmpty(padding, true);
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    if (newPadding) {
+        while (absoluteStringNumber.length < amount)
+            absoluteStringNumber = `0${absoluteStringNumber}`;
+    }
+    else {
+        let i = 0;
+        while (i < amount) {
+            absoluteStringNumber = `0${absoluteStringNumber}`;
+            i = i + 1;
+        }
+    }
+    return `${sign}${absoluteStringNumber}`;
+}
+function isValidLeadingZerosParams(num, amount) {
+    return isNaNV2(num) || isNaNV2(amount);
+}
+/**
+ * Gets the absolute number of the giving parameters
+ * @param {number | string} num the number
+ * @param {string} sign the sign of the number
+ * @returns {string} the absolute number
+ */
+function getAbsoluteNum(num, sign = "") {
+    const stringNum = `${num}`;
+    return sign !== "" && `${stringNum}`.charAt(0) === sign
+        ? stringNum.substring(1)
+        : stringNum;
+}
+/**
+ * Gets the number sign
+ * @param {number | string} num the number
+ * @returns {string} the number sign
+ */
+function getNumSign(num) {
+    const stringNum = `${num}`;
+    const sign = getSign(num);
+    if (stringNum.charAt(0) === sign)
+        return sign;
+    return "";
 }

package/dist/globalization/labels/formula_builder/I18N_FORMULA_BUILDER.js

@@ -338,7 +338,7 @@ export const I18N_FORMULA_BUILDER = {
         function_placeholder: "String.length()",
     },
     function_now: {
-        description: "Return a date with the current time. Returned dates will have this format yyyy-MM-ddTHH:mm:ssZ.",
+        description: "Returns a date with the current time in the current timezone with the following format: yyyy-MM-ddTHH:mm:ss.",
         function_placeholder: "now()",
     },
     function_date_parse: {
@@ -393,7 +393,7 @@ export const I18N_FORMULA_BUILDER = {
         param_column_name: "column",
         param_column_description: "Date column to check.",
         param_replacement_name: "replacement",
-        param_replacement_description: 'Date replacement value.<br>Common Replacement Value Formats:<br>○ Using another date column "dateIsNull(Column1, Column2)"<br>○ Using another date function "dateIsNull(Column, now())"<br>○ Using specified date "dateIsNull(Column, dateParse(\'dd/MM/yyyy\', \'dd/MM/yyyy\'))"',
+        param_replacement_description: 'Date replacement value.<br>Common Replacement Value Formats:<br>○ Using another date column "dateIsNull(Column1, Column2)"<br>○ Using another date function "dateIsNull(Column, now())"<br>○ Using specified date "dateIsNull(Column, dateParse(\'31/12/2021\', \'dd/MM/yyyy\'))"',
     },
     function_agg_sum: {
         description: "A single-value metrics aggregation that sums up numeric values that are extracted from the documents",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qrvey/utils",
-  "version": "1.10.0-11",
+  "version": "1.10.0-13",
   "description": "Helper, Utils for all Qrvey Projects",
   "homepage": "https://bitbucket.org/qrvey/qrvey_utils/wiki/Home",
   "main": "dist/index.js",
@@ -15,8 +15,9 @@
     "publishing.beta.1": "node ./scripts/publishing --np-new-version=$npm_config_np_new_version --np-any-branch=$npm_config_np_any_branch --np-tag=$npm_config_np_tag",
     "publishing": "node ./scripts/clean-build && np $npm_config_np_new_version --any-branch --tag=$npm_config_np_tag",
     "publishing.win": "node ./scripts/clean-build && np %npm_config_np_new_version% --any-branch --tag=%npm_config_np_tag%",
-    "test": "jest test",
-    "test.watch": "jest --watch test",
+    "test": "jest test --verbose",
+    "test.coverage": "jest test --collect-coverage",
+    "test.watch": "jest test --watch ",
     "version": "auto-changelog -p && git add CHANGELOG.md"
   },
   "author": "Qrvey Inc",