@qrvey/utils 1.2.4-13 → 1.2.4-17

package/src/columns/constants/COMPLEX_COLUMN_PROPERTY_INFO.ts

@@ -15,10 +15,10 @@ export const COMPLEX_COLUMN_PROPERTY_INFO: { [key in IComplexColumnType]: IColum
         { label: COMPLEX_COLUMN_PROPERTY_LABEL.LONGTEXT_ENTITIES, shortLabel: 'Entities', abbrLabel: 'ENT', value: COMPLEX_COLUMN_PROPERTY.LONGTEXT_ENTITIES, displayed: true },
     ],
     [COMPLEX_COLUMN.TEXTFIELD]: [
-        { label: COMPLEX_COLUMN_PROPERTY_LABEL.SHORTTEXT_WORDS, shortLabel: 'Words', abbrLabel: 'WRD', value: COMPLEX_COLUMN_PROPERTY.SHORTTEXT_WORDS, displayed: true },
-        { label: COMPLEX_COLUMN_PROPERTY_LABEL.SHORTTEXT_KEYPHRASES, shortLabel: 'Keyphrases', abbrLabel: 'KP', value: COMPLEX_COLUMN_PROPERTY.SHORTTEXT_KEYPHRASES, displayed: true },
-        { label: COMPLEX_COLUMN_PROPERTY_LABEL.SHORTTEXT_SENTIMENTS, shortLabel: 'Sentiments', abbrLabel: 'SEN', value: COMPLEX_COLUMN_PROPERTY.SHORTTEXT_SENTIMENTS, displayed: true },
-        { label: COMPLEX_COLUMN_PROPERTY_LABEL.SHORTTEXT_ENTITIES, shortLabel: 'Entities', abbrLabel: 'ENT', value: COMPLEX_COLUMN_PROPERTY.SHORTTEXT_ENTITIES, displayed: true },
+        { label: COMPLEX_COLUMN_PROPERTY_LABEL.TEXTFIELD_WORDS, shortLabel: 'Words', abbrLabel: 'WRD', value: COMPLEX_COLUMN_PROPERTY.TEXTFIELD_WORDS, displayed: true },
+        { label: COMPLEX_COLUMN_PROPERTY_LABEL.TEXTFIELD_KEYPHRASES, shortLabel: 'Keyphrases', abbrLabel: 'KP', value: COMPLEX_COLUMN_PROPERTY.TEXTFIELD_KEYPHRASES, displayed: true },
+        { label: COMPLEX_COLUMN_PROPERTY_LABEL.TEXTFIELD_SENTIMENTS, shortLabel: 'Sentiments', abbrLabel: 'SEN', value: COMPLEX_COLUMN_PROPERTY.TEXTFIELD_SENTIMENTS, displayed: true },
+        { label: COMPLEX_COLUMN_PROPERTY_LABEL.TEXTFIELD_ENTITIES, shortLabel: 'Entities', abbrLabel: 'ENT', value: COMPLEX_COLUMN_PROPERTY.TEXTFIELD_ENTITIES, displayed: true },
     ],
     [COMPLEX_COLUMN.FILEUPLOAD]: [
         { label: COMPLEX_COLUMN_PROPERTY_LABEL.FILEUPLOAD_FILESIZE, shortLabel: 'Size', abbrLabel: 'SZ', value: COMPLEX_COLUMN_PROPERTY.FILEUPLOAD_FILESIZE, displayed: true },

package/src/columns/constants/COMPLEX_COLUMN_PROPERTY_LABEL.ts

@@ -3,10 +3,10 @@ export enum COMPLEX_COLUMN_PROPERTY_LABEL {
     LONGTEXT_KEYPHRASES = 'Keyphrases',
     LONGTEXT_SENTIMENTS = 'Sentiments',
     LONGTEXT_ENTITIES = 'Entities',
-    SHORTTEXT_WORDS = 'Words',
-    SHORTTEXT_KEYPHRASES = 'Keyphrases',
-    SHORTTEXT_SENTIMENTS = 'Sentiments',
-    SHORTTEXT_ENTITIES = 'Entities',
+    TEXTFIELD_WORDS = 'Words',
+    TEXTFIELD_KEYPHRASES = 'Keyphrases',
+    TEXTFIELD_SENTIMENTS = 'Sentiments',
+    TEXTFIELD_ENTITIES = 'Entities',
     FILEUPLOAD_FILESIZE = 'File Size',
     FILEUPLOAD_FILETYPE = 'File Type',
     IMAGEUPLOAD_IMAGESIZE = 'Image Size',

package/src/columns/constants/NUMERICAL_COLUMN.ts

@@ -0,0 +1,8 @@
+export enum NUMERICAL_COLUMN {
+    SLIDEBAR = 'SLIDEBAR',
+    NUMERIC = 'NUMERIC',
+    NUMERICC = 'NUMERIC-C',
+    NUMERICP = 'NUMERIC-P',
+    NUMERICG = 'NUMERIC-G',
+    RATING = 'RATING',
+}

package/src/columns/constants/NUMERICAL_COLUMNS.ts

@@ -0,0 +1,13 @@
+import { NUMERICAL_COLUMN } from "./NUMERICAL_COLUMN";
+
+/**
+ * @description Collection of numerical columns
+ */
+ export const NUMERICAL_COLUMNS = [
+	NUMERICAL_COLUMN.SLIDEBAR,
+	NUMERICAL_COLUMN.NUMERIC,
+	NUMERICAL_COLUMN.NUMERICC,
+	NUMERICAL_COLUMN.NUMERICG,
+    NUMERICAL_COLUMN.NUMERICP,
+    NUMERICAL_COLUMN.RATING,
+];

package/src/columns/constants/NUMERICAL_COLUMN_INFO.ts

@@ -0,0 +1,16 @@
+import { IColumnInfo } from "../interfaces/IColumnInfo";
+import { INumericalColumnType } from "../interfaces/INumericalColumnType";
+import { NUMERICAL_COLUMN } from "./NUMERICAL_COLUMN";
+import { NUMERICAL_COLUMN_LABEL } from "./NUMERICAL_COLUMN_LABEL";
+
+/**
+ * @description Key/array of numerical column info
+ */
+ export const NUMERICAL_COLUMN_INFO: { [key in INumericalColumnType]: IColumnInfo } = {
+    [NUMERICAL_COLUMN.SLIDEBAR]: { label: NUMERICAL_COLUMN_LABEL.SLIDEBAR, shortLabel: 'Slidebar', abbrLabel: 'Sldb', value: NUMERICAL_COLUMN.SLIDEBAR, displayed: true },
+    [NUMERICAL_COLUMN.NUMERIC]: { label: NUMERICAL_COLUMN_LABEL.NUMERIC, shortLabel: 'Num', abbrLabel: 'Num', value: NUMERICAL_COLUMN.NUMERIC, displayed: true },
+    [NUMERICAL_COLUMN.NUMERICC]: { label: NUMERICAL_COLUMN_LABEL.NUMERICC, shortLabel: 'Num-C', abbrLabel: 'NumC', value: NUMERICAL_COLUMN.NUMERICC, displayed: true },
+    [NUMERICAL_COLUMN.NUMERICP]: { label: NUMERICAL_COLUMN_LABEL.NUMERICP, shortLabel: 'Num-P', abbrLabel: 'NumP', value: NUMERICAL_COLUMN.NUMERICP, displayed: true },
+    [NUMERICAL_COLUMN.NUMERICG]: { label: NUMERICAL_COLUMN_LABEL.NUMERICG, shortLabel: 'Num-G', abbrLabel: 'NumG', value: NUMERICAL_COLUMN.NUMERICG, displayed: true },
+    [NUMERICAL_COLUMN.RATING]: { label: NUMERICAL_COLUMN_LABEL.RATING, shortLabel: 'Rating', abbrLabel: 'RTN', value: NUMERICAL_COLUMN.RATING, displayed: true },
+};

package/src/columns/constants/NUMERICAL_COLUMN_INFO_LIST.ts

@@ -0,0 +1,15 @@
+import { IColumnInfo } from "../interfaces/IColumnInfo";
+import { NUMERICAL_COLUMN } from "./NUMERICAL_COLUMN";
+import { NUMERICAL_COLUMN_INFO } from "./NUMERICAL_COLUMN_INFO";
+
+/**
+ * @description Key/array of numerical column info
+ */
+ export const NUMERICAL_COLUMN_INFO_LIST: IColumnInfo[] = [
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.SLIDEBAR],
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.NUMERIC],
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.NUMERICC],
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.NUMERICG],
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.NUMERICP],
+    NUMERICAL_COLUMN_INFO[NUMERICAL_COLUMN.RATING],
+];

package/src/columns/constants/NUMERICAL_COLUMN_LABEL.ts

@@ -0,0 +1,8 @@
+export enum NUMERICAL_COLUMN_LABEL {
+    SLIDEBAR = 'Slidebar',
+    NUMERIC = 'Numeric',
+	NUMERICC = 'Numeric-C',
+	NUMERICP = 'Numeric-P',
+	NUMERICG = 'Numeric-G',
+    RATING = 'Rating',
+}

package/src/columns/constants/index.ts

@@ -25,3 +25,9 @@ export * from './COMPOUND_COLUMN_PROPERTY_LABEL';
 export * from './COMPOUND_COLUMN_PROPERTY';
 export * from './COMPOUND_COLUMN';
 export * from './COMPOUND_COLUMNS';
+
+export * from './NUMERICAL_COLUMN_INFO_LIST';
+export * from './NUMERICAL_COLUMN_INFO';
+export * from './NUMERICAL_COLUMN_LABEL';
+export * from './NUMERICAL_COLUMN';
+export * from './NUMERICAL_COLUMNS';

package/src/columns/helpers/index.ts

@@ -1,2 +1,3 @@
 export * from './isComplexColumn';
 export * from './isDateColumn';
+export * from './isNumericalColumn';

package/src/columns/helpers/isNumericalColumn.ts

@@ -0,0 +1,7 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isObject } from "../../general/object/isObject";
+import { NUMERICAL_COLUMNS } from "../constants/NUMERICAL_COLUMNS";
+import { IColumn } from "../interfaces/IColumn";
+import { INumericalColumnType } from "../interfaces/INumericalColumnType";
+
+export const isNumericalColumn = (column: IColumn): boolean => !isEmpty(column) && isObject(column) && (NUMERICAL_COLUMNS.includes(column.type as INumericalColumnType) || column.formulaType === 'number');

package/src/columns/interfaces/IColumnType.ts

@@ -1,6 +1,7 @@
 import { IComplexColumnType } from "./IComplexColumnType";
 import { ICompoundColumnType } from "./ICompoundColumnType";
 import { COLUMN } from "../constants/COLUMN";
+import { INumericalColumnType } from "./INumericalColumnType";
 
 // export type IColumnType = typeof COLUMN[keyof typeof COLUMN];
-export type IColumnType = COLUMN | ICompoundColumnType | IComplexColumnType;
+export type IColumnType = COLUMN | ICompoundColumnType | IComplexColumnType | INumericalColumnType;

package/src/columns/interfaces/INumericalColumnType.ts

@@ -0,0 +1,4 @@
+import { NUMERICAL_COLUMN } from "../constants/NUMERICAL_COLUMN";
+
+// export type INumericalColumnType = typeof NUMERICAL_COLUMN[keyof typeof NUMERICAL_COLUMN];
+export type INumericalColumnType = NUMERICAL_COLUMN;

package/src/columns/interfaces/index.ts

@@ -1,3 +1,4 @@
+export * from './IBColumn';
 export * from './IColumn';
 
 export * from './IColumnInfo';
@@ -10,9 +11,12 @@ export * from './IColumnSortingSettings';
 
 export * from './IColumnType';
 
+export * from './IComplexColumnPropertyType';
 export * from './IComplexColumnType';
 
 export * from './ICompoundColumnPropertyType';
 export * from './ICompoundColumnType';
 
 export * from './IDateColumnPropertyType';
+
+export * from './INumericalColumnType';

package/src/dates/adapters/mdyDateToDate.ts

@@ -0,0 +1,18 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { validateDate } from "../helpers/validateDate";
+
+/**
+ * Transforms String Date from a [mm/dd/yyyy] format to Date object.
+ * @param monthYearDate String of [mm/dd/yyyy] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+export function mdyDateToDate (date: string, time = false) {
+    if (isEmpty(date) || isTokenLabel(date)) return date;
+   
+    if (validateDate(date, DATE_FORMAT.DAY)) {
+      return time ? +new Date(date) : new Date(date);
+    }
+}

package/src/dates/adapters/monthYearToDate.ts

@@ -0,0 +1,21 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { DATE_YEAR_MONTHS } from "../constants/DATE_YEAR_MONTHS";
+import { validateDate } from "../helpers/validateDate";
+
+/**
+ * Transforms String Date from a [Month Year] format to Date object.
+ * @param monthYearDate String of [Month Year] date
+ * @param time Flag to parse the object date to milliseconds.
+ * @returns The date object or the date in milliseconds
+ */
+export function monthYearToDate(monthYearDate: string, time = false) {
+    if (isEmpty(monthYearDate) || isTokenLabel(monthYearDate)) return monthYearDate;
+
+    if (validateDate(monthYearDate, DATE_FORMAT.MONTH)) {
+      const [month, year] = monthYearDate.split(' ');
+      const start = new Date(+year, DATE_YEAR_MONTHS.indexOf(month), 1);
+      return time ? +start : start;
+    }
+}

package/src/dates/adapters/quarterYearToDate.ts

@@ -0,0 +1,21 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { DATE_YEAR_QUARTERS_RANGE } from "../constants/DATE_YEAR_QUARTERS_RANGE";
+import { validateDate } from "../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
+ */
+export function quarterYearToDate (quarterYearDate: string, time = false) {
+    if (isEmpty(quarterYearDate) || isTokenLabel(quarterYearDate)) return quarterYearDate;
+    
+    if (validateDate(quarterYearDate, DATE_FORMAT.QUARTER)) {
+      const [quarter, year] = quarterYearDate.split(' ');
+      const start = new Date(+year, DATE_YEAR_QUARTERS_RANGE[quarter].initial, 1);
+      return time ? +start : start;
+    }
+}

package/src/dates/adapters/weekYearToDate.ts

@@ -0,0 +1,28 @@
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { getWeek } from "../helpers/getWeek";
+import { validateDate } from "../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
+ */
+ export function weekYearToDate(weekYear: string, time = false) {
+    if (isEmpty(weekYear) || isTokenLabel(weekYear)) return weekYear;
+
+    if (validateDate(weekYear, 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 = 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;
+    }
+};

package/src/dates/adapters/yearToDate.ts

@@ -0,0 +1,20 @@
+
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { validateDate } from "../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
+ */
+export function yearToDate(yearDate: string, time = false) {
+    if (isEmpty(yearDate) || isTokenLabel(yearDate)) return yearDate;
+
+    if (validateDate(yearDate, DATE_FORMAT.YEAR)) {
+      const start = new Date(+yearDate, 0, 1);
+      return time ? +start : start;
+    }
+}

package/src/dates/constants/DATE_FORMAT.ts

@@ -1,21 +1,26 @@
-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/src/dates/constants/DATE_REGULAR_EXPRESSION.ts

@@ -1,7 +1,34 @@
+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/src/dates/constants/DATE_YEAR_QUARTERS_RANGE.ts

@@ -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/src/dates/constants/index.ts

@@ -38,3 +38,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/src/dates/helpers/getDateByDateFormat.ts

@@ -0,0 +1,34 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { IDateFormat } from "../interfaces/IDateFormat";
+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: string, format: IDateFormat, 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/src/dates/helpers/getDateFormatByProperty.ts

@@ -0,0 +1,26 @@
+import { COLUMN_PROPERTY } from "../../columns/constants/COLUMN_PROPERTY";
+import { IColumnPropertyType } from "../../columns/interfaces/IColumnPropertyType";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { IDateFormat } from "../interfaces/IDateFormat";
+
+/**
+ * Gets the date format by the given property
+ * @param property The Column Property
+ * @returns The date format
+ */
+export function getDateFormatByProperty(property: IColumnPropertyType): IDateFormat {
+    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/src/dates/helpers/getDateFormatRegularExpressionInArray.ts

@@ -0,0 +1,45 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { DATE_REGULAR_EXPRESSION } from "../constants/DATE_REGULAR_EXPRESSION";
+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 function getDateFormatRegularExpressionInArray(dateFormat: IDateFormat = DATE_FORMAT.DAY): string[] {
+    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/src/dates/helpers/getSeparatorByDateFormat.ts

@@ -0,0 +1,13 @@
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { IDateFormat } from "../interfaces/IDateFormat";
+
+/**
+ * Gets the separator of the date format
+ * @param format the date format
+ * @returns a separator string
+ */
+export function getSeparatorByDateFormat(format: IDateFormat = DATE_FORMAT.DAY): string {
+    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/src/dates/helpers/getWeek.ts

@@ -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: 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/src/dates/helpers/index.ts

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

package/src/dates/helpers/validateDate.ts

@@ -0,0 +1,22 @@
+
+import { isEmpty } from "../../general/mix/isEmpty";
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { IDateFormat } from "../interfaces/IDateFormat";
+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: string, format: IDateFormat = DATE_FORMAT.DAY): boolean {
+    if (isEmpty(date)) return false;
+    if (isTokenLabel(date)) return true;
+
+    return validateDateByDateFormat(date, format);
+}

package/src/dates/helpers/validateDateByDateFormat.ts

@@ -0,0 +1,25 @@
+import { isTokenLabel } from "../../tokens/isTokenLabel";
+import { DATE_FORMAT } from "../constants/DATE_FORMAT";
+import { IDateFormat } from "../interfaces/IDateFormat";
+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: string, dateFormat: IDateFormat = DATE_FORMAT.DAY): boolean {
+    const resultValidation: boolean[] = [];
+    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/src/dates/index.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/src/dates/relative/constants/RELATIVE_CURSOR_INFO.ts

@@ -1,7 +1,10 @@
+import { IRelativeCursorInfo } from "../interfaces/IRelativeCursorInfo";
+import { RelativeCursor } from "../interfaces/RelativeCursor";
 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' },
+export const RELATIVE_CURSOR_INFO: { [key in RelativeCursor]: IRelativeCursorInfo } = {
+    [RELATIVE_CURSOR.THIS]: { abbrLabel: 'This', shortLabel: 'This', label: RELATIVE_CURSOR_LABEL.THIS, value: RELATIVE_CURSOR.THIS, displayed: true },
+    [RELATIVE_CURSOR.NEXT]: { abbrLabel: 'Next', shortLabel: 'Next', label: RELATIVE_CURSOR_LABEL.NEXT, value: RELATIVE_CURSOR.NEXT, displayed: true },
+    [RELATIVE_CURSOR.LAST]: { abbrLabel: 'Last', shortLabel: 'Last', label: RELATIVE_CURSOR_LABEL.LAST, value: RELATIVE_CURSOR.LAST, displayed: true },
 };

package/src/dates/relative/constants/RELATIVE_CURSOR_INFO_LIST.ts

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

package/src/dates/relative/constants/RELATIVE_CURSOR_LABEL.ts

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