@qrvey/utils 1.2.7 → 1.2.8

package/dist/dates/constants/DATE_DISTINCT_TIME_PROPERTY_INFO.js

@@ -1,7 +1,7 @@
 import { DATE_DISTINCT_TIME_PROPERTY } from "./DATE_DISTINCT_TIME_PROPERTY";
 import { DATE_DISTINCT_TIME_PROPERTY_LABEL } from "./DATE_DISTINCT_TIME_PROPERTY_LABEL";
 export const DATE_DISTINCT_TIME_PROPERTY_INFO = {
-    [DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.DAY_HOUR, shortLabel: 'Hour', abbrLabel: 'H', value: DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR, displayed: true },
-    [DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.HOUR_MINUTE, shortLabel: 'Minute', abbrLabel: 'M', value: DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE, displayed: true },
-    [DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.MINUTE_SECOND, shortLabel: 'Second', abbrLabel: 'S', value: DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND, displayed: true },
+    [DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.DAY_HOUR, shortLabel: 'Hour', abbrLabel: 'H', value: DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR, displayed: true, i18nLabelPath: 'common.properties.date_hour_only_label' },
+    [DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.HOUR_MINUTE, shortLabel: 'Minute', abbrLabel: 'M', value: DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE, displayed: true, i18nLabelPath: 'common.properties.date_minute_only_label' },
+    [DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND]: { label: DATE_DISTINCT_TIME_PROPERTY_LABEL.MINUTE_SECOND, shortLabel: 'Second', abbrLabel: 'S', value: DATE_DISTINCT_TIME_PROPERTY.MINUTE_SECOND, displayed: true, i18nLabelPath: 'common.properties.date_second_only_label' },
 };

package/dist/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/dates/constants/DATE_FORMAT.js

@@ -1,20 +1,25 @@
-import { DATE_GROUPING_TIME_PROPERTY } from "./DATE_GROUPING_TIME_PROPERTY";
-import { DATE_GROUPING_PROPERTY } from "./DATE_GROUPING_PROPERTY";
-import { DATE_DISTINCT_PROPERTY } from "./DATE_DISTINCT_PROPERTY";
-import { DATE_DISTINCT_TIME_PROPERTY } from "./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#';
 export const DATE_FORMAT = {
-    [DATE_GROUPING_PROPERTY.YEAR]: 'yyyy',
-    [DATE_GROUPING_PROPERTY.MONTH]: 'M yyyy',
-    [DATE_GROUPING_PROPERTY.QUARTER]: 'Q# yyyy',
-    [DATE_GROUPING_PROPERTY.WEEK]: 'W# yyyy',
-    [DATE_GROUPING_PROPERTY.DAY]: 'mm/dd/yyyy',
-    [DATE_GROUPING_TIME_PROPERTY.HOUR]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY.MINUTE]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_GROUPING_TIME_PROPERTY.SECOND]: 'mm/dd/yyyy HH:mm:ss',
-    [DATE_DISTINCT_PROPERTY.MONTH_DAY]: 'dd',
-    [DATE_DISTINCT_PROPERTY.YEAR_MONTH]: 'M',
-    [DATE_DISTINCT_PROPERTY.YEAR_QUARTER]: 'Q#',
-    [DATE_DISTINCT_TIME_PROPERTY.DAY_HOUR]: 'HH',
-    [DATE_DISTINCT_TIME_PROPERTY.HOUR_MINUTE]: 'mm',
-    [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/dates/constants/DATE_GROUPING_PROPERTY_INFO.js

@@ -1,9 +1,9 @@
 import { DATE_GROUPING_PROPERTY } from "./DATE_GROUPING_PROPERTY";
 import { DATE_GROUPING_PROPERTY_LABEL } from "./DATE_GROUPING_PROPERTY_LABEL";
 export const DATE_GROUPING_PROPERTY_INFO = {
-    [DATE_GROUPING_PROPERTY.DAY]: { value: DATE_GROUPING_PROPERTY.DAY, label: DATE_GROUPING_PROPERTY_LABEL.DAY, shortLabel: 'Day', abbrLabel: 'DY', displayed: true },
-    [DATE_GROUPING_PROPERTY.YEAR]: { value: DATE_GROUPING_PROPERTY.YEAR, label: DATE_GROUPING_PROPERTY_LABEL.YEAR, shortLabel: 'Year', abbrLabel: 'Y', displayed: true },
-    [DATE_GROUPING_PROPERTY.QUARTER]: { value: DATE_GROUPING_PROPERTY.QUARTER, label: DATE_GROUPING_PROPERTY_LABEL.QUARTER, shortLabel: 'Quarter', abbrLabel: 'Q', displayed: true },
-    [DATE_GROUPING_PROPERTY.MONTH]: { value: DATE_GROUPING_PROPERTY.MONTH, label: DATE_GROUPING_PROPERTY_LABEL.MONTH, shortLabel: 'Month', abbrLabel: 'M', displayed: true },
-    [DATE_GROUPING_PROPERTY.WEEK]: { value: DATE_GROUPING_PROPERTY.WEEK, label: DATE_GROUPING_PROPERTY_LABEL.WEEK, shortLabel: 'Week', abbrLabel: 'W', displayed: true }
+    [DATE_GROUPING_PROPERTY.DAY]: { value: DATE_GROUPING_PROPERTY.DAY, label: DATE_GROUPING_PROPERTY_LABEL.DAY, shortLabel: 'Day', abbrLabel: 'DY', displayed: true, i18nLabelPath: 'common.properties.date_day_label' },
+    [DATE_GROUPING_PROPERTY.YEAR]: { value: DATE_GROUPING_PROPERTY.YEAR, label: DATE_GROUPING_PROPERTY_LABEL.YEAR, shortLabel: 'Year', abbrLabel: 'Y', displayed: true, i18nLabelPath: 'common.properties.date_year_label' },
+    [DATE_GROUPING_PROPERTY.QUARTER]: { value: DATE_GROUPING_PROPERTY.QUARTER, label: DATE_GROUPING_PROPERTY_LABEL.QUARTER, shortLabel: 'Quarter', abbrLabel: 'Q', displayed: true, i18nLabelPath: 'common.properties.date_quarter_label' },
+    [DATE_GROUPING_PROPERTY.MONTH]: { value: DATE_GROUPING_PROPERTY.MONTH, label: DATE_GROUPING_PROPERTY_LABEL.MONTH, shortLabel: 'Month', abbrLabel: 'M', displayed: true, i18nLabelPath: 'common.properties.date_month_label' },
+    [DATE_GROUPING_PROPERTY.WEEK]: { value: DATE_GROUPING_PROPERTY.WEEK, label: DATE_GROUPING_PROPERTY_LABEL.WEEK, shortLabel: 'Week', abbrLabel: 'W', displayed: true, i18nLabelPath: 'common.properties.date_week_label' },
 };

package/dist/dates/constants/DATE_GROUPING_TIME_PROPERTY_INFO.js

@@ -1,7 +1,7 @@
 import { DATE_GROUPING_TIME_PROPERTY } from "./DATE_GROUPING_TIME_PROPERTY";
 import { DATE_GROUPING_TIME_PROPERTY_LABEL } from "./DATE_GROUPING_TIME_PROPERTY_LABEL";
 export const DATE_GROUPING_TIME_PROPERTY_INFO = {
-    [DATE_GROUPING_TIME_PROPERTY.HOUR]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.HOUR, shortLabel: 'Date, Hour', abbrLabel: 'D-H', value: DATE_GROUPING_TIME_PROPERTY.HOUR, displayed: true },
-    [DATE_GROUPING_TIME_PROPERTY.MINUTE]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.MINUTE, shortLabel: 'Date, Minute', abbrLabel: 'D-M', value: DATE_GROUPING_TIME_PROPERTY.MINUTE, displayed: true },
-    [DATE_GROUPING_TIME_PROPERTY.SECOND]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.SECOND, shortLabel: 'Date, Second', abbrLabel: 'D-S', value: DATE_GROUPING_TIME_PROPERTY.SECOND, displayed: true },
+    [DATE_GROUPING_TIME_PROPERTY.HOUR]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.HOUR, shortLabel: 'Date, Hour', abbrLabel: 'D-H', value: DATE_GROUPING_TIME_PROPERTY.HOUR, displayed: true, i18nLabelPath: 'common.properties.date_hour_label' },
+    [DATE_GROUPING_TIME_PROPERTY.MINUTE]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.MINUTE, shortLabel: 'Date, Minute', abbrLabel: 'D-M', value: DATE_GROUPING_TIME_PROPERTY.MINUTE, displayed: true, i18nLabelPath: 'common.properties.date_minute_label' },
+    [DATE_GROUPING_TIME_PROPERTY.SECOND]: { label: DATE_GROUPING_TIME_PROPERTY_LABEL.SECOND, shortLabel: 'Date, Second', abbrLabel: 'D-S', value: DATE_GROUPING_TIME_PROPERTY.SECOND, displayed: true, i18nLabelPath: 'common.properties.date_second_label' },
 };

package/dist/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/dates/constants/DATE_REGULAR_EXPRESSION.js

@@ -1,7 +1,31 @@
+import { DATE_YEAR_MONTHS } from "./DATE_YEAR_MONTHS";
+import { DATE_YEAR_QUARTERS } from "./DATE_YEAR_QUARTERS";
+const YEAR = '\\d{4}';
+const YEAR_MONTH = `(${DATE_YEAR_MONTHS.join('|')})`;
+const YEAR_MONTH_NUMBER = '((0)[1-9]|[0-1][0-2])';
+const YEAR_QUARTER = `(${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}+))`;
 export const 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/dates/constants/DATE_YEAR_MONTHS_MMMM.d.ts

@@ -0,0 +1 @@
+export declare const DATE_YEAR_MONTHS_MMMM: string[];

package/dist/dates/constants/DATE_YEAR_MONTHS_MMMM.js

@@ -0,0 +1 @@
+export const DATE_YEAR_MONTHS_MMMM = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];

package/dist/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/dates/constants/DATE_YEAR_QUARTERS_RANGE.js

@@ -0,0 +1,18 @@
+export const 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/dates/constants/index.d.ts

@@ -29,4 +29,6 @@ export * from './DATE_REGULAR_EXPRESSION';
 export * from './DATE_WEEK_DAYS';
 export * from './DATE_YEAR_DAYS';
 export * from './DATE_YEAR_MONTHS';
+export * from './DATE_YEAR_MONTHS_MMMM';
 export * from './DATE_YEAR_QUARTERS';
+export * from './DATE_YEAR_QUARTERS_RANGE';

package/dist/dates/constants/index.js

@@ -29,4 +29,6 @@ export * from './DATE_REGULAR_EXPRESSION';
 export * from './DATE_WEEK_DAYS';
 export * from './DATE_YEAR_DAYS';
 export * from './DATE_YEAR_MONTHS';
+export * from './DATE_YEAR_MONTHS_MMMM';
 export * from './DATE_YEAR_QUARTERS';
+export * from './DATE_YEAR_QUARTERS_RANGE';

package/dist/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/dates/helpers/getDateByDateFormat.js

@@ -0,0 +1,32 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { yearToDate } from "../adapters/yearToDate";
+import { monthYearToDate } from "../adapters/monthYearToDate";
+import { quarterYearToDate } from "../adapters/quarterYearToDate";
+import { weekYearToDate } from "../adapters/weekYearToDate";
+import { mdyDateToDate } from "../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.
+ */
+export function getDateByDateFormat(date, format, time = false) {
+    switch (format) {
+        case DATE_FORMAT.YEAR:
+            return yearToDate(date, time);
+        case DATE_FORMAT.MONTH:
+            return monthYearToDate(date, time);
+        case DATE_FORMAT.QUARTER:
+            return quarterYearToDate(date, time);
+        case DATE_FORMAT.WEEK:
+            return weekYearToDate(date, time);
+        case DATE_FORMAT.DAY:
+        case DATE_FORMAT.HOUR:
+        case DATE_FORMAT.MINUTE:
+        case DATE_FORMAT.SECOND:
+            return mdyDateToDate(date, time);
+        default:
+            return date;
+    }
+}

package/dist/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/dates/helpers/getDateFormatByProperty.js

@@ -0,0 +1,23 @@
+import { COLUMN_PROPERTY } from "../../columns/constants/COLUMN_PROPERTY";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+export function getDateFormatByProperty(property) {
+    return property === COLUMN_PROPERTY.YEAR ? DATE_FORMAT.YEAR :
+        property === COLUMN_PROPERTY.MONTH ? DATE_FORMAT.MONTH :
+            property === COLUMN_PROPERTY.QUARTER ? DATE_FORMAT.QUARTER :
+                property === COLUMN_PROPERTY.WEEK ? DATE_FORMAT.WEEK :
+                    property === COLUMN_PROPERTY.DAY ? DATE_FORMAT.DAY :
+                        property === COLUMN_PROPERTY.HOUR ? DATE_FORMAT.HOUR :
+                            property === COLUMN_PROPERTY.MINUTE ? DATE_FORMAT.MINUTE :
+                                property === COLUMN_PROPERTY.SECOND ? DATE_FORMAT.SECOND :
+                                    property === COLUMN_PROPERTY.MONTH_DAY ? DATE_FORMAT.MONTH_DAY :
+                                        property === COLUMN_PROPERTY.YEAR_MONTH ? DATE_FORMAT.YEAR_MONTH :
+                                            property === COLUMN_PROPERTY.YEAR_QUARTER ? DATE_FORMAT.YEAR_QUARTER :
+                                                property === COLUMN_PROPERTY.DAY_HOUR ? DATE_FORMAT.DAY_HOUR :
+                                                    property === COLUMN_PROPERTY.HOUR_MINUTE ? DATE_FORMAT.HOUR_MINUTE :
+                                                        property === COLUMN_PROPERTY.MINUTE_SECOND ? DATE_FORMAT.MINUTE_SECOND : undefined;
+}

package/dist/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/dates/helpers/getDateFormatRegularExpressionInArray.js

@@ -0,0 +1,43 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { DATE_REGULAR_EXPRESSION } from "../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
+ */
+export function getDateFormatRegularExpressionInArray(dateFormat = DATE_FORMAT.DAY) {
+    switch (dateFormat) {
+        case DATE_FORMAT.YEAR:
+            return [DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.MONTH:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.QUARTER:
+            return [DATE_REGULAR_EXPRESSION.YEAR_QUARTER, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.WEEK:
+            return [DATE_REGULAR_EXPRESSION.YEAR_WEEK, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.DAY:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION.YEAR];
+        case DATE_FORMAT.DAY_TIME:
+            return [DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT.HOUR:
+        case DATE_FORMAT.MINUTE:
+        case DATE_FORMAT.SECOND:
+            return [DATE_REGULAR_EXPRESSION.DAY, DATE_REGULAR_EXPRESSION.DAY_TIME];
+        case DATE_FORMAT.MONTH_DAY:
+            return [DATE_REGULAR_EXPRESSION.MONTH_DAY];
+        case DATE_FORMAT.YEAR_MONTH:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH];
+        case DATE_FORMAT.YEAR_QUARTER:
+            return [DATE_REGULAR_EXPRESSION.YEAR_QUARTER];
+        case DATE_FORMAT.YEAR_WEEK:
+            return [DATE_REGULAR_EXPRESSION.YEAR_WEEK];
+        case DATE_FORMAT.DAY_HOUR:
+            return [DATE_REGULAR_EXPRESSION.DAY_HOUR];
+        case DATE_FORMAT.HOUR_MINUTE:
+            return [DATE_REGULAR_EXPRESSION.HOUR_MINUTE];
+        case DATE_FORMAT.MINUTE_SECOND:
+            return [DATE_REGULAR_EXPRESSION.MINUTE_SECOND];
+        default:
+            return [DATE_REGULAR_EXPRESSION.YEAR_MONTH_NUMBER, DATE_REGULAR_EXPRESSION.MONTH_DAY, DATE_REGULAR_EXPRESSION.YEAR];
+    }
+}

package/dist/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/dates/helpers/getSeparatorByDateFormat.js

@@ -0,0 +1,11 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+export function getSeparatorByDateFormat(format = DATE_FORMAT.DAY) {
+    return format === DATE_FORMAT.YEAR || format === DATE_FORMAT.DAY_TIME || format === DATE_FORMAT.MONTH_DAY || format === DATE_FORMAT.YEAR_MONTH || format === DATE_FORMAT.YEAR_QUARTER || format === DATE_FORMAT.YEAR_WEEK || format === DATE_FORMAT.DAY_HOUR || format === DATE_FORMAT.HOUR_MINUTE || format === DATE_FORMAT.MINUTE_SECOND ? '' :
+        format === DATE_FORMAT.MONTH || format === DATE_FORMAT.QUARTER || format === DATE_FORMAT.WEEK || format === DATE_FORMAT.HOUR || format === DATE_FORMAT.MINUTE || format === DATE_FORMAT.SECOND ? ' ' :
+            '/';
+}

package/dist/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/dates/helpers/getWeek.js

@@ -0,0 +1,21 @@
+/**
+ * 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 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()
+    };
+}

package/dist/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/dates/helpers/index.js

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

package/dist/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/dates/helpers/validateDate.js

@@ -0,0 +1,20 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { validateDateByDateFormat } from "./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
+ */
+export function validateDate(date, format = DATE_FORMAT.DAY) {
+    if (isEmpty(date))
+        return false;
+    if (isTokenLabel(date))
+        return true;
+    return validateDateByDateFormat(date, format);
+}

package/dist/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/dates/helpers/validateDateByDateFormat.js

@@ -0,0 +1,22 @@
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getDateFormatRegularExpressionInArray } from "./getDateFormatRegularExpressionInArray";
+import { getSeparatorByDateFormat } from "./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
+ */
+export function validateDateByDateFormat(date, dateFormat = DATE_FORMAT.DAY) {
+    const resultValidation = [];
+    const separator = getSeparatorByDateFormat(dateFormat);
+    const separatedDate = date.split(separator);
+    const regularExpression = getDateFormatRegularExpressionInArray(dateFormat);
+    if (regularExpression.length !== separatedDate.length)
+        return false;
+    for (let i = 0; i < separatedDate.length; i++) {
+        resultValidation.push(isTokenLabel(separatedDate[i]) || new RegExp(regularExpression[i], 'g').test(separatedDate[i]));
+    }
+    return resultValidation.every(validValue => validValue);
+}

package/dist/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/dates/index.js

@@ -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/dates/relative/constants/RELATIVE_CURSOR_INFO.d.ts

@@ -1,14 +1,5 @@
+import { IRelativeCursorInfo } from "../interfaces/IRelativeCursorInfo";
+import { RelativeCursor } from "../interfaces/RelativeCursor";
 export declare const RELATIVE_CURSOR_INFO: {
-    this: {
-        label: string;
-        value: string;
-    };
-    the_next: {
-        label: string;
-        value: string;
-    };
-    the_last: {
-        label: string;
-        value: string;
-    };
+    [key in RelativeCursor]: IRelativeCursorInfo;
 };

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO.js

@@ -1,6 +1,7 @@
 import { RELATIVE_CURSOR } from "./RELATIVE_CURSOR";
+import { RELATIVE_CURSOR_LABEL } from "./RELATIVE_CURSOR_LABEL";
 export const RELATIVE_CURSOR_INFO = {
-    [RELATIVE_CURSOR.THIS]: { label: 'This', value: 'this' },
-    [RELATIVE_CURSOR.NEXT]: { label: 'The next', value: 'the next' },
-    [RELATIVE_CURSOR.LAST]: { label: 'The last', value: 'the last' },
+    [RELATIVE_CURSOR.THIS]: { abbrLabel: 'This', shortLabel: 'This', label: RELATIVE_CURSOR_LABEL.THIS, value: RELATIVE_CURSOR.THIS, displayed: true, i18nLabelPath: 'filter.relative_container.cursors.this_label' },
+    [RELATIVE_CURSOR.NEXT]: { abbrLabel: 'Next', shortLabel: 'Next', label: RELATIVE_CURSOR_LABEL.NEXT, value: RELATIVE_CURSOR.NEXT, displayed: true, i18nLabelPath: 'filter.relative_container.cursors.the_next_label' },
+    [RELATIVE_CURSOR.LAST]: { abbrLabel: 'Last', shortLabel: 'Last', label: RELATIVE_CURSOR_LABEL.LAST, value: RELATIVE_CURSOR.LAST, displayed: true, i18nLabelPath: 'filter.relative_container.cursors.the_last_label' },
 };

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.d.ts

@@ -0,0 +1,5 @@
+import { IRelativeCursorInfo } from "..";
+/**
+ * @description Key/array of compound relative cursor info
+ */
+export declare const RELATIVE_CURSOR_INFO_LIST: IRelativeCursorInfo[];

package/dist/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.js

@@ -0,0 +1,10 @@
+import { RELATIVE_CURSOR_INFO } from "./RELATIVE_CURSOR_INFO";
+import { RELATIVE_CURSOR } from "./RELATIVE_CURSOR";
+/**
+ * @description Key/array of compound relative cursor info
+ */
+export const RELATIVE_CURSOR_INFO_LIST = [
+    RELATIVE_CURSOR_INFO[RELATIVE_CURSOR.THIS],
+    RELATIVE_CURSOR_INFO[RELATIVE_CURSOR.LAST],
+    RELATIVE_CURSOR_INFO[RELATIVE_CURSOR.NEXT],
+];

package/dist/dates/relative/constants/RELATIVE_CURSOR_LABEL.d.ts

@@ -0,0 +1,5 @@
+export declare enum RELATIVE_CURSOR_LABEL {
+    THIS = "This",
+    NEXT = "The next",
+    LAST = "The last"
+}

package/dist/dates/relative/constants/RELATIVE_CURSOR_LABEL.js

@@ -0,0 +1,6 @@
+export var RELATIVE_CURSOR_LABEL;
+(function (RELATIVE_CURSOR_LABEL) {
+    RELATIVE_CURSOR_LABEL["THIS"] = "This";
+    RELATIVE_CURSOR_LABEL["NEXT"] = "The next";
+    RELATIVE_CURSOR_LABEL["LAST"] = "The last";
+})(RELATIVE_CURSOR_LABEL || (RELATIVE_CURSOR_LABEL = {}));

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

@@ -1,5 +1,7 @@
 export * from './COMMON';
 export * from './DATE_FORMATS';
 export * from './RELATIVE_CURSOR';
+export * from './RELATIVE_CURSOR_INFO_LIST';
 export * from './RELATIVE_CURSOR_INFO';
+export * from './RELATIVE_CURSOR_LABEL';
 export * from './ui/index';

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

@@ -1,5 +1,7 @@
 export * from './COMMON';
 export * from './DATE_FORMATS';
 export * from './RELATIVE_CURSOR';
+export * from './RELATIVE_CURSOR_INFO_LIST';
 export * from './RELATIVE_CURSOR_INFO';
+export * from './RELATIVE_CURSOR_LABEL';
 export * from './ui/index';

package/dist/dates/relative/interfaces/IRelativeCursorInfo.d.ts

@@ -0,0 +1,5 @@
+import { IGeneralInfo } from "../../../interfaces/general/IGeneralInfo";
+import { RelativeCursor } from "./RelativeCursor";
+export interface IRelativeCursorInfo extends IGeneralInfo {
+    value: RelativeCursor;
+}

package/dist/dates/relative/interfaces/IRelativeCursorInfo.js

@@ -0,0 +1 @@
+export {};