@qrvey/utils 1.2.4-2 → 1.2.4-23

package/src/columns/interfaces/index.ts

@@ -1,7 +1,6 @@
+export * from './IBColumn';
 export * from './IColumn';
 
-export * from './IColumnAggregateType';
-export * from './IColumnCalculationType';
 export * from './IColumnInfo';
 export * from './IColumnOutputFormatSettings';
 
@@ -12,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',
+}

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

@@ -1,6 +1,8 @@
 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/src/dates/relative/interfaces/IRelativeCursorInfo.ts

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

package/src/dates/relative/interfaces/index.ts

@@ -1,6 +1,7 @@
 export * from './AbsoluteStatement';
 export * from './Anchor';
 export * from './RelativeCursor';
+export * from './IRelativeCursorInfo';
 export * from './RelativeInput';
 export * from './RelativeStatement';
 export * from './RelativeToAbsoluteStruct';