@qrvey/utils 1.10.0-10 → 1.10.0-12

package/dist/cjs/dates/helpers/getTimezoneObject.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTimezoneObject = void 0;
 const isEmpty_1 = require("../../general/mix/isEmpty");
+const isNaNV2_1 = require("../../general/mix/isNaNV2");
 const TIMEZONE_TYPE_1 = require("../constants/TIMEZONE_TYPE");
 const getTimezoneOffsetByType_1 = require("./getTimezoneOffsetByType");
 const getUTCFormatByOffset_1 = require("./getUTCFormatByOffset");
@@ -92,7 +93,7 @@ function getTypeByOffset(offset) {
     else if (offset === "browser") {
         return TIMEZONE_TYPE_1.TIMEZONE_TYPE.BROWSER;
     }
-    else if ((0, isValidISOOffset_1.isValidISOOffset)(offset)) {
+    else if ((0, isValidISOOffset_1.isValidISOOffset)(offset) || !(0, isNaNV2_1.isNaNV2)(offset)) {
         return TIMEZONE_TYPE_1.TIMEZONE_TYPE.FIXED;
     }
     return TIMEZONE_TYPE_1.TIMEZONE_TYPE.DEFAULT;

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/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/fillLeadingZeros.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sets an amount of zeros as prefix of the given number
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} amount the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
+export declare function fillLeadingZeros(num: number | string, amount?: number): string;

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fillLeadingZeros = void 0;
+const isNaNV2_1 = require("../mix/isNaNV2");
+const getSign_1 = require("../numeric/getSign");
+/**
+ * Sets an amount of zeros as prefix of the given number
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} amount the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
+function fillLeadingZeros(num, amount = 0) {
+    if ((0, isNaNV2_1.isNaNV2)(num) || (0, isNaNV2_1.isNaNV2)(amount))
+        return num;
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    let i = 0;
+    while (i < amount) {
+        absoluteStringNumber = `0${absoluteStringNumber}`;
+        i = i + 1;
+    }
+    return `${sign}${absoluteStringNumber}`;
+}
+exports.fillLeadingZeros = fillLeadingZeros;
+/**
+ * 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/general/string/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./capitalize";
+export * from "./fillLeadingZeros";
 export * from "./padLeadingZeros";
 export * from "./parseUrl";

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

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./capitalize"), exports);
+__exportStar(require("./fillLeadingZeros"), exports);
 __exportStar(require("./padLeadingZeros"), exports);
 __exportStar(require("./parseUrl"), exports);

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

@@ -1 +1,15 @@
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00100"
+ * @param num the number
+ * @param size the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
 export declare function padLeadingZeros(num: number | string, size?: number): string;

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

@@ -1,12 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.padLeadingZeros = void 0;
+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
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00100"
+ * @param num the number
+ * @param size the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
 function padLeadingZeros(num, size = 0) {
-    if (isNaN(Number(num)))
-        return String(num);
-    let s = `${num}`;
-    while (s.length < size)
-        s = `0${s}`;
-    return s;
+    if ((0, isNaNV2_1.isNaNV2)(num) || (0, isNaNV2_1.isNaNV2)(size))
+        return num;
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    while (absoluteStringNumber.length < size)
+        absoluteStringNumber = `0${absoluteStringNumber}`;
+    return `${sign}${absoluteStringNumber}`;
 }
 exports.padLeadingZeros = padLeadingZeros;
+/**
+ * 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/helpers/getTimezoneObject.js

@@ -1,4 +1,5 @@
 import { isEmpty } from "../../general/mix/isEmpty";
+import { isNaNV2 } from "../../general/mix/isNaNV2";
 import { TIMEZONE_TYPE } from "../constants/TIMEZONE_TYPE";
 import { getTimezoneOffsetByType } from "./getTimezoneOffsetByType";
 import { getUTCFormatByOffset } from "./getUTCFormatByOffset";
@@ -88,7 +89,7 @@ function getTypeByOffset(offset) {
     else if (offset === "browser") {
         return TIMEZONE_TYPE.BROWSER;
     }
-    else if (isValidISOOffset(offset)) {
+    else if (isValidISOOffset(offset) || !isNaNV2(offset)) {
         return TIMEZONE_TYPE.FIXED;
     }
     return TIMEZONE_TYPE.DEFAULT;

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/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/fillLeadingZeros.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Sets an amount of zeros as prefix of the given number
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} amount the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
+export declare function fillLeadingZeros(num: number | string, amount?: number): string;

package/dist/general/string/fillLeadingZeros.js

@@ -0,0 +1,52 @@
+import { isNaNV2 } from "../mix/isNaNV2";
+import { getSign } from "../numeric/getSign";
+/**
+ * Sets an amount of zeros as prefix of the given number
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "00100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00000100"
+ * @param {number | string} num the number
+ * @param {number} amount the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
+export function fillLeadingZeros(num, amount = 0) {
+    if (isNaNV2(num) || isNaNV2(amount))
+        return num;
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    let i = 0;
+    while (i < amount) {
+        absoluteStringNumber = `0${absoluteStringNumber}`;
+        i = i + 1;
+    }
+    return `${sign}${absoluteStringNumber}`;
+}
+/**
+ * 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/general/string/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./capitalize";
+export * from "./fillLeadingZeros";
 export * from "./padLeadingZeros";
 export * from "./parseUrl";

package/dist/general/string/index.js

@@ -1,3 +1,4 @@
 export * from "./capitalize";
+export * from "./fillLeadingZeros";
 export * from "./padLeadingZeros";
 export * from "./parseUrl";

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

@@ -1 +1,15 @@
+/**
+ * Sets an amount of zeros as prefix of the given number by its length
+ * @example
+ * num = 100
+ * size = 2
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00100"
+ * @param num the number
+ * @param size the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
 export declare function padLeadingZeros(num: number | string, size?: number): string;

package/dist/general/string/padLeadingZeros.js

@@ -1,8 +1,49 @@
+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
+ * => Returns  "100"
+ * @example
+ * num = 100
+ * size = 5
+ * => Returns  "00100"
+ * @param num the number
+ * @param size the quantity of zeros to add
+ * @returns the string of the number with the prefixed zeros
+ */
 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;
+    if (isNaNV2(num) || isNaNV2(size))
+        return num;
+    const sign = getNumSign(num);
+    let absoluteStringNumber = getAbsoluteNum(num, sign);
+    while (absoluteStringNumber.length < size)
+        absoluteStringNumber = `0${absoluteStringNumber}`;
+    return `${sign}${absoluteStringNumber}`;
+}
+/**
+ * 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-10",
+  "version": "1.10.0-12",
   "description": "Helper, Utils for all Qrvey Projects",
   "homepage": "https://bitbucket.org/qrvey/qrvey_utils/wiki/Home",
   "main": "dist/index.js",