@qrvey/utils 1.2.4-13 → 1.2.4-17

package/dist/cjs/dates/adapters/quarterYearToDate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transforms String Date from a [Quarter Year] format to Date object.
+ * @param quarterYearDate String of [Quarter Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+export declare function quarterYearToDate(quarterYearDate: string, time?: boolean): string | number | Date;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quarterYearToDate = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const DATE_YEAR_QUARTERS_RANGE_1 = require("../constants/DATE_YEAR_QUARTERS_RANGE");
+const validateDate_1 = require("../helpers/validateDate");
+/**
+ * Transforms String Date from a [Quarter Year] format to Date object.
+ * @param quarterYearDate String of [Quarter Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+function quarterYearToDate(quarterYearDate, time = false) {
+    if ((0, isEmpty_1.isEmpty)(quarterYearDate) || (0, isTokenLabel_1.isTokenLabel)(quarterYearDate))
+        return quarterYearDate;
+    if ((0, validateDate_1.validateDate)(quarterYearDate, DATE_FORMAT_1.DATE_FORMAT.QUARTER)) {
+        const [quarter, year] = quarterYearDate.split(' ');
+        const start = new Date(+year, DATE_YEAR_QUARTERS_RANGE_1.DATE_YEAR_QUARTERS_RANGE[quarter].initial, 1);
+        return time ? +start : start;
+    }
+}
+exports.quarterYearToDate = quarterYearToDate;

package/dist/cjs/dates/adapters/weekYearToDate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transforms String Date from a [Week Year] format to Date object.
+ * @param date String of [Week Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+export declare function weekYearToDate(weekYear: string, time?: boolean): string | number | Date;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weekYearToDate = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const getWeek_1 = require("../helpers/getWeek");
+const validateDate_1 = require("../helpers/validateDate");
+/**
+ * Transforms String Date from a [Week Year] format to Date object.
+ * @param date String of [Week Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+function weekYearToDate(weekYear, time = false) {
+    if ((0, isEmpty_1.isEmpty)(weekYear) || (0, isTokenLabel_1.isTokenLabel)(weekYear))
+        return weekYear;
+    if ((0, validateDate_1.validateDate)(weekYear, DATE_FORMAT_1.DATE_FORMAT.WEEK)) {
+        const [week, year] = weekYear.split(' ');
+        const weekNumber = Number(week.substring(1));
+        const dateObj = new Date(+year, 1, 1);
+        const numOfdaysPastSinceLastSunday = dateObj.getDay();
+        dateObj.setDate(dateObj.getDate() - numOfdaysPastSinceLastSunday);
+        const weekNoToday = (0, getWeek_1.getWeek)(dateObj).week;
+        const weeksInTheFuture = weekNumber - weekNoToday;
+        dateObj.setDate(dateObj.getDate() + (7 * weeksInTheFuture));
+        const date = new Date((dateObj.getMonth() + 1) + '/' + dateObj.getDate() + '/' + dateObj.getFullYear());
+        return time ? +date : date;
+    }
+}
+exports.weekYearToDate = weekYearToDate;
+;

package/dist/cjs/dates/adapters/yearToDate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transforms String Date from a [Year] format to Date object.
+ * @param yearDate String of [Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+export declare function yearToDate(yearDate: string, time?: boolean): string | number | Date;

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yearToDate = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const validateDate_1 = require("../helpers/validateDate");
+/**
+ * Transforms String Date from a [Year] format to Date object.
+ * @param yearDate String of [Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+function yearToDate(yearDate, time = false) {
+    if ((0, isEmpty_1.isEmpty)(yearDate) || (0, isTokenLabel_1.isTokenLabel)(yearDate))
+        return yearDate;
+    if ((0, validateDate_1.validateDate)(yearDate, DATE_FORMAT_1.DATE_FORMAT.YEAR)) {
+        const start = new Date(+yearDate, 0, 1);
+        return time ? +start : start;
+    }
+}
+exports.yearToDate = yearToDate;

package/dist/cjs/dates/constants/DATE_FORMAT.d.ts

@@ -1,16 +1,18 @@
 export declare const DATE_FORMAT: {
-    year: string;
-    month: string;
-    quarter: string;
-    week: string;
-    day: string;
-    hour: string;
-    minute: string;
-    second: string;
-    day_only: string;
-    month_only: string;
-    quarter_only: string;
-    hour_only: string;
-    minute_only: string;
-    second_only: string;
+    YEAR: string;
+    MONTH: string;
+    QUARTER: string;
+    WEEK: string;
+    DAY: string;
+    DAY_TIME: string;
+    HOUR: string;
+    MINUTE: string;
+    SECOND: string;
+    MONTH_DAY: string;
+    YEAR_MONTH: string;
+    YEAR_QUARTER: string;
+    YEAR_WEEK: string;
+    DAY_HOUR: string;
+    HOUR_MINUTE: string;
+    MINUTE_SECOND: string;
 };

package/dist/cjs/dates/constants/DATE_FORMAT.js

@@ -1,23 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DATE_FORMAT = void 0;
-const DATE_GROUPING_TIME_PROPERTY_1 = require("./DATE_GROUPING_TIME_PROPERTY");
-const DATE_GROUPING_PROPERTY_1 = require("./DATE_GROUPING_PROPERTY");
-const DATE_DISTINCT_PROPERTY_1 = require("./DATE_DISTINCT_PROPERTY");
-const DATE_DISTINCT_TIME_PROPERTY_1 = require("./DATE_DISTINCT_TIME_PROPERTY");
+const YEAR = 'yyyy';
+const DAY = 'mm/dd/yyyy';
+const DAY_TIME = 'HH:mm:ss';
+const MONTH_DAY = 'dd';
+const YEAR_MONTH = 'M';
+const YEAR_QUARTER = 'Q#';
+const YEAR_WEEK = 'W#';
 exports.DATE_FORMAT = {
-    [DATE_GROUPING_PROPERTY_1.DATE_GROUPING_PROPERTY.YEAR]: 'yyyy',
-    [DATE_GROUPING_PROPERTY_1.DATE_GROUPING_PROPERTY.MONTH]: 'M yyyy',
-    [DATE_GROUPING_PROPERTY_1.DATE_GROUPING_PROPERTY.QUARTER]: 'Q# yyyy',
-    [DATE_GROUPING_PROPERTY_1.DATE_GROUPING_PROPERTY.WEEK]: 'W# yyyy',
-    [DATE_GROUPING_PROPERTY_1.DATE_GROUPING_PROPERTY.DAY]: 'mm/dd/yyyy',
-    [DATE_GROUPING_TIME_PROPERTY_1.DATE_GROUPING_TIME_PROPERTY.HOUR]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY_1.DATE_GROUPING_TIME_PROPERTY.MINUTE]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY_1.DATE_GROUPING_TIME_PROPERTY.SECOND]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_DISTINCT_PROPERTY_1.DATE_DISTINCT_PROPERTY.MONTH_DAY]: 'dd',
-    [DATE_DISTINCT_PROPERTY_1.DATE_DISTINCT_PROPERTY.YEAR_MONTH]: 'M',
-    [DATE_DISTINCT_PROPERTY_1.DATE_DISTINCT_PROPERTY.YEAR_QUARTER]: 'Q#',
-    [DATE_DISTINCT_TIME_PROPERTY_1.DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR]: 'HH',
-    [DATE_DISTINCT_TIME_PROPERTY_1.DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE]: 'mm',
-    [DATE_DISTINCT_TIME_PROPERTY_1.DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND]: 'ss',
+    YEAR: YEAR,
+    MONTH: `${YEAR_MONTH} ${YEAR}`,
+    QUARTER: `${YEAR_QUARTER} ${YEAR}`,
+    WEEK: `${YEAR_WEEK} ${YEAR}`,
+    DAY: DAY,
+    DAY_TIME: DAY_TIME,
+    HOUR: `${DAY} ${DAY_TIME}`,
+    MINUTE: `${DAY} ${DAY_TIME}`,
+    SECOND: `${DAY} ${DAY_TIME}`,
+    MONTH_DAY: MONTH_DAY,
+    YEAR_MONTH: YEAR_MONTH,
+    YEAR_QUARTER: YEAR_QUARTER,
+    YEAR_WEEK: YEAR_WEEK,
+    DAY_HOUR: 'HH',
+    HOUR_MINUTE: 'mm',
+    MINUTE_SECOND: 'ss',
 };

package/dist/cjs/dates/constants/DATE_REGULAR_EXPRESSION.d.ts

@@ -1 +1,19 @@
-export declare const DATE_REGULAR_EXPRESSION: {};
+export declare const DATE_REGULAR_EXPRESSION: {
+    YEAR: string;
+    MONTH: string;
+    QUARTER: string;
+    WEEK: string;
+    DAY: string;
+    DAY_TIME: string;
+    HOUR: string;
+    MINUTE: string;
+    SECOND: string;
+    MONTH_DAY: string;
+    YEAR_MONTH: string;
+    YEAR_MONTH_NUMBER: string;
+    YEAR_QUARTER: string;
+    YEAR_WEEK: string;
+    DAY_HOUR: string;
+    HOUR_MINUTE: string;
+    MINUTE_SECOND: string;
+};

package/dist/cjs/dates/constants/DATE_REGULAR_EXPRESSION.js

@@ -1,10 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DATE_REGULAR_EXPRESSION = void 0;
+const DATE_YEAR_MONTHS_1 = require("./DATE_YEAR_MONTHS");
+const DATE_YEAR_QUARTERS_1 = require("./DATE_YEAR_QUARTERS");
+const YEAR = '\\d{4}';
+const YEAR_MONTH = `(${DATE_YEAR_MONTHS_1.DATE_YEAR_MONTHS.join('|')})`;
+const YEAR_MONTH_NUMBER = '((0)[1-9]|[0-1][0-2])';
+const YEAR_QUARTER = `(${DATE_YEAR_QUARTERS_1.DATE_YEAR_QUARTERS.join('|')})`;
+const YEAR_WEEK = '(W)(5[0-3]|[1-4][0-9]|[1-9])';
+const MONTH_DAY = '(0?[1-9]|[12][0-9]|3[01])';
+const DAY_HOUR = '(([0-1][0-9])|(2[0-3]))';
+const HOUR_MINUTE = '[0-5][0-9]';
+const MINUTE_SECOND = '[0-5][0-9]';
+const DAY_TIME = `((${DAY_HOUR}:?${HOUR_MINUTE}:?${MINUTE_SECOND}+))`;
 exports.DATE_REGULAR_EXPRESSION = {
-// MONTH_NUMBER: new RegExp('^((0)[1-9]|[0-1][0-2])$'),
-// DAY: new RegExp('^(0?[1-9]|[12][0-9]|3[01])$'),
-// YEAR: new RegExp(`\\d{4}$`, 'g'),
-// MONTH_LABEL: new RegExp(`^(${months.join('|')})$`, 'g'),
-// QUARTER: new RegExp(`(${quarters.join('|')})`, 'g')
+    YEAR: `^${YEAR}$`,
+    MONTH: `^${YEAR_MONTH} ${YEAR}$`,
+    QUARTER: `^${YEAR_QUARTER} ${YEAR}$`,
+    WEEK: `^${YEAR_WEEK} ${YEAR}$`,
+    DAY: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR}$`,
+    DAY_TIME: `^${DAY_TIME}$`,
+    HOUR: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    MINUTE: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    SECOND: `^${YEAR_MONTH_NUMBER}/${MONTH_DAY}/${YEAR} ${DAY_TIME}$`,
+    MONTH_DAY: `^${MONTH_DAY}$`,
+    YEAR_MONTH: `^${YEAR_MONTH}$`,
+    YEAR_MONTH_NUMBER: `${YEAR_MONTH_NUMBER}`,
+    YEAR_QUARTER: `^${YEAR_QUARTER}$`,
+    YEAR_WEEK: `^${YEAR_WEEK}$`,
+    DAY_HOUR: `^${DAY_HOUR}$`,
+    HOUR_MINUTE: `^${HOUR_MINUTE}$`,
+    MINUTE_SECOND: `^${MINUTE_SECOND}$`,
 };

package/dist/cjs/dates/constants/DATE_YEAR_QUARTERS_RANGE.d.ts

@@ -0,0 +1,18 @@
+export declare const DATE_YEAR_QUARTERS_RANGE: {
+    Q1: {
+        initial: number;
+        final: number;
+    };
+    Q2: {
+        initial: number;
+        final: number;
+    };
+    Q3: {
+        initial: number;
+        final: number;
+    };
+    Q4: {
+        initial: number;
+        final: number;
+    };
+};

package/dist/cjs/dates/constants/DATE_YEAR_QUARTERS_RANGE.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATE_YEAR_QUARTERS_RANGE = void 0;
+exports.DATE_YEAR_QUARTERS_RANGE = {
+    Q1: {
+        initial: 0,
+        final: 2
+    },
+    Q2: {
+        initial: 3,
+        final: 5
+    },
+    Q3: {
+        initial: 6,
+        final: 8
+    },
+    Q4: {
+        initial: 9,
+        final: 11
+    }
+};

package/dist/cjs/dates/constants/index.d.ts

@@ -30,3 +30,4 @@ export * from './DATE_WEEK_DAYS';
 export * from './DATE_YEAR_DAYS';
 export * from './DATE_YEAR_MONTHS';
 export * from './DATE_YEAR_QUARTERS';
+export * from './DATE_YEAR_QUARTERS_RANGE';

package/dist/cjs/dates/constants/index.js

@@ -42,3 +42,4 @@ __exportStar(require("./DATE_WEEK_DAYS"), exports);
 __exportStar(require("./DATE_YEAR_DAYS"), exports);
 __exportStar(require("./DATE_YEAR_MONTHS"), exports);
 __exportStar(require("./DATE_YEAR_QUARTERS"), exports);
+__exportStar(require("./DATE_YEAR_QUARTERS_RANGE"), exports);

package/dist/cjs/dates/helpers/getDateByDateFormat.d.ts

@@ -0,0 +1,9 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets a Date Object instance by a Date format
+ * @param date String with a formatted date
+ * @param format The date format
+ * @param time flag to convert the formatted date to miliseconds
+ * @returns a Date object, milisecond time or the same value if date format does not match.
+ */
+export declare function getDateByDateFormat(date: string, format: IDateFormat, time?: boolean): string | number | Date;

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDateByDateFormat = void 0;
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const yearToDate_1 = require("../adapters/yearToDate");
+const monthYearToDate_1 = require("../adapters/monthYearToDate");
+const quarterYearToDate_1 = require("../adapters/quarterYearToDate");
+const weekYearToDate_1 = require("../adapters/weekYearToDate");
+const mdyDateToDate_1 = require("../adapters/mdyDateToDate");
+/**
+ * Gets a Date Object instance by a Date format
+ * @param date String with a formatted date
+ * @param format The date format
+ * @param time flag to convert the formatted date to miliseconds
+ * @returns a Date object, milisecond time or the same value if date format does not match.
+ */
+function getDateByDateFormat(date, format, time = false) {
+    switch (format) {
+        case DATE_FORMAT_1.DATE_FORMAT.YEAR:
+            return (0, yearToDate_1.yearToDate)(date, time);
+        case DATE_FORMAT_1.DATE_FORMAT.MONTH:
+            return (0, monthYearToDate_1.monthYearToDate)(date, time);
+        case DATE_FORMAT_1.DATE_FORMAT.QUARTER:
+            return (0, quarterYearToDate_1.quarterYearToDate)(date, time);
+        case DATE_FORMAT_1.DATE_FORMAT.WEEK:
+            return (0, weekYearToDate_1.weekYearToDate)(date, time);
+        case DATE_FORMAT_1.DATE_FORMAT.DAY:
+        case DATE_FORMAT_1.DATE_FORMAT.HOUR:
+        case DATE_FORMAT_1.DATE_FORMAT.MINUTE:
+        case DATE_FORMAT_1.DATE_FORMAT.SECOND:
+            return (0, mdyDateToDate_1.mdyDateToDate)(date, time);
+        default:
+            return date;
+    }
+}
+exports.getDateByDateFormat = getDateByDateFormat;

package/dist/cjs/dates/helpers/getDateFormatByProperty.d.ts

@@ -0,0 +1,8 @@
+import { IColumnPropertyType } from "../../columns/interfaces/IColumnPropertyType";
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+export declare function getDateFormatByProperty(property: IColumnPropertyType): IDateFormat;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDateFormatByProperty = void 0;
+const COLUMN_PROPERTY_1 = require("../../columns/constants/COLUMN_PROPERTY");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+function getDateFormatByProperty(property) {
+    return property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.YEAR ? DATE_FORMAT_1.DATE_FORMAT.YEAR :
+        property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.MONTH ? DATE_FORMAT_1.DATE_FORMAT.MONTH :
+            property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.QUARTER ? DATE_FORMAT_1.DATE_FORMAT.QUARTER :
+                property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.WEEK ? DATE_FORMAT_1.DATE_FORMAT.WEEK :
+                    property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.DAY ? DATE_FORMAT_1.DATE_FORMAT.DAY :
+                        property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.HOUR ? DATE_FORMAT_1.DATE_FORMAT.HOUR :
+                            property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.MINUTE ? DATE_FORMAT_1.DATE_FORMAT.MINUTE :
+                                property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.SECOND ? DATE_FORMAT_1.DATE_FORMAT.SECOND :
+                                    property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.MONTH_DAY ? DATE_FORMAT_1.DATE_FORMAT.MONTH_DAY :
+                                        property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.YEAR_MONTH ? DATE_FORMAT_1.DATE_FORMAT.YEAR_MONTH :
+                                            property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.YEAR_QUARTER ? DATE_FORMAT_1.DATE_FORMAT.YEAR_QUARTER :
+                                                property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.DAY_HOUR ? DATE_FORMAT_1.DATE_FORMAT.DAY_HOUR :
+                                                    property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.HOUR_MINUTE ? DATE_FORMAT_1.DATE_FORMAT.HOUR_MINUTE :
+                                                        property === COLUMN_PROPERTY_1.COLUMN_PROPERTY.MINUTE_SECOND ? DATE_FORMAT_1.DATE_FORMAT.MINUTE_SECOND : undefined;
+}
+exports.getDateFormatByProperty = getDateFormatByProperty;

package/dist/cjs/dates/helpers/getDateFormatRegularExpressionInArray.d.ts

@@ -0,0 +1,7 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets an array of regular expressions by the given date format
+ * @param dateFormat the date format
+ * @returns an array of regular expressions
+ */
+export declare function getDateFormatRegularExpressionInArray(dateFormat?: IDateFormat): string[];

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDateFormatRegularExpressionInArray = void 0;
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const DATE_REGULAR_EXPRESSION_1 = require("../constants/DATE_REGULAR_EXPRESSION");
+/**
+ * Gets an array of regular expressions by the given date format
+ * @param dateFormat the date format
+ * @returns an array of regular expressions
+ */
+function getDateFormatRegularExpressionInArray(dateFormat = DATE_FORMAT_1.DATE_FORMAT.DAY) {
+    switch (dateFormat) {
+        case DATE_FORMAT_1.DATE_FORMAT.YEAR:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT_1.DATE_FORMAT.MONTH:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_MONTH, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT_1.DATE_FORMAT.QUARTER:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_QUARTER, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT_1.DATE_FORMAT.WEEK:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_WEEK, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT_1.DATE_FORMAT.DAY:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT_1.DATE_FORMAT.DAY_TIME:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT_1.DATE_FORMAT.HOUR:
+        case DATE_FORMAT_1.DATE_FORMAT.MINUTE:
+        case DATE_FORMAT_1.DATE_FORMAT.SECOND:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.DAY, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT_1.DATE_FORMAT.MONTH_DAY:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.MONTH_DAY];
+        case DATE_FORMAT_1.DATE_FORMAT.YEAR_MONTH:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_MONTH];
+        case DATE_FORMAT_1.DATE_FORMAT.YEAR_QUARTER:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_QUARTER];
+        case DATE_FORMAT_1.DATE_FORMAT.YEAR_WEEK:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_WEEK];
+        case DATE_FORMAT_1.DATE_FORMAT.DAY_HOUR:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.DAY_HOUR];
+        case DATE_FORMAT_1.DATE_FORMAT.HOUR_MINUTE:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.HOUR_MINUTE];
+        case DATE_FORMAT_1.DATE_FORMAT.MINUTE_SECOND:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.MINUTE_SECOND];
+        default:
+            return [DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION_1.DATE_REGULAR_EXPRESSION.YEAR];
+    }
+}
+exports.getDateFormatRegularExpressionInArray = getDateFormatRegularExpressionInArray;

package/dist/cjs/dates/helpers/getSeparatorByDateFormat.d.ts

@@ -0,0 +1,7 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+export declare function getSeparatorByDateFormat(format?: IDateFormat): string;

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSeparatorByDateFormat = void 0;
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+function getSeparatorByDateFormat(format = DATE_FORMAT_1.DATE_FORMAT.DAY) {
+    return format === DATE_FORMAT_1.DATE_FORMAT.YEAR || format === DATE_FORMAT_1.DATE_FORMAT.DAY_TIME || format === DATE_FORMAT_1.DATE_FORMAT.MONTH_DAY || format === DATE_FORMAT_1.DATE_FORMAT.YEAR_MONTH || format === DATE_FORMAT_1.DATE_FORMAT.YEAR_QUARTER || format === DATE_FORMAT_1.DATE_FORMAT.YEAR_WEEK || format === DATE_FORMAT_1.DATE_FORMAT.DAY_HOUR || format === DATE_FORMAT_1.DATE_FORMAT.HOUR_MINUTE || format === DATE_FORMAT_1.DATE_FORMAT.MINUTE_SECOND ? '' :
+        format === DATE_FORMAT_1.DATE_FORMAT.MONTH || format === DATE_FORMAT_1.DATE_FORMAT.QUARTER || format === DATE_FORMAT_1.DATE_FORMAT.WEEK || format === DATE_FORMAT_1.DATE_FORMAT.HOUR || format === DATE_FORMAT_1.DATE_FORMAT.MINUTE || format === DATE_FORMAT_1.DATE_FORMAT.SECOND ? ' ' :
+            '/';
+}
+exports.getSeparatorByDateFormat = getSeparatorByDateFormat;

package/dist/cjs/dates/helpers/getWeek.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Gets the week number of the year
+ * Additionally, the month and the year
+ * @param date the date object
+ * @returns an object with the week, month and year.
+ */
+export declare function getWeek(date: Date): {
+    week: number;
+    month: number;
+    year: number;
+};

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWeek = void 0;
+/**
+ * Gets the week number of the year
+ * Additionally, the month and the year
+ * @param date the date object
+ * @returns an object with the week, month and year.
+ */
+function getWeek(date) {
+    const target = new Date(date.valueOf());
+    const dayNr = (date.getDay() + 6) % 7;
+    target.setDate(target.getDate() - dayNr + 3);
+    const firstThursday = target.valueOf();
+    target.setMonth(0, 1);
+    if (target.getDay() !== 4) {
+        target.setMonth(0, 1 + ((4 - target.getDay()) + 7) % 7);
+    }
+    return {
+        week: 1 + Math.ceil((firstThursday - +target) / 604800000),
+        month: target.getMonth() + 1,
+        year: target.getFullYear()
+    };
+}
+exports.getWeek = getWeek;

package/dist/cjs/dates/helpers/index.d.ts

@@ -0,0 +1,6 @@
+export * from './getDateFormatByProperty';
+export * from './getDateFormatRegularExpressionInArray';
+export * from './getSeparatorByDateFormat';
+export * from './getWeek';
+export * from './validateDate';
+export * from './validateDateByDateFormat';

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

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./getDateFormatByProperty"), exports);
+__exportStar(require("./getDateFormatRegularExpressionInArray"), exports);
+__exportStar(require("./getSeparatorByDateFormat"), exports);
+__exportStar(require("./getWeek"), exports);
+__exportStar(require("./validateDate"), exports);
+__exportStar(require("./validateDateByDateFormat"), exports);

package/dist/cjs/dates/helpers/validateDate.d.ts

@@ -0,0 +1,11 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Validate a string date depending on giving format
+ * - If the string is a token label, the function lets it pass.
+ * - Otherwise depends of the format
+ * - Some escenarios the string is a mix of token labels and dates
+ * @param date String of date
+ * @param format String of the format to validate
+ * @returns True if it is valid or not. Undefined if date is undefined
+ */
+export declare function validateDate(date: string, format?: IDateFormat): boolean;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDate = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const validateDateByDateFormat_1 = require("./validateDateByDateFormat");
+/**
+ * Validate a string date depending on giving format
+ * - If the string is a token label, the function lets it pass.
+ * - Otherwise depends of the format
+ * - Some escenarios the string is a mix of token labels and dates
+ * @param date String of date
+ * @param format String of the format to validate
+ * @returns True if it is valid or not. Undefined if date is undefined
+ */
+function validateDate(date, format = DATE_FORMAT_1.DATE_FORMAT.DAY) {
+    if ((0, isEmpty_1.isEmpty)(date))
+        return false;
+    if ((0, isTokenLabel_1.isTokenLabel)(date))
+        return true;
+    return (0, validateDateByDateFormat_1.validateDateByDateFormat)(date, format);
+}
+exports.validateDate = validateDate;

package/dist/cjs/dates/helpers/validateDateByDateFormat.d.ts

@@ -0,0 +1,8 @@
+import { IDateFormat } from "../interfaces/IDateFormat";
+/**
+ * Validates the given string as Date by its date format.
+ * @param date a string to validate as date form
+ * @param dateForma the format of the date to validate the string
+ * @returns true: the string is a valida date
+ */
+export declare function validateDateByDateFormat(date: string, dateFormat?: IDateFormat): boolean;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDateByDateFormat = void 0;
+const isTokenLabel_1 = require("../../tokens/isTokenLabel");
+const DATE_FORMAT_1 = require("../constants/DATE_FORMAT");
+const getDateFormatRegularExpressionInArray_1 = require("./getDateFormatRegularExpressionInArray");
+const getSeparatorByDateFormat_1 = require("./getSeparatorByDateFormat");
+/**
+ * Validates the given string as Date by its date format.
+ * @param date a string to validate as date form
+ * @param dateForma the format of the date to validate the string
+ * @returns true: the string is a valida date
+ */
+function validateDateByDateFormat(date, dateFormat = DATE_FORMAT_1.DATE_FORMAT.DAY) {
+    const resultValidation = [];
+    const separator = (0, getSeparatorByDateFormat_1.getSeparatorByDateFormat)(dateFormat);
+    const separatedDate = date.split(separator);
+    const regularExpression = (0, getDateFormatRegularExpressionInArray_1.getDateFormatRegularExpressionInArray)(dateFormat);
+    if (regularExpression.length !== separatedDate.length)
+        return false;
+    for (let i = 0; i < separatedDate.length; i++) {
+        resultValidation.push((0, isTokenLabel_1.isTokenLabel)(separatedDate[i]) || new RegExp(regularExpression[i], 'g').test(separatedDate[i]));
+    }
+    return resultValidation.every(validValue => validValue);
+}
+exports.validateDateByDateFormat = validateDateByDateFormat;

package/dist/cjs/dates/index.d.ts

@@ -1,4 +1,5 @@
 export * from './constants/index';
+export * from './helpers/index';
 export * from './interfaces/index';
 export * from './range/index';
 export * from './relative/index';

package/dist/cjs/dates/index.js

@@ -11,6 +11,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./constants/index"), exports);
+__exportStar(require("./helpers/index"), exports);
 __exportStar(require("./interfaces/index"), exports);
 __exportStar(require("./range/index"), exports);
 __exportStar(require("./relative/index"), exports);